plan-feature

Files (2)

• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

# /cc-code:plan-feature — 增量需求规划编排器（第一动作即 plan 模式）

> ⭐⭐⭐ **触发后第一动作 = call `EnterPlanMode` 工具。**
> ⚙️ 引擎分支（双端同一条规则）：无 `EnterPlanMode` 工具的引擎（如 Codex）→ 第一动作改跑 Bash `mkdir -p .cc_code/.runtime && touch .cc_code/.runtime/plan-lock` 开护栏（此后写盘被 gate.sh 拦）。**一次批准窗口只解锁一次**：每个「主人批准」之后 `rm .cc_code/.runtime/plan-lock`，把这一批该落的全部落完（批准一：先 pm 落 prd、再 uiux 落 ux / design 构图；批准二：冲突修订先落 prd / ux，再落 L3），落完立刻 `touch` 回锁；进入技术阶段前保持锁定。**规划结束（批准二落完）⛔ 不再回锁**：锁要放开给接下来的执行命令写盘。
> **适用场景：MVP 已交付，在既有实现上做功能迭代。** 0→1 定全量请用 `/cc-code:plan-mvp`。
> **本命令的主控只是传话员**：问需求、判冲突的是 `pm` agent；问页面、布局与已锁视觉规格的是 `uiux` agent；读代码、算爆炸半径、问技术的是 `architect` agent。主控不读代码、不读技术文档、不跑 codegraph、不思考需求、不替主人回答。
> **主人批准两次**：需求与原型一次、技术方案一次。批准即定稿，落盘后无二次验收。

## ⛔ 六条铁律（违反任一即本次规划无效）

### 铁律 1：第一动作 call EnterPlanMode
触发后，在 call `EnterPlanMode` 之前，**不许做任何动作**：

- ❌ 不许先 Read 任何文件
- ❌ 不许先派 agent
- ❌ 不许先输出任何内容
- ✅ 唯一允许的第一动作：call `EnterPlanMode` 工具

### 铁律 2：主控只传话，不扮演任何角色
主控能做 / 不能做的清单单一出处 = `active/Agent.md` §一、§五，本命令不复述。本命令只加一条：体检（Step0.5）主控只看目录与规范形态，不读内容；codegraph 侦察归 architect。**两处例外**：体检可读 `active/Agent.md` 判断宪法版本（只为判版本形态，不是 `src/`、不是 L3）；风格门可读 `active/status.md`「风格：」行（该行缺失时才回退读 `active/design.md` §0 状态行；只读状态，不读数值与内容）。

### 铁律 3：codegraph 只准校准 L3，永不许生成 L1 / L2 / L4
本命令最易踩的坑 —— **迭代场景下代码已存在，会本能地「读代码推需求」，那是需求层被实现层反向污染**。谁能用 codegraph、产出能流向哪里，单一出处 = `active/Agent.md` codegraph 权限矩阵，本命令不复述。本命令的落点：codegraph 只由 architect 使用；新需求的逻辑只能从【pm 与主人的对话】长出来，页面与原型只能从【uiux 与主人的对话】长出来。

> 结构上的保证：pm 全程不接触代码；代码事实只能以「业务语言的冲突描述」经主控原样问主人，再由主人的话回到 pm，永远不会作为「需求建议」流向 pm。

### 铁律 4：契约漂移禁沉默
architect 撞出「代码 ≠ `active/api.md` / `active/data.md` 契约」时，**立即交回主控，逐条请主人二选一**：改代码回归契约 / 修契约并记录。禁止默默按代码算、也禁止默默按契约算。

### 铁律 5：禁批量决策清单，一次一个问题
⛔ 禁止「全量输出决策清单，可全量接受 / 逐项修订 / 否决某项」。
pm / uiux / architect 每轮只交回**一个**模糊点或**一条**冲突；主控不合并、不拆分、不追加。

### 铁律 6：禁塞单一文件，越权红线
⛔ 禁止把所有产出一股脑写进 `active/prd.md`。必须按内容性质路由到对应层的文件，**一层一文件一个 agent**（见「五、落盘路由表」）。

```
⛔ active/gates.md、active/bugs.md —— qa 唯一域，本命令绝不写
⛔ src/ 与测试目录                  —— dev 唯一域，本命令绝不写
⛔ active/Agent.md                  —— 插件规范文件（唯一写者 = init 脚本），本命令一个字不许动
⛔ active/design.md 已锁定后         —— 只能经 /cc-code:plan-uiux（模式二）改；本命令只在免门档补 §十 构图
✅ active/status.md                 —— 主控唯一落盘动作（坐标 / 卡点 / 下一步 / 「风格：」行）

每个 active 文件只有一个写者：pm → prd；uiux → ux / design；
architect → project / data / api；qa → gates / bugs；dev → src；
curator → references/（经验库）。任何阶段无例外：
主控绝不自己 Write / Edit 这些文件（含「顺手补一行」「体检后补救」「落到实际文件」），
要改一律派对应写者 agent。
```

> **视觉门两端同源**：本命令的批准条件 = 执行器的开工条件——按 `status.md`「风格：」行判（该行缺失时回退看 `design.md` §0）：「已定未实现」→ 先走 `agent-uiux`；「未锁」（无冷启动豁免）→ 本次涉及页面就停下先走 `plan-uiux`；「已锁」→ 放行；「纯后端」→ 放行并标视觉不适用。判据只在本命令 §三 与执行命令各写一次，⛔ 不各自另立。

---

## 一、生命周期总览

```
触发 /cc-code:plan-feature "<新需求>"
  │
Step0 ⭐ 进入规划模式（第一动作，写盘当场锁死）
  │ ═══════════ 需求与原型阶段（规划模式内，只读 + 文字）═══════════
Step0.5 规范体检门（主控只看形态，不读内容）
  │     目录形态偏离 → ⛔停手，要求主人自己先跑 /cc-code:init（主控不代跑）
  │     宪法为旧版   → ⚠️只提醒主人自己跑 /cc-code:init，不阻断；⛔ 主控不代跑 init、不改任何 active 文件
  │     有前端但风格未锁 → ⚠️ 记一条提醒（不阻断）：本次若涉及页面，开工前按 `status.md`「风格：」补门（未锁 → plan-uiux；已定未实现 → agent-uiux）
  │
Step1 派 pm（全新上下文）
  │     读：status、prd ＋ 主人原话（新需求原文）
  │     pm 自己锁基线：模块清单与状态、断言最大号、Out of Scope
  │
Step2 问答循环（主控只传话）
  │   ┌─────────────────────────────────────────────────┐
  │   │ pm 的问题 / 冲突 ──原样──► 主人                     │
  │   │   有明确选项 → 选项卡片；没有 → 直接文字              │
  │   │ 主人的话 ──原样──► 同一个 pm（续接，不新派）          │
  │   └─────────────────────────────────────────────────┘
  │   pm 在循环里完成：
  │     ① 需求逐点三态判定（文档层，禁悬空）
  │     ② 冲突逐条硬门控（冲突源 1~5，一次一条，四选一）
  │     ③ 逻辑图 + 差异表（需求侧）
  │     ④ 逐点提问至通顺
  │   pm 交回「需求已通顺 + 待落盘摘要」才出循环
  │
Step2.5 派 uiux（全新上下文；主控把 pm 的待落盘摘要原样转交）
  │     读：status、prd、ux、design.md ＋ 主控转交的 pm 摘要
  │     先判视觉门（与执行器开工条件同一判据，status 优先）：
  │       ├─ 本次涉及页面 + status「风格：」未锁（无冷启动豁免）→ ⛔ 停下交回「先走 plan-uiux」；
  │       ├─ 本次涉及页面 + status「风格：」已定未实现 → ⛔ 停下交回「先走 agent-uiux」；
  │       │                                     本命令不落这部分
  │       └─ 纯后端            → 交回「视觉不适用」，规划继续，摘要标「视觉：不适用（纯后端）」
  │     再判页面侧：冲突源 6 / 9 一次一条；新页版式按「两档」（见第四节）
  │     交回：下一个问题 / 冲突；或「原型与构图已通顺 + 待落盘摘要」
  │
Step3 ⭐ 退出规划模式，两份摘要原样交主人批准【批准一：需求与原型】
  │     不批 → 回 Step2 / Step2.5（需求问题回 pm、页面问题回 uiux）；批准 ↓
Step4 落盘（同一解锁窗口内按序）：pm 落 prd → uiux 落 ux
  │      免门档的新页：uiux 同步补 design.md §十 构图并登记进本次改动范围
  │     回报落盘清单 → 主控更新 status.md（点名 F-n + 新断言号，
  │     状态写「F-n 需求已落盘，技术待规划」——此时还不是「已规划未开发」）
  │ ═══════════ 技术阶段 ═══════════
Step5 ⭐ 重新进入规划模式
  │
Step6 派 architect（全新上下文）
  │     读：status、prd、ux、三处经验 INDEX（项目 / 个人 / 团队，不存在跳过）、代码索引与代码 ＋ 主人原话
  │     （⛔ 不读 design.md；家族与形态从 prd §〇 与 ux §一 取）
  │     architect 自己做代码侦察（见第三节），主控一个字不碰
  │
Step7 问答循环（对象换成 architect）
  │     契约漂移 / 契约冲突 / 技术问题，一次一条
  │     ├─ 需求写不通 → 走「冲突回流」（第二节）后继续
  │     architect 交回「技术方案已通顺 + 待落盘摘要」才出循环
  │
Step8 ⭐ 退出规划模式，摘要原样交主人批准【批准二：技术方案】
  │     不批 → 回 Step7；批准 ↓
Step9 落盘（同一解锁窗口内按序）：
  │     若有冲突回流产生的修订摘要 → 先续接 pm 落 prd、再续接 uiux 落 ux
  │     再续接 architect 落盘：project / data / api（含 §九 泳道）
  │
Step9.5 ⭐ 开工前断言体检（主人还在场，问题在这里问完；编排单一出处 = `active/Agent.md` §五「开工前断言体检」，

From weiyi88/cc-code, MIT.

More from weiyi88/cc-code