cc-code

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 行为。

三大铁律（贯穿全会话）

1. 上下文最小化 — 任何时刻只读完成当前任务所需的最小文件集，禁止全量读取。
2. 决策串行 — 严守 PM → Architect → Dev → QA 顺序，当前角色由 active/Agent.md 锁定，禁止跨角色思考。
3. 记忆外部化 — 进度/踩坑/归档全部落到 .cc_code/ 静态文件，AI 不在 prompt 中维护状态。

会话开启协议（每次必执行）

1. 角色挂载 — Read .cc_code/active/Agent.md，获取「当前激活角色」+「文件路由权限表」，绝对服从禁读名单。
2. 状态同步 — Read .cc_code/active/status.md（当前坐标）。
3. 业务执行 — 仅按当前角色权限读写对应文件，禁止越权。

文件分层（先认层，再认角色）

层	文件	装什么	唯一写者
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/）。

角色切换

当用户明确要求切换，或当前阶段产物完成：

1. 人类更新 active/Agent.md 的「当前激活角色」字段。
2. AI 重新 Read Agent.md 加载新权限表。
3. 切换前严禁预读下一角色的禁读文件。

拒绝协议

• 用户要求越权时，礼貌拒绝并提示切换角色。
• 不向用户报告归档/进度流转细节。
• 进度以 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 轮）。