agent-mvp

agent-mvp — 双 agent × cc-code 驱动 MVP 执行编排器

纯执行器：需求与契约只读不产——一切规划产物（prd / ux / project / data / api）由 /cc-code:plan-mvp 商讨定稿。本命令读定稿文档直接开发，中途零确认，只在 FAIL 3 轮升级时交人。 校准铁律：每一个阶段完成后，必须先执行 /cc-code:cc-code 校准当前状态（重读 Agent.md/status.md，重锁角色与坐标），确认无误后再进入下一阶段。未校准禁止推进。校准是机器自检，静默进行，不以「请确认」的姿态打扰人。 串行铁律：严守 Dev → QA 顺序，由 .cc_code/active/Agent.md 锁定当前角色，禁止跨角色思考与跳序。

与规划命令的分工（两两配对，单一职责）

 plan-mvp（人参与）              agent-mvp（本命令，纯机器）
 商讨 → 逐点循环至通顺               读定稿文档
 落盘 prd/ux/project/data/api  ──►  Dev 编码 → QA 验收（≤3 轮回环）
 对话内确认，落盘即定稿               阶段全 PASS → agent-whole-qa 收口

前置检查（启动时一次性）

1. 确认项目根存在 .cc_code/（否则提示先 /cc-code:init）。
2. 定稿体检：active/prd.md 有 §1.5 验收断言主表，且 ux.md / project.md / data.md / api.md 齐备。缺任一 → ⛔ 拒跑，报「规划产物未定稿，请先走 /cc-code:plan-mvp」，绝不现场补需求。
3. 确认双 agent 可用：dev / qa。
4. 确认测试基建：读 project.md §六「测试基建契约」取测试根 / glob / 运行命令。缺失或未填实则把「补齐测试基建 + 回填 project.md §六」作为 Dev 阶段首个任务。 同理读 project.md §七「日志契约」：选库 / 配置值未填实，或门面与 requestId 入口未落地 → 把「搭日志基建 + 回填 §七」并入 Dev 首个任务。
5. 索引体检（静默）：codegraph status --json 读三字段 —— initialized:false → 报一行（⛔ 不自动重建）；pendingChanges 非 0 → 静默 codegraph sync；reindexRecommended:true → 报一行建议。CLI 未装则静默跳过，全流程照跑（精准回归降级为全量）。⛔ 健康时一个字都不提。
6. 执行 /cc-code:cc-code 完成会话开启协议，锁定当前阶段与角色。
7. 阶段来源：读 project.md 的阶段拆分章节。有 → 按阶段逐段推进；无 → 整体作单阶段跑完（⛔ 不自行拆阶段，拆分是规划的职责）。

生命周期总览

启动校准 → ①Dev → 校准 → ②QA → 校准
                              │
                    ┌─────────┴──────────┐
                    ▼                    ▼
              FAIL→回Dev(≤3)         PASS→阶段结算→校准
                    │                    ▼
            3轮仍FAIL→升级(交人)     还有阶段? →回①
                                         ▼
                                 全PASS → MVP收口

阶段执行规范

每阶段严格按「读 / 做 / 跑 / 输出 / 写」执行，完成即校准。

① Dev 段（agent: dev）

项	内容
读	status, prd, ux, project（含阶段拆分章节）, data, api
做	按规格实现 src + 三层测试；遵循 project.md 约定
跑	Agent(dev) → 内部 Read/Edit/Write；自检：pnpm lint → tsc --noEmit → pnpm test → pnpm test:e2e
输出	业务代码 + 测试（落 project.md §六 声明的测试根）+ 完成报告（文件清单 + pass/fail）
写	src/, project.md §六 声明的测试根
⭐ 完成后	算精准回归面：codegraph affected <本段改动的源文件...> → 得测试文件清单，传给 ②QA 段。非 .spec/.test 命名的测试补跑 --filter "<project.md §六 登记的 glob>"。合并去重后即「本段回归范围」
✅ 完成后	执行 /cc-code:cc-code 校准