Vatt 功能开发工作流
从一句模糊的需求到 PR 合入 main 的完整功能（feat）开发流水线，为 video-editor-next 仓库（Vatt：Electron + React + TypeScript + MLT 视频编辑器）定制。UI / 非 UI 两条路径在实现前收敛；本地验收↔问题排查、准入自检↔代码审查各构成一个回路。
适用场景
- 在 Claude Code 中开发本仓库的新功能（feat）或行为改动
- 需要 agent 严格遵守仓库硬规则（Command-First、架构边界、i18n、日志宪法、git 协作规范）的场景
- 不适用：纯文档改动、一次性脚本、紧急 hotfix（走各自的轻量流程）
步骤总览
| # | 节点 | 路径 | 绑定 skill |
|---|------|------|-----------|
| ① | 需求澄清 | 主路径 | grill-me、flow（可选） |
| ② | UI 改动判定 | 主路径 · 路由 | — |
| ③ | UI 设计与原型确认 | 仅 UI 路径 | frontend-design |
| ④ | 实现规划与分支准备 | 收敛点 | writing-plans（可选）、git-team-protocol |
| ⑤ | 功能实现（TDD） | 主路径 | test-driven-development |
| ⑥ | 清理进程 + 本地启动验收 | 主路径 | troubleshooting-facio-logs、verification-before-completion |
| ⑦ | 问题排查 | 条件触发 | systematic-debugging |
| ⑧ | 代码准入自检 | 主路径 | git-team-protocol |
| ⑨ | 代码审查 | 主路径 | requesting-code-review + code-reviewer agent |
| ⑩ | PR 创建与合入 | 主路径 · 终点 | commit-rebase-pr |
强制用户停点（agent 禁止擅自决定）
本工作流大量节点强依赖用户输入。以下停点未获得用户明确回复前，agent 必须停下等待，禁止以默认值、假设或「合理推断」继续：
- ① grill-me 的澄清问题必须由用户回答（禁止自问自答）；需求纪要与 AC 清单须用户逐条确认
- ② 是否算 UI 改动拿不准时必须问用户；路由结论经用户确认后才生效
- ③ 每条设计决策点必须用户逐条表态，设计取舍禁止代用户拍板
- ④ 「是否 bugfix」用户未回答前禁止建分支；实现计划须用户认可
- ⑤ 计划外改动、规范冲突、需求歧义 → 停下问用户，禁止自行扩大范围
- ⑥ 无法自行验证的 AC（视觉效果、交互手感）必须请用户手测，禁止代用户宣布通过
- ⑦ 修复方案涉及行为变更或超出原需求范围 → 先向用户说明并等确认
- ⑧ 向用户展示完整 diff 并等待确认，未确认禁止 commit / push（不得以「改动很小」跳过）
- ⑨ 不修复的 MEDIUM / LOW 问题须向用户报备；修复取舍请用户定
- ⑩ 创建 PR 前确认；合入（merge）由用户执行或经用户明确同意
变量表
| 变量 | 形式 | 默认值 | 说明 · 出现节点 |
|------|------|--------|----------------|
| {{需求描述...}} | 多行文本 | 示例：给时间线增加片段磁性吸附开关 | 本次要开发的功能需求原文 · ① |
| {{开发者代号}} | 单行文本 | lionel | 分支命名 feat/<you>/<topic> 中的个人段 · ④ |
| {{目标分支}} | 单行文本 | main | PR 目标分支与 rebase 基准 · ④ ⑧ ⑨ ⑩ |
使用注意
- workflow 文件里的
{{…}}在网站上不渲染表单，复制 prompt 后手动替换 - PromptHub 无图级条件分支与循环：② 的路由写在 ②③ 的 prompt 内；⑦→⑥、⑨→⑧ 两处回路以节点内「回归指令」表达，⑦ 在图上是叶子节点属有意为之
- 本工作流深度绑定 video-editor-next 仓库的规范文件（
docs/specs/*、docs/rules/*）与本地 skill 集；移植到其他项目时需替换对应引用
反模式（来自本仓库踩坑记录）
yarn dev前不退出 Facio.app —— 共用 userData 抢 single-instance 锁，窗口不弹且无报错- 验收只验刚修的那条 AC —— ⑦ 修复后必须回 ⑥ 重走完整清单
- 跳过 diff 确认直接 commit / push —— 仓库硬规则
- 未询问 bugfix 就建分支 ——
fix/*前缀关系到 release 分支自动同步 - 文案写死在组件里 —— 必须先走 i18n 双语
git add -A/ 整目录覆盖式提交 —— 团队协作红线