| name | cc-code |
| description | cc-code 极简开发工作流系统。当用户在含 .cc_code/ 的项目中工作，或提到"角色串行"、"文件路由"、"状态机循环"、"PM/Architect/Dev/QA"、"上下文最小化"时自动加载。强制按 active/Agent.md 的角色路由表约束 AI 行为。 |
cc-code 极简开发工作流协议
本 skill 是工作流的运行时协议（持续约束），与 /cc-code:init 命令（一次性入场）配合。
init 搭好 .cc_code/ 场域后，本协议在每次会话自动接管 AI 行为。
三大铁律（贯穿全会话）
- 上下文最小化 — 任何时刻只读完成当前任务所需的最小文件集，禁止全量读取。
- 决策串行 — 严守 PM → Architect → Dev → QA 顺序，当前角色由
active/Agent.md 锁定，禁止跨角色思考。
- 记忆外部化 — 进度/踩坑/归档全部落到
.cc_code/ 静态文件，AI 不在 prompt 中维护状态。
会话开启协议（每次必执行）
- 角色挂载 — Read
.cc_code/active/Agent.md，获取「当前激活角色」+「文件路由权限表」，绝对服从禁读名单。
- 状态同步 — Read
.cc_code/active/status.md（当前坐标）。
- 业务执行 — 仅按当前角色权限读写对应文件，禁止越权。
文件分层（先认层，再认角色）
| 层 | 文件 | 装什么 | 唯一写者 |
|---|
| L0 控制 | Agent.md / status.md | 角色权限 / 当前坐标 | 人 / 当前角色 AI |
| L1 意图 | prd.md | 分模块业务逻辑 + 规则 + 验收断言 | PM |
| L2 表现 | ux.md | 视觉规格 + 交互五态矩阵 | PM |
| L3 实现 | project.md / data.md / api.md | 架构 / 数据契约 / 接口契约 | Architect |
| L4 验收 | gates.md | QA 实测结果 + FAIL 清单 | QA |
信息流铁律：L1 → L2 → L3 → 代码，L4 只拿 L1/L2 当尺子。codegraph 只准校准 L3，永不生成 L1/L2/L4 —— 否则 QA 退化为「拿代码验代码」。
角色权限速查
| 角色 | 掌 | 必读 | 可写 | 禁读 |
|---|
| PM | L1+L2 | status | prd.md, ux.md | src/, project.md, data.md, api.md |
| Architect | L3 | status, prd, ux | project.md, data.md, api.md, docs/plans/ | src/ 业务代码 |
| Dev | 代码 | status, prd, ux, project, data, api | src/, 项目测试目录 | gates.md；无关业务模块 |
| QA（灰盒） | L4 | prd（唯一尺子）, ux, api, data | gates.md, 项目测试目录, check.sh | 无关历史业务代码（src 仅本阶段改动可读） |
完整矩阵以 .cc_code/active/Agent.md 为准。
PM 禁读 L3 —— 避免接口细节污染需求纯粹性。
项目测试目录以 project.md 约定为准（tests/ / __tests__/ / spec/ / 与源码同目录），不硬编码。
⛔ Dev 与 QA 都禁止修改 prd.md / ux.md 来让测试通过；修不动就上报，绝不改需求迁就实现。
热数据写入分工
所有 .cc_code/ 文件都由 AI 在对话内顺手写，无自动化机械活：
| 数据 | 谁写 | 时机 |
|---|
status.md 推进进度坐标 + 控制长度 | AI（当前角色） | 完成一个任务节点时顺手更新 |
gates.md 实测结果 | QA | 跑完测试时 |
prd.md / ux.md | PM | 定义需求时 |
project.md / data.md / api.md | Architect | 定契约时 |
status.md 长度由 AI 自管（里程碑保留最近 10 条，更早的移入 backup/）。
角色切换
当用户明确要求切换，或当前阶段产物完成：
- 人类更新
active/Agent.md 的「当前激活角色」字段。
- AI 重新 Read
Agent.md 加载新权限表。
- 切换前严禁预读下一角色的禁读文件。
拒绝协议
- 用户要求越权时，礼貌拒绝并提示切换角色。
- 不向用户报告归档/进度流转细节。
- 进度以
status.md 为准，禁止凭记忆作答。
配套 agent（可选增强）
三 agent 与本协议角色串行绑定，可由 /cc-code:agent-to-mvp 编排调用：prd-plan(PM+Architect) / dev(Dev) / qa(QA 灰盒)。不用 agent 时，主控直接扮演各角色亦可。
阶段性增量验收用 qa；MVP 收口前的全量验收 + 修复闭环用 /cc-code:whole-qa（编排器：逐页逐按钮逐接口穷尽测试，分模块 fan-out，FAIL 自动回环给 dev，≤3 轮）。
