agent-feature

agent-feature — 双 agent × cc-code 驱动功能增量执行编排器

纯执行器：只执行增量需求，不规划。需求与契约由 /cc-code:plan-feature 商讨定稿落盘，本命令读定稿文档直接开发，中途零确认，只在 FAIL 3 轮升级时交人。 增量铁律：只做「规划了但还没验过」的断言，绝不重推存量需求、绝不重做已 PASS 项。 与 agent-mvp 的分工：mvp 是「盖整栋楼」（含 agent-whole-qa 全量清算收口）；feature 是「在楼里加一个房间」（affected 精准回归，无全量清算）。

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

1. 确认项目根存在 .cc_code/（否则提示先 /cc-code:init）。
2. 确认双 agent 可用：dev / qa。
3. 增量定位（⭐第一动作，见下节）——定位失败即拒跑，后续检查全免。
4. 确认测试基建：读 project.md §六「测试基建契约」。缺失则把「补齐测试基建」作为 Dev 段首个任务。 同理读 project.md §七「日志契约」：缺失或未填实（老项目常见）→ 把「搭日志基建 + 回填 §七」并入 Dev 段首个任务。
5. 索引体检（静默）：codegraph status --json —— pendingChanges 非 0 → 静默 codegraph sync（增量回归面建立在索引之上，旧索引 = 漏回归）；initialized:false → 报一行（⛔ 不自动重建）。CLI 未装则静默跳过（精准回归降级为全量）。⛔ 健康时一个字都不提。
6. 执行 /cc-code:cc-code 完成会话开启协议，锁定当前阶段与角色。

⭐ 增量定位（第一动作，纯查表，零推理）

 ① 读 status.md「下一步」
      └─ 期望形态：「F-n <需求名>，已规划未开发」+ 点名断言号（如 A28.1~A28.10 / U23）
           ├─ 没有 F-n / 写的是「未规划」/ 下一步是别的事
           │     → ⛔ 拒跑：「增量未规划，请先走 /cc-code:plan-feature」
           │       （本命令绝不现场推需求——需求唯一来源 = 定稿文档）
           └─ 拿到 F 号 + 新断言清单
 ② 读 prd.md §1.5 主表 / ux.md §2.3 矩阵 → 取这些断言号的具体内容
 ③ 读 gates.md 追溯矩阵 → 取已 PASS 断言集合
 ④ 对账：
      增量范围 = F-n 点名断言 − gates.md 已 PASS
           ├─ 差集为空 → 报「F-n 已全部 PASS，无事可做」，结束
           └─ 差集非空 → 即本次执行范围，进 Dev 段

断言编号永久稳定（A 序列不重排不复用），所以这个对账天然精确——已 PASS 的不会重做，没 PASS 的就是本次的活。

生命周期总览

启动 → 增量定位 → ①Dev → 校准 → ②QA → 校准
                                 │
                       ┌─────────┴──────────┐
                       ▼                    ▼
                 FAIL→回Dev(≤3)         PASS→结算→结束
                       │                  （⛔ 无全量清算）
               3轮仍FAIL→升级(交人)

阶段执行规范

① Dev 段（agent: dev）

项	内容
读	status, prd（仅 F-n 命中模块小节 + §1.5 命中断言）, ux（命中 U 项）, project（含实现指引章节）, data / api（仅命中契约小节）
做	只按增量范围实现：改写命中模块 + 新增/补齐测试；遵循 project.md 约定；⛔ 不重构无关代码
跑	Agent(dev) → 自检：pnpm lint → tsc --noEmit → pnpm test → pnpm test:e2e
输出	增量代码 + 测试 + 完成报告（文件清单 + pass/fail）
写	src/, project.md §六 声明的测试根
⭐ 完成后	算精准回归面：codegraph affected <本段改动的源文件...> → 测试文件清单传给 ②QA 段；非 .spec/.test 命名补跑 --filter "<project.md §六 登记的 glob>"，合并去重即「本段回归范围」
✅ 完成后	执行 /cc-code:cc-code 校准（静默）