video-prompt-skill
lostinheaven-knt/video-prompt-skill
A Claude Code skill for generating optimized prompts for 12 AI video models with 13 scenario templates
Instalação
npx convez-ai lostinheaven-knt/video-prompt-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
Claude Code 多Agent工作流配置
文件结构
.claude/
├── agents/
│ ├── plan-agent.md # 规划/评估专家(Opus)
│ ├── coder-agent.md # 实现专家(Sonnet)
│ └── test-agent.md # 测试专家(Sonnet)
└── commands/
└── orchestrate.md # 调度器 slash command(Opus)
部署
把 .claude/ 整个目录放到你项目根目录(项目级),或者放到 ~/.claude/(全局)。
放好后重启 Claude Code 会话让 subagent 被加载(用 /agents 命令创建的会立即生效,手动放文件需要重启)。
用法
启动新项目流程
/orchestrate new "做一个 XX 系统,大概实现 YY 功能"
启动老项目改造
/orchestrate legacy "项目在 ./my-service,需求是把单体改成支持多租户"
从断点继续
/orchestrate continue
(任何时候关掉重开,输入这个就能从 docs/orchestrator-state.md 恢复)
三个 Agent 的分工
| Agent | 写代码 | 写文档 | 评估 | 测试 | 模型 |
|---|---|---|---|---|---|
| plan-agent | ❌ | ✅ | ✅ | ❌ | Opus |
| coder-agent | ✅ | 仅功能流程 | ❌ | ❌ | Sonnet |
| test-agent | 仅测试代码 | 仅测试报告 | ❌ | ✅ | Sonnet |
关键设计点
1. 文档作为"对账凭证"
- plan-agent 写 设计/修改文档(期望)
- coder-agent 写 功能流程文档(事实)
- 二者 diff 出 优化清单
- 循环到
STATUS: CONVERGED
这是为什么 coder-agent 的 prompt 明确禁止"复述设计文档"——否则永远收敛不了。
2. STATUS 信号
每个 subagent 末尾必须输出状态行:
STATUS: CONVERGED/NEEDS_ITERATION(plan)STATUS: READY_FOR_REVIEW(coder)STATUS: ALL_PASSED/HAS_FAILURES/BLOCKED(test)
orchestrator 读这个信号决定下一步,不用 LLM 解读自然语言判断是否继续。
3. 收敛保护
所有循环硬上限 5 轮。到上限就找你,避免烧 token 死循环。
4. 人工介入点(默认只有 3 个)
- 需求/设计/修改文档定稿确认
- 评估循环达上限
- 测试循环达上限或阻塞
其他都自动跑。你不喜欢可以编辑 orchestrate.md 里 "何时打断我" 那段。
调优建议
跑起来后大概率要改的地方:
- plan-agent 的需求文档模板:加你团队的标准字段(比如必须有"产品 owner")
- coder-agent 的拆周期粒度:默认 2-5 个 cycle 可能不符合你的规模,去 §1 改
- test-agent 的框架适配:当前是泛指 pytest/jest/go test,可以写死你的项目用什么
- orchestrator 的介入点:你可能想加"每个 cycle 开发前确认"或者减"评估循环达上限"自动决策
调试
/agents查看哪些 subagent 加载了- 单独调用某个 agent 测试:直接说 "Use the plan-agent to do XYZ"
- 查看进度:
cat docs/orchestrator-state.md - 想从某个节点重跑:删 state 文件里对应
[x]标记,再continue
与 LangGraph 的取舍
这套配置好处:
- 零代码,纯 Markdown
- 改 prompt 就能调流程
- 嵌在你的开发环境里,Agent 直接操作你的代码
不如 LangGraph 的地方:
- 流程是 prompt 描述的"软约束",Opus 大概率会守规矩,但不是强制的状态机
- 没有可视化的状态图
- 跨会话的状态依赖文件,没有数据库级可靠性
建议:先用这套跑 1-2 个真实项目,观察 orchestrator 在哪里会"自由发挥"得不合预期,再决定要不要升级到 LangGraph。