cc-codelisted
Install: claude install-skill weiyi88/cc-code
# 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(阶段拆分并入 project.md 章节) | 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** —— 避免接口细节污染需