{"id":"60992a60-2c54-4e72-bdef-4e99dc69979d","slug":"video-production","kind":"skill","name":"video-production","summary":"通用 Agent Skill：45–90 秒竖屏短视频制作、字幕、包装、独立审核与版本保护。A host-agnostic video-production skill.","owner":"YI163","repoUrl":"https://github.com/YI163/video-production","license":"MIT","licenseTier":"permissive","trust":"community","stars":0,"match":null,"fewStars":true,"format":"skill","createdAt":"2026-10-27T00:50:53.000Z","addedAt":"2026-11-01T02:17:33.852Z","logoUrl":"https://avatars.githubusercontent.com/u/55666677?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["design-media"],"tags":["ffmpeg","subtitles","vertical-video","video-production","vlog"],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-11-01T02:38:35.886Z","sample":false,"url":"https://conduits.dev/tools/video-production","language":"Python","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# video-production\n\n一个**通用 Agent Skill**，用于制作 45–90 秒竖屏短视频：素材审计、分镜脚本、视觉包装、字幕、声音、独立审核、技术质检、交付，以及不破坏已批准版本的修改流程。\n\n本 Skill **不绑定 DeepSeek Harness**。它采用 Agent Skills 的通用约定：一个目录 + 根目录 `SKILL.md` + 可选 `references/`、`scripts/`、`assets/`。任何能读取 `SKILL.md` 并允许访问文件的宿主都可以使用；不同宿主的“技能目录在哪里、是否自动触发、是否能执行脚本”可能不同。\n\n这是一个**匿名化公开包**：不含成片、源素材、人物、机构名、会话日志、团队记录和本机路径。案例研究是方法复盘，不是逐镜模板。\n\n## 通用性说明\n\n| 部分 | 是否通用 | 说明 |\n|---|---|---|\n| `SKILL.md` 格式 | 是 | 仅使用 `name` + `description` frontmatter；无宿主专用字段 |\n| 工作流/清单/配方 | 是 | 纯 Markdown，任何能读文件的 Agent 都可用 |\n| `scripts/` | 是（有环境依赖） | Python/ffmpeg 脚本；宿主需允许执行 shell/Python，或由 Agent 手动调用 |\n| 触发方式 | 取决于宿主 | 支持自动 Skill 选择的宿主会按 description 触发；不支持的宿主需显式说“读 SKILL.md” |\n| 安装路径 | 否（宿主相关） | 见下方示例；这是唯一的宿主差异 |\n\n**结论：** 核心内容是通用的；宿主差异只保留在“安装”一节，DSH 只作为“一个已验证宿主”的示例。\n\n## 仓库内容\n\n```text\n.\n├── SKILL.md                    # 触发条件、工作流、失败模式、质量标准\n├── references/\n│   ├── case-study.md           # 匿名案例：什么做对了、什么退化了\n│   ├── reference-study.md      # 3–5 个优秀对标 vlog 的拆解模板\n│   ├── workflow.md             # 完整 7 阶段 Workflow\n│   ├── modification-protection.md\n│   ├── quality-checklist.md\n│   ├── tech-recipes.md\n│   └── skill-sources.md\n├── scripts/\n│   ├── check_video.py          # 技术检查器（无第三方依赖）\n│   └── contact_sheet.sh        # 1 秒接触表\n├── LICENSE                     # MIT（scripts/）\n├── LICENSE-DOCS                # CC BY 4.0（文档/方法论）\n└── README.md\n```\n\n## 安装（按宿主选择）\n\n核心原则只有一句：**把整个 `video-production/` 目录放到宿主读取 skills 的根目录下**，确保根目录有 `SKILL.md`。\n\n### Claude Code\n\n个人级：\n\n```bash\ngit clone https://github.com/YI163/video-production.git\nmkdir -p ~/.claude/skills/video-production\nrsync -a --exclude .git video-production/ ~/.claude/skills/video-production/\n```\n\n项目级：\n\n```bash\nmkdir -p <project>/.claude/skills/video-production\nrsync -a --exclude .git video-production/ <project>/.claude/skills/video-production/\n```\n\n### DeepSeek Harness（已验证的一个宿主）\n\n用户级：\n\n```bash\nmkdir -p ~/.agents/skills/video-production\nrsync -a --exclude .git video-production/ ~/.agents/skills/video-production/\n```\n\n项目级：\n\n```bash\nmkdir -p <project>/.dsh/skills/video-production\nrsync -a --exclude .git video-production/ <project>/.dsh/skills/video-production/\n```\n\nDSH 的 `skill-filesystem` 会监视技能根目录，正常情况下无需重启。若 Skill 不出现，先用真正的 YAML 解析器检查 frontmatter（见“验证”），不要只靠肉眼。\n\n### 其它宿主\n\n把目录放到该宿主文档规定的 skill/agent 目录；如果宿主不支持 `SKILL.md` 自动发现，直接把 `SKILL.md` 的路径交给 Agent，让它按文件执行。核心流程不依赖任何 DSH 工具。\n\n## 使用\n\n直接用自然语言提出任务即可，例如：\n\n- “剪一个 45–60 秒的竖屏 vlog，配中文字幕。”\n- “把这些素材剪成能发的短视频，先做脚本。”\n- “给视频加标题、事实卡、片尾卡。”\n- “把这段 Log 素材调色，并检查字幕和响度。”\n- “修改已批准的版本，但不要破坏原来的整体感。”\n\nSkill 会先判断任务类型：**新制作 / 局部修改 / 全量重做**。如果用户说“把所有素材都换掉”，那是新制作，不是局部修改。\n\n## 依赖\n\n- `ffmpeg`（示例按 ffmpeg 8 写，多数命令 ffmpeg 6+ 可用）。\n- Python 3（运行 `scripts/check_video.py`，无第三方包）。\n- Pillow（仅当使用包装/字幕生成配方时需要）。\n- Whisper（可选，用于逐字稿）。\n- 中文字体（如 Hiragino Sans GB、Noto Sans CJK、思源黑体）。\n\n## 设计原则\n\n0. **新制作/全量重做前，先研究 3–5 个优秀对标 vlog**，提炼钩子/节奏/包装/声音原则；不逐镜照搬。\n1. 动手剪辑前，先写“制作宪法”。\n2. 素材审计要有时间码和抽帧证据，不靠印象。\n3. 脚本必须能直接施工：逐镜源入出、成片时间码、字幕、包装、声音。\n4. 视觉系统由素材条件决定（卡片 / 满屏 / 混合）；未经要求不改已批准的系统。\n5. 素材、脚本、终审三个 gate 尽量独立。\n6. 技术指标要测；检查器通过是必要条件，不是充分条件。\n7. 交付要版本化、哈希化；绝不覆盖唯一的已批准版本。\n\n完整流程和检查清单在 `references/`，`SKILL.md` 只保留短正文，细节按需加载。\n\n## 验证\n\n- `SKILL.md` frontmatter 用真正的 YAML 解析器验证通过；`description` 已加引号，避免未转义的 `: ` 让整个 Skill 被静默丢弃。\n- `scripts/check_video.py` 在真实 1080×1920 / 30fps 成片上运行通过，返回 `decode_ok: true` 且无 failures。\n- `scripts/contact_sheet.sh` 能从同一成片生成 1 秒接触表。\n- 公开包不含成片或会话日志，因此不能只靠本仓库复刻原片；案例只保留方法。\n- **宿主测试范围：** 本包在 DeepSeek Harness 中实际加载过；Claude Code/其它宿主按 Agent Skills 格式兼容，但未逐一实测自动触发与脚本执行。若你的宿主行为不同，按“把 `SKILL.md` 交给 Agent”的降级方式使用。\n\n## 隐私与匿名\n\n- 不含源素材、成片、人脸、声音、学校/公司名、地点、日期、会话/团队日志、个人路径。\n- 案例研究只讲“发生了什么、为什么”，不指认“谁、在哪里”。\n- 如果你把它用于真实客户项目，发布素材或可识别人像前必须先取得授权。\n\n## License\n\n- **代码**（`scripts/`）：MIT，见 `LICENSE`。\n- **文档、方法论、`SKILL.md`**：CC BY 4.0，见 `LICENSE-DOCS`。\n\n文档署名建议：“video-production skill package”，并附上本仓库链接。\n"}