skills/codestable__codestable
1
0
Fork 0
mirror of https://github.com/codestable/CodeStable.git synced 2026-09-19 09:03:09 +08:00
Code Issues Packages Projects Releases Wiki Activity

refactor: 移除 cs-task skill 及其全部接入（保留 gate 工具链）

Browse Source 
- 删除 cs-task/ 目录（SKILL.md + reference.md）
- 移除 30 个 cs-*/SKILL.md 的「## Task 接入」段，相邻「## 执行 gate」段全部保留
- 移除 cs-goal 的 Task Integration 段
- 清理 README/cs/system-overview/shared-conventions 里的 cs-task 引用，
  以及 .codestable/tasks 目录约定与 onboard gitkeep/检查
- gate 工具链（worktree/commit gate、tools、hooks、branch-guard）原样保留
- 技能数 badge 36 → 35

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
dafang
2026-06-25 16:50:41 +08:00
parent 7c77fe9b92
commit 71a7111307
38 changed files with 9 additions and 653 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.en.md
+3 -4
View File
@@ -12,7 +12,7 @@ Tired of OpenSpec's flimsiness, Oh-My-OpenAgent's over-engineering, and Superpow
<p>
<img src="https://img.shields.io/badge/status-beta-F59E0B?style=flat-square" alt="Status"/>
<img src="https://img.shields.io/badge/cs--skills-36-6366F1?style=flat-square" alt="CodeStable Skills"/>
<img src="https://img.shields.io/badge/cs--skills-35-6366F1?style=flat-square" alt="CodeStable Skills"/>
<img src="https://img.shields.io/badge/license-MIT-10B981?style=flat-square" alt="License"/>
</p>
@@ -101,7 +101,6 @@ CodeStable models real coding work as a set of **entities** and **flows**.
| **Goal** | goals | Bounded start/end: write a start report, then let AI iterate autonomously on implementation/validation, with subagent functional acceptance before completion |
| **Feature** | feature | The actual engineering execution. Human and AI collaborate, jointly responsible for design / implementation / acceptance |
| **Issue** | issue | The bug list after release. AI and human solve it together |
| **Task** | tasks | Cross-flow task ledger (active / archived) — resumable on interruption, archivable on completion |
| **Compound** | compound | The compounding-engineering knowledge base — pitfalls, good practices, technical decisions |
### Flows
@@ -113,7 +112,7 @@ CodeStable models real coding work as a set of **entities** and **flows**.
| **Issue fixing** | `cs-issue-report` → `cs-issue-analyze` → `cs-issue-fix` → `cs-code-review` | Tell AI what's wrong → AI finds the root cause → AI fixes precisely → independent review before commit |
| **Refactoring** | `cs-refactor` (beta) → `cs-code-review` | Architectural rot doesn't happen overnight. AI assists, but **humans refactor**. Still iterating — feedback welcome |
`cs-code-review` is the cross-cutting quality gate at the tail of every execution flow, before commit — feature, fast path, issue fixing, and refactoring all route their pre-commit diff review through it. `cs-task` keeps the ledger for every flow that writes to disk. At a phase or milestone boundary, use `cs-docs-neat` to reconcile `.codestable/`, README/docs, `CLAUDE.md` / `AGENTS.md`, and agent memory so docs do not drift from code.
`cs-code-review` is the cross-cutting quality gate at the tail of every execution flow, before commit — feature, fast path, issue fixing, and refactoring all route their pre-commit diff review through it. At a phase or milestone boundary, use `cs-docs-neat` to reconcile `.codestable/`, README/docs, `CLAUDE.md` / `AGENTS.md`, and agent memory so docs do not drift from code.
> Strong branch protection: `cs-onboard` can optionally release the `codestable-ai-branch-guard` hook, which blocks AI from implementing directly on `main`/`master` and forces a worktree. See the "branch protection hook" section in `cs-onboard`.
@@ -135,7 +134,7 @@ See [WORKFLOW.en.md](./WORKFLOW.en.md) for the full diagram.
## Runtime structure
After `/cs-onboard`, a `.codestable/` directory appears at your project root as the aggregate root for requirements, architecture, roadmap, goals, features, issues, refactors, audits, tasks, compound, tools, hooks, and reference.
After `/cs-onboard`, a `.codestable/` directory appears at your project root as the aggregate root for requirements, architecture, roadmap, goals, features, issues, refactors, audits, compound, tools, hooks, and reference.
See [WORKFLOW.en.md](./WORKFLOW.en.md) for the full directory model and cross-skill reference constraints.
README.md
+3 -4
View File
@@ -12,7 +12,7 @@
<p>
<img src="https://img.shields.io/badge/status-beta-F59E0B?style=flat-square" alt="Status"/>
<img src="https://img.shields.io/badge/cs--skills-36-6366F1?style=flat-square" alt="CodeStable Skills"/>
<img src="https://img.shields.io/badge/cs--skills-35-6366F1?style=flat-square" alt="CodeStable Skills"/>
<img src="https://img.shields.io/badge/license-MIT-10B981?style=flat-square" alt="License"/>
</p>
@@ -102,7 +102,6 @@ CodeStable 顺着软件编码的真实流程来设计，把开发活动建模成
| **目标** | goals | 限定起点和终点，写起点报告后让 AI 自主迭代实现/验证，完成前用 subagent 做功能验收 |
| **特性** | feature | 实际落地的工程执行过程，人与 AI 共同协作，对 design / 实现 / 验收负责 |
| **问题** | issue | 开发完成后的 BUG 单子，AI 和人一同解决 |
| **任务** | tasks | 跨流程的任务账本（active / archived），中断可恢复、完成可归档 |
| **知识** | compound | 复利工程的知识库，沉淀踩过的坑、好做法、技术决策 |
### 流程
@@ -114,7 +113,7 @@ CodeStable 顺着软件编码的真实流程来设计，把开发活动建模成
| **问题修改** | `cs-issue-report` → `cs-issue-analyze` → `cs-issue-fix` → `cs-code-review` | 跟 AI 说哪里有问题 → 让 AI 分析根因 → 让 AI 定点修复 → 合并前独立评审 |
| **代码重构** | `cs-refactor` (beta) → `cs-code-review` | 软件架构腐化不是一蹴而就的。AI 辅助重构，但**终归是人在重构**——还在迭代中，欢迎赐教 |
`cs-code-review` 是各执行流末端、commit 前的横切质量门禁；`cs-task` 为所有落盘流程记账。阶段或里程碑收尾时，用 `cs-docs-neat` 整理 `.codestable/`、README/docs、`CLAUDE.md` / `AGENTS.md` 和 agent 记忆，避免文档与代码脱节。
`cs-code-review` 是各执行流末端、commit 前的横切质量门禁。阶段或里程碑收尾时，用 `cs-docs-neat` 整理 `.codestable/`、README/docs、`CLAUDE.md` / `AGENTS.md` 和 agent 记忆，避免文档与代码脱节。
> 强分支保护：`cs-onboard` 可选释放 `codestable-ai-branch-guard` hook，拦截 AI 在 `main`/`master` 上直接实现，强制走 worktree。详见 `cs-onboard` 的「分支保护 hook」。
@@ -137,7 +136,7 @@ CodeStable 的技能不是一条线性流水，而是**分层 + 事件驱动**
## 运行时结构
`/cs-onboard` 跑完后，会在你的项目根下生成 `.codestable/`，作为 requirements、architecture、roadmap、goals、features、issues、refactors、audits、tasks、compound、tools、hooks 和 reference 的聚合根。
`/cs-onboard` 跑完后，会在你的项目根下生成 `.codestable/`，作为 requirements、architecture、roadmap、goals、features、issues、refactors、audits、compound、tools、hooks 和 reference 的聚合根。
完整目录说明和跨 skill 引用约束见 [WORKFLOW.md](./WORKFLOW.md)。
cs-arch/SKILL.md
-8
View File
@@ -28,14 +28,6 @@ description: 维护 `.codestable/architecture/` 这份只记现状的系统地
---
## Task 接入
- 等级：`auto`。架构文档的 update / check / backfill 复用或创建当前流程的 Task List（`cs-task`）。
- 写 / 刷新 architecture 产物或落 check 报告前复用当前流程 Task List，无 Task 不动手；产物落盘先更新 Task List 再继续。
- arch 常由 feature / acceptance 流程驱动，非末端不标 `completed`；收口交对应主流程。
---
## 模式分流
启动先判断模式三选一（不让用户选菜单）：
cs-audit/SKILL.md
-8
View File
@@ -15,14 +15,6 @@ description: 系统审计——从代码中主动发现 bug 隐患、安全漏
---
## Task 接入
- 等级：`auto`。审计自身是一条独立流程，对应自己的 Task List。
- 产物（`index.md` / `finding-*.md`）首次落盘前复用或创建当前流程的 Task List（`cs-task`），无 Task 不动手；落盘先更新 Task List 再继续。
- 审计只发现不修复，非末端不标 `completed`；修复交 `cs-issue` / `cs-refactor` 各自流程收口。
---
## 文件放哪儿
```
cs-brainstorm/SKILL.md
-8
View File
@@ -17,14 +17,6 @@ brainstorm 是"讨论层"统一入口。
---
## Task 接入
- 等级：`auto`（有落盘才生效）。纯讨论是创意空间，不建 Task。
- 只有进入落盘分支（case 2 feature-brainstorm、case 4 创意记录等）、首次写产物前，才复用或创建当前流程的 Task List（`cs-task`）；落盘先更新 Task List 再继续。
- brainstorm 非末端，不标 `completed`；移交 design / roadmap 后由下游流程收口。
---
## 分诊
### 四种 case 速览
cs-code-review/SKILL.md
-6
View File
@@ -28,12 +28,6 @@ description: 横切代码审查 gate——任何流程（feature / issue / refac
**不是 `cs-audit`**：audit 主动扫一片代码找潜在问题；code review 只审当前变更范围。
## Task 接入
- 等级：`auto`。落盘 `{slug}-review.md` 前必须复用 / 创建当前流程的 Task List（`cs-task`），无 Task 不动手。
- 审查报告落盘、verdict 定稿后，先更新 Task List 步骤状态与文档索引再继续。
- 不替上游收口：feature 来源 passed → `cs-feat-qa`（feature Task 由 `cs-feat-accept` 收口）；issue / refactor / ff 来源 passed → 交回对应流程做收尾提交并由其收口；changes-requested → 回对应实现技能修复。
---
## 输入
cs-decide/SKILL.md
-8
View File
@@ -21,14 +21,6 @@ description: 把已拍板的技术选型、架构决定、长期约束、编码
---
## Task 接入
- 等级：`auto`（轻）。决策沉淀挂在引发它的当前流程上，不是独立实现流程。
- 写沉淀文件前复用当前流程的 Task List（`cs-task`）；无关联流程的独立沉淀才建独立 Task。
- 不收口主流程：沉淀写完只更新对应 Task 状态与文档索引，不标主流程 `completed`。
---
## 四种决策类型
每条归属四类之一（frontmatter 的 `category` 字段标注）：
cs-docs-neat/SKILL.md
-8
View File
@@ -17,14 +17,6 @@ description: CodeStable 文档与知识库收尾整理技能。用于阶段结
---
## Task 接入
- 等级：`auto`。整理前复用当前流程的 Task List（`cs-task`）或按需建独立 doc Task。
- 整理文档/记忆时同步更新对应 Task 状态与文档索引。
- 非实现流程：不标主流程 `completed`，不加 worktree/commit gate 与 review 收尾。
---
## 四层知识，四种受众
必须先理解分工，否则会只改 `CLAUDE.md` / `AGENTS.md` 就结束，把 docs、`.codestable/` 和记忆晾在一边。
cs-explore/SKILL.md
-8
View File
@@ -13,14 +13,6 @@ description: 对仓库做定向代码探索并把"提问→读代码→得结论
---
## Task 接入
- 等级：`auto`（轻）。探索沉淀挂在引发它的当前流程上，不是独立实现流程。
- 写沉淀文件前复用当前流程的 Task List（`cs-task`）；无关联流程的独立沉淀才建独立 Task。
- 不收口主流程：沉淀写完只更新对应 Task 状态与文档索引，不标主流程 `completed`。
---
## 适用场景
- 新人入仓快速理解模块边界 / 调用链 / 入口
cs-feat-accept/SKILL.md
-4
View File
@@ -26,10 +26,6 @@ description: feature 流程阶段 3——验收闭环：对照 design 核实现
> 共享路径与命名约定看 `.codestable/reference/shared-conventions.md` 第 0 节。
## Task 接入
等级 `auto`：落盘 `{slug}-acceptance.md` / 回写架构 / req / roadmap 前必须复用 / 创建当前 feature 的 Task List（`cs-task`），无 Task 不动手；每完成验收节产物先更新步骤状态与文档索引再继续。收口：本 skill 是 feature 末端，验收通过、用户终审后标 `completed` 并转 `cs-task` archive。
---
## 跟 design 的章节强依赖
cs-feat-design-review/SKILL.md
-6
View File
@@ -15,12 +15,6 @@ description: feature design 人工确认前的方案审查 gate。对照 {slug}-
> 共享路径与命名约定看 `.codestable/reference/shared-conventions.md`。feature design 的具体结构以目标 `{slug}-design.md` / `{slug}-checklist.yaml` 和项目内共享口径为准。
## Task 接入
- 等级：`auto`。落盘 `{slug}-design-review.md` 前必须复用 / 创建当前 feature 的 Task List（`cs-task`），无 Task 不动手。
- 审查报告落盘、verdict 定稿后，先更新 Task List 步骤状态与文档索引再继续。
- 不标 `completed`：只把任务推进到下一阶段（passed → 用户整体 review；changes-requested / blocked → 回 `cs-feat-design`），feature Task 由末端 `cs-feat-accept` 收口。
---
## 输入
cs-feat-design/SKILL.md
-4
View File
@@ -23,10 +23,6 @@ description: feature 流程阶段 1——为新功能起草 {slug}-design.md 和
**推进原则**：design 要把后续执行需要的"操作手册"写到位：当前基线怎么确认、每步完成后看什么证据、哪些命令必须重跑、哪些交付物要真实落盘、失败时回到哪个契约修。否则 implement 只能临场判断，review 没有稳定契约可审，QA 不知道该跑什么证据，acceptance 也只能相信实现汇报。
## Task 接入
等级 `auto`：首次落盘 design / checklist 前必须复用 / 创建当前 feature 的 Task List（`cs-task`），无 Task 不动手；每产出阶段产物先更新步骤状态与文档索引再继续。不标 `completed`，approved 后只推进到 `cs-feat-impl`，feature Task 由末端 `cs-feat-accept` 收口。
---
## 初始化模式：帮用户建目录和 intent 草稿
cs-feat-ff/SKILL.md
-6
View File
@@ -13,12 +13,6 @@ description: feature 流程的超轻量通道——不写 design / checklist 直
很轻：没有 design doc / checklist / 验收清单 / 动手前的用户确认。看完指引，该读代码读、该写代码写、写完回写一段话。
## Task 接入
- 等级：`auto`。回写 `{slug}-ff-note.md` 前必须复用 / 创建当前 feature 的 Task List（`cs-task`），无 Task 不动手。
- ff-note 落盘、验证完成后，先更新 Task List 步骤状态与文档索引再继续。
- 不标 `completed`：fastforward 通道末端只把任务推进到收尾 commit；如需正式收口转 archive，由用户或后续 accept 流程定。
---
## 动手前先扫一眼 .codestable/
cs-feat-impl/SKILL.md
-6
View File
@@ -19,12 +19,6 @@ description: feature 流程阶段 2——按 {slug}-checklist.yaml 里 design
---
## Task 接入
- 等级：`auto`（重要变更）。开始实现前必须复用当前 feature 的 Task List（`cs-task`）；前序阶段还没创建就此处补建后再动代码。
- 每完成一个 checklist step、每次新增验证证据、或发现需要追加执行步骤时，先更新 Task List 的步骤状态、`owner_skill` 和 CodeStable 文档索引，再继续实现。
- 实现阶段结束不标记 `completed`；只把任务推进到 `cs-code-review`，由后续评审 / QA / 验收阶段收口整条 feature Task。
## 执行 gate（worktree + commit）
进入实现前运行 start gate，路径用项目运行时 `.codestable/tools/...`：
cs-feat-qa/SKILL.md
-6
View File
@@ -15,12 +15,6 @@ QA 的目标不是再做一遍 code review，也不是最终归档验收报告
> 共享路径与命名约定看 `.codestable/reference/shared-conventions.md` 第 0 节。
## Task 接入
- 等级：`auto`。落盘 `{slug}-qa.md` 前必须复用 / 创建当前 feature 的 Task List（`cs-task`），无 Task 不动手。
- QA 报告落盘、verdict 定稿后，先更新 Task List 步骤状态与文档索引再继续。
- 不标 `completed`：只把任务推进到下一阶段（passed → `cs-feat-accept`；failed / blocked → `cs-feat-impl` qa-fix），feature Task 由末端 `cs-feat-accept` 收口。
---
## 输入
cs-feat/SKILL.md
-6
View File
@@ -19,12 +19,6 @@ brainstorm 是讨论层独立入口，会分诊：case 1（清楚 → 直接 des
本技能不写代码不写文档，只做一件事：看当前 feature 走到哪步，告诉用户该触发哪个子技能。
## Task 接入
- 等级：`route-only`。本 skill 只路由不建 Task，由下游首次落盘的子技能 create/recovery。
- 路由判断时只读 Task List 看 feature 走到哪步，不写入、不改状态。
- 不收口：把任务交给被路由到的子技能推进，本 skill 不标记任何阶段状态。
---
## 文件放哪儿
cs-goal/SKILL.md
-13
View File
@@ -41,19 +41,6 @@ If `.codestable/` is missing, route to `cs-onboard`.
---
## Task Integration
- Level: `auto` for goal artifacts, `internal-runtime` for the in-goal loop.
- Before first writing goal artifacts (`goal.md`, `state.yaml`, iteration
reports), reuse or create the current flow's Task List (`cs-task`); no Task,
no write. This complements the start report and `state.yaml`, never overrides
them as the machine source of truth.
- Each completed iteration that lands artifacts updates the Task List before
moving on; a goal is not marked `completed` until terminal functional
acceptance passes.
---
## When To Use
Use `cs-goal` when the owner expresses a bounded destination:
cs-guide/SKILL.md
-8
View File
@@ -13,14 +13,6 @@ description: 写或更新对外指南文档——开发者指南（dev-guide）
---
## Task 接入
- 等级：`auto`。写文档前复用当前流程的 Task List（`cs-task`）或按需建独立 doc Task。
- 写/更新文档时同步更新对应 Task 状态与 CodeStable 文档索引。
- 非实现流程：不标主流程 `completed`，不加 worktree/commit gate 与 review 收尾。
---
## 两条轨道
| 轨道 | 目标读者 | 典型内容 | 输出路径 |
cs-issue-analyze/SKILL.md
-6
View File
@@ -15,12 +15,6 @@ description: issue 流程阶段 2——读 report + 读代码定位根因、评
> 共享路径与命名约定看 `.codestable/reference/shared-conventions.md` 第 0 节和 `cs-issue` 的"文件放哪儿"。
## Task 接入
- 等级：`auto`。会写 `.codestable/issues` 产物，落盘前对齐 Task List。
- 首次落盘前复用/创建当前 issue 的 Task List，无 Task 不动手；阶段产物落盘先更新 Task List 再继续。
- 非末端：不标 `completed`，只推进到下一阶段（`cs-issue-fix`）。
---
## 启动检查
cs-issue-fix/SKILL.md
-6
View File
@@ -15,12 +15,6 @@ fix 阶段最容易出问题的不是改代码本身，而是**改的过程中
> 共享路径与命名约定看 `.codestable/reference/shared-conventions.md` 第 0 节和 `cs-issue` 的"文件放哪儿"。
## Task 接入
- 等级：`auto`。会写 `.codestable/issues` 产物，落盘前对齐 Task List。
- 首次落盘前复用/创建当前 issue 的 Task List，无 Task 不动手；阶段产物落盘先更新 Task List 再继续。
- 收口：修复验证通过、code-review 通过后标 `completed` 并转 `cs-task` archive。
## 执行 gate（worktree + commit）
进入修复前运行 start gate，`{slug}` 为 issue 目录名：
cs-issue-report/SKILL.md
-6
View File
@@ -15,12 +15,6 @@ description: issue 流程阶段 1——通过对话把问题落成可复现、
> 共享路径与命名约定看 `.codestable/reference/shared-conventions.md` 第 0 节和 `cs-issue` 的"文件放哪儿"。
## Task 接入
- 等级：`auto`。会写 `.codestable/issues` 产物，落盘前对齐 Task List。
- 首次落盘前复用/创建当前 issue 的 Task List，无 Task 不动手；阶段产物落盘先更新 Task List 再继续。
- 非末端：不标 `completed`，只推进到下一阶段（`cs-issue-analyze` 或快速通道 `cs-issue-fix`）。
---
## 启动检查
cs-issue/SKILL.md
-6
View File
@@ -24,12 +24,6 @@ issue 工作流在"看到问题"和"动手改代码"之间塞缓冲：
本技能不写任何东西，只看当前 issue 走到哪步、决定触发哪个子技能。
## Task 接入
- 等级：`route-only`。本 skill 只路由，与 Task List 无写入耦合。
- 本 skill 只路由不建 Task，由下游首次落盘的子技能 create/recovery。
- 不收口、不标状态——Task 生命周期由落盘子技能管理。
---
## 文件放哪儿
cs-learn/SKILL.md
-8
View File
@@ -20,14 +20,6 @@ description: 把踩过的坑或好做法沉淀成可检索的 learning 文档，
---
## Task 接入
- 等级：`auto`（轻）。学习沉淀挂在引发它的当前流程上，不是独立实现流程。
- 写沉淀文件前复用当前流程的 Task List（`cs-task`）；无关联流程的独立沉淀才建独立 Task。
- 不收口主流程：沉淀写完只更新对应 Task 状态与文档索引，不标主流程 `completed`。
---
## 什么时候触发
| 情境 | 说明 |
cs-libdoc/SKILL.md
-8
View File
@@ -15,14 +15,6 @@ guidedoc 写错可能是表达不清，libdoc 写错就是错——信息源是
---
## Task 接入
- 等级：`auto`。写条目前复用当前流程的 Task List（`cs-task`）或按需建独立 doc Task。
- 写/更新条目时同步更新对应 Task 状态与 CodeStable 文档索引。
- 非实现流程：不标主流程 `completed`，不加 worktree/commit gate 与 review 收尾。
---
## 和 guidedoc 的对比
| | guidedoc | libdoc |
cs-note/SKILL.md
-8
View File
@@ -15,14 +15,6 @@ cs-learn / cs-trick / cs-decide 产出独立 markdown 文件，**通过检索**
---
## Task 接入
- 等级：`auto`（轻）。attention 沉淀挂在引发它的当前流程上，不是独立实现流程。
- 写 `attention.md` 前复用当前流程的 Task List（`cs-task`）；无关联流程的独立沉淀才按需建独立 Task。
- 不收口主流程：写完只更新对应 Task 状态与文档索引，不标主流程 `completed`。
---
## 什么进 cs-note，什么不进
**判据：长度 + 频次 + 稳定度**——三条都过才走 cs-note。
cs-onboard/SKILL.md
+2 -11
View File
@@ -36,7 +36,6 @@ description: 把新仓库或有零散文档的仓库接入 CodeStable 体系，
├── issues/ issue 聚合根
├── refactors/ 重构聚合根（beta）
├── audits/ 审计聚合根
├── tasks/ 任务账本（active/ + archived/）
├── compound/ 沉淀类统一目录（learning / trick / decision / explore）
├── tools/ 跨工作流共享脚本（onboard 整目录释放）
│ ├── search-yaml.py / validate-yaml.py
@@ -52,14 +51,6 @@ description: 把新仓库或有零散文档的仓库接入 CodeStable 体系，
> `tools/` 与 `reference/` 由 onboard 整目录复制，自动带上全部 gate 工具与共享口径，无需逐个列举维护。`hooks/` 是可选的分支保护层，详见下文「分支保护 hook」。
---
## Task 接入
- 等级：`bootstrap`。onboard 只搭骨架/归旧档，**自身不创建 Task List**——`tasks/` 目录建好即止，第一条 Task 由后续落盘的子技能（cs-feat-design / cs-issue-report 等）首次写产物时创建。
- 迁移路径中若改动已有文件，照常在汇报里逐条列出让 owner 拍板，不依赖 Task List 追踪。
---
## 启动检查
@@ -90,7 +81,7 @@ description: 把新仓库或有零散文档的仓库接入 CodeStable 体系，
按下面顺序执行，**不等用户逐步确认**——骨架是整体一次性的：
- `.codestable/{requirements,roadmap,goals,features,issues,refactors,audits,tasks/active,tasks/archived,compound}/.gitkeep`
- `.codestable/{requirements,roadmap,goals,features,issues,refactors,audits,compound}/.gitkeep`
- `.codestable/attention.md`（最小骨架模板见同目录 `reference.md`）
- `.codestable/architecture/ARCHITECTURE.md`（占位模板见同目录 `reference.md`）
- `.codestable/tools/`（用 `cp -rf` / `Copy-Item -Recurse -Force` 整目录拷贝技能包 `cs-onboard/tools/`，**不要 Read 再 Write**）
@@ -193,7 +184,7 @@ Copy-Item -Recurse -Force <技能包路径>\cs-onboard\hooks\* .codestable\
## 退出条件
- [ ] `.codestable/` 各聚合根目录（requirements/architecture/roadmap/goals/features/issues/refactors/audits/tasks/compound）都存在
- [ ] `.codestable/` 各聚合根目录（requirements/architecture/roadmap/goals/features/issues/refactors/audits/compound）都存在
- [ ] `.codestable/attention.md` 已建
- [ ] `.codestable/tools/`、`.codestable/reference/`、`.codestable/hooks/` 已从技能包复制
- [ ] `.codestable/architecture/ARCHITECTURE.md` 已建
cs-onboard/reference/shared-conventions.md
-3
View File
@@ -31,9 +31,6 @@ onboard 完成后骨架（`cs-onboard` 负责搭建）：
│ ├── {slug}-state.yaml 机器可读状态
│ ├── {slug}-iteration-*.md 迭代报告
│ └── {slug}-functional-acceptance.md 子 agent 功能验收
├── tasks/ 任务账本（active/ + archived/）
│ ├── active/ 当前进行中的任务（cs-task 管理）
│ └── archived/ 已完成归档的任务（cs-task 管理）
├── features/ feature spec 聚合根
│ └── YYYY-MM-DD-{slug}/ 每个 feature 一个目录
│ ├── {slug}-brainstorm.md （可选，case 2 时产出）
cs-onboard/reference/system-overview.md
-2
View File
@@ -47,7 +47,6 @@ CodeStable 把这几类场景各配一套子技能，产物放进统一的目录
- `cs-guide` — 写给外部读者的开发者指南 / 用户指南
- `cs-libdoc` — 为库的公开 API 逐条目生成参考文档
- `cs-docs-neat` — 阶段 / 里程碑收尾时，全局整理 `.codestable/`、README/docs、`CLAUDE.md` / `AGENTS.md` 和 agent 记忆，做反膨胀、补漏和冲突修正
- `cs-task` — 跨流程任务账本（`.codestable/tasks/active|archived`），落盘流程的中断恢复与完成归档入口
- `codestable-maintainer` — 维护 CodeStable 自身技能库 / harness / verifier / installed copy（源仓分支验证 + main-only 同步）
@@ -63,7 +62,6 @@ CodeStable 把这几类场景各配一套子技能，产物放进统一的目录
| BUG / 异常 / 文档错误 | `cs-issue` |
| 代码优化 / 重构 / 重写(行为不变) | `cs-refactor` |
| 合并前代码评审 / "code review" / 准备 PR / merge | `cs-code-review` |
| 任务恢复 / "继续当前任务" / 任务列表 / 归档任务 | `cs-task` |
| 摸代码、提问调研 | `cs-explore` |
| 补 / 更新需求文档 | `cs-req` |
| 补 / 更新 / 检查架构文档 | `cs-arch` |
cs-refactor-ff/SKILL.md
-6
View File
@@ -13,12 +13,6 @@ description: refactor 流程的超轻量通道——直接识别 1-3 条低风
很轻：没有 scan 清单、没有 design doc、没有 checklist，改完一句话汇报就行。
## Task 接入
- 等级：`auto`。落 `.codestable/refactors` 产物时对齐 Task List（不留存档则免）。
- 首次落盘前复用/创建当前 refactor 的 Task List，无 Task 不动手；阶段产物落盘先更新 Task List 再继续。
- 收口：重构验证通过、code-review 通过后标 `completed` 并转 `cs-task` archive。
## 执行 gate（worktree + commit）
改前运行 start gate，`{slug}` 为 refactor 目录名：
cs-refactor/SKILL.md
-6
View File
@@ -17,12 +17,6 @@ scan（扫优化点清单）→ design（和用户定做哪几条 + 顺序）→
**核心纪律**：行为等价是底线。一旦会改外部可观察行为 → 不走 refactor，走 feature（需求变）或 issue（bug 修）。
## Task 接入
- 等级：`auto`。会写 `.codestable/refactors` 产物，落盘前对齐 Task List。
- 首次落盘前复用/创建当前 refactor 的 Task List，无 Task 不动手；阶段产物落盘先更新 Task List 再继续。
- 收口：重构验证通过、code-review 通过后标 `completed` 并转 `cs-task` archive。
## 执行 gate（worktree + commit）
进入 apply 前运行 start gate，`{slug}` 为 refactor 目录名：
cs-req/SKILL.md
-8
View File
@@ -36,14 +36,6 @@ description: 维护 `.codestable/requirements/` 下的能力愿景文档。三
---
## Task 接入
- 等级：`auto`。req 文档落盘动作复用或创建当前流程的 Task List（`cs-task`）。
- 写 / 刷新 requirement 产物前复用当前流程 Task List，无 Task 不动手；产物落盘先更新 Task List 再继续。
- req 多由 design / acceptance 流程驱动，非末端不标 `completed`；收口交对应主流程。
---
## 适用场景
- brainstorm 阶段触发：磋商后愿景清晰 → `draft` 起草愿景落 `status: draft`，后续 design 和 roadmap 都有稳定对齐基准
cs-roadmap-impl-goal/SKILL.md
-6
View File
@@ -11,12 +11,6 @@ description: CodeStable 大需求端到端 goal 编排技能。用于用户给
---
## Task 接入
- 等级：`auto`。本技能编排整条大需求 goal，对应该 roadmap 流程的 Task List（`cs-task`）。
- 首次落盘（roadmap / design / goal 执行包等产物）前复用或创建当前流程 Task List，无 Task 不动手；产物落盘先更新 Task List 再继续；编排阶段非末端不标 `completed`。
- 子 feature 的实现由 `/goal` 会话逐个跑 `cs-feat-impl` 等实现技能，gate 与 code-review 由那些技能自身负责，本技能不照搬 gate 命令。
## 目标
把一个大需求变成可审阅、可恢复、可自动推进的 CodeStable roadmap 执行包：
cs-roadmap-review/SKILL.md
-8
View File
@@ -17,14 +17,6 @@ description: roadmap 人工确认前的规划审查 gate。对照 roadmap 主文
---
## Task 接入
- 等级：`auto`。本审查复用当前 roadmap 流程的 Task List（`cs-task`），不另起一条。
- `{slug}-roadmap-review.md` 落盘前复用当前流程 Task List，无 Task 不动手；产物落盘先更新 Task List 再继续。
- review 非末端，不标 `completed`；收口由 roadmap 推进与后续 feature 流程负责。
---
## 输入
进入 review 前必须读取：
cs-roadmap/SKILL.md
-8
View File
@@ -31,14 +31,6 @@ description: 把"大到塞不进单个 feature"的需求做成完整事前规划
---
## Task 接入
- 等级：`auto`。roadmap 是本大需求所有子 feature 的当前流程载体。
- 首次落盘（主文档 / items.yaml）前复用或创建当前流程的 Task List（`cs-task`），无 Task 不动手；产物落盘先更新 Task List 再继续。
- roadmap 非末端，不标 `completed`；推进交给后续 feature 流程收口。
---
## 适用场景
- 用户描述"一眼看出做不完"的大需求（"加权限系统"、"做通知中心"、"接 SSO"）
cs-task/SKILL.md
-187
View File
@@ -1,187 +0,0 @@
---
name: cs-task
description: CodeStable Task List 运行入口。触发：用户说"cs task"、"继续当前任务"、"任务列表"、"历史任务"、"归档任务"，或任一 CS workflow 需要创建、恢复、同步、完成、归档 Task List 时使用。管理 `.codestable/tasks/active` 与 `.codestable/tasks/archived`，不处理具体 feature/issue 实现。
---
# cs-task
`cs-task` 是 CodeStable 的任务运行账本入口。它不替代 feature checklist、roadmap items 或 issue report，而是提供跨 workflow 的“当前任务 / 中断恢复 / 历史归档”统一入口。
Task List 不是可选配件，而是所有会落盘 workflow 的强制主线：结束分析、准备首次修改项目内文档或代码时，必须先 create / recovery；`completed` 只是待归档态，archive 完成且 active 无残留才算真正闭环。
> 详细 schema、状态机和模板看同目录 `reference.md`。共享目录约定看 `.codestable/reference/shared-conventions.md`。
## Task 接入
- 等级：`internal-runtime`。本 skill 负责创建、恢复、更新、完成、归档 Task List 本身，绝不为自己的 task 文件变更递归创建新的 Task List。
- 其他会写项目内文档或代码的 CS skill 一旦准备首次落盘，必须自动调用本 skill 做 create / recovery；active / archived 清理、归档残留删除是本 skill 的默认职责，不是可选步骤。
- 只有当别的 workflow 调用本 skill 做 create / update / complete / archive / recovery 时，才更新现有 Task List；`cs-task` 自己不再套一层 Task。
---
## 启动必读
1. 先读 `.codestable/attention.md`；缺失时提示骨架不完整，但如果当前任务正是 Task System bootstrap，可继续读取 `.codestable/tasks/` 与 roadmap 上下文。
2. 读取 `.codestable/tasks/active/*.md`；如果目录不存在，说明还没有 task system 实例，提示先创建 task list 或走 `cs-onboard`。
3. 读取 `.codestable/tasks/archived/*.md`，先清理 active 中已归档任务的残留副本，再进入 recovery / archive。
4. `cs-task` 是 internal runtime：只更新 task 文件本身时，不再为这个更新递归创建新的 Task List。
---
## 核心定位
### Task List 是 source of truth
- Task List 文件记录任务目标、步骤、关联 CodeStable 文档索引、当前状态和归档记录。
- Agent Native Tasks / TodoWrite / Claude todo 等只是运行时镜像。
- 每完成一步，先更新 Task List 文件，再同步 Agent 运行时任务视图。
### Task List 不替代这些东西
- feature / refactor 的 `{slug}-checklist.yaml`
- roadmap 的 `{slug}-items.yaml`
- issue 的 report / analysis / fix-note
- acceptance report
Task List 只负责“任务恢复和跨 workflow 进度账本”。
---
## 模式分流
| 用户意图 | 模式 |
|---|---|
| `cs task` / 继续任务 / 当前任务 | recovery |
| 创建 Task List | create |
| 当前步骤完成 / 更新进度 | update |
| 所有步骤完成 | complete |
| 归档完成任务 / 查看历史任务 | archive / history |
判断不出时，用结构化用户问题让用户选，不要开放式追问。
---
## recovery：恢复当前任务
1. 扫描 `.codestable/tasks/active/*.md` 和 `.codestable/tasks/archived/*.md`。
2. 先执行归档残留清理：如果 active 中的 `{task}.md` 已有对应 archived 文件 `YYYY-MM-DD-{task}.md`，且 archived 文件 frontmatter 为 `status: archived`，自动删除 active 副本并记录本次清理；不要把它列为可恢复任务。
3. 解析剩余 active frontmatter：
- `active` / `blocked`：可恢复任务
- `completed`：待归档任务
- `cancelled`：可归档任务
- `archived`：位置错误，正常不应在 active 目录
4. 没有可恢复任务：
- 有 completed / cancelled：询问要归档哪个
- 没有：报告“当前没有 active task”
5. 只有一个可恢复任务：读取全文，提取第一个未完成步骤，同步 Agent Native Tasks。
6. 多个可恢复任务：使用当前 Agent 提供的结构化用户问答能力让用户选择。
选择格式：
```text
检测到多个进行中的 Tasks，请选择要继续的任务：
1. {task-a-goal}
2. {task-b-goal}
3. 自由输入补充信息
```
用户选择后，读取对应 task，构造 handoff 并自动进入 owner skill；只有 owner skill 缺失、目标不明确或存在风险操作时，才停在结构化问题。
---
## create：创建 Task List
创建条件：当前 CS skill 会修改项目内文档或代码，且当前 workflow 准备首次落盘。
动作：
1. 生成 task slug：小写英文连字符，表达任务主目标。
2. 写入 `.codestable/tasks/active/{task}.md`。
3. frontmatter 至少包含 `doc_type` / `task` / `goal` / `status` / `workflow` / `owner_skill` / `created` / `updated` / `archived` / `related_docs`。
4. 正文必须包含 7 个固定节，见 `reference.md`。
5. 同步 Agent Native Tasks。
如果 active 目录下已存在同名文件，先询问用户覆盖、复用还是改 slug；不得静默覆盖。
---
## update：更新步骤状态
每完成一个执行步骤：
1. 把 Task List 中对应 checklist 项改为完成。
2. 把“执行步骤”里的状态改为 `done`。
3. 更新 frontmatter `updated`。
4. 如果新增 CodeStable 文档，追加到“CodeStable 文档索引”。
5. 再同步 Agent Native Tasks。
如果实际执行拆出新步骤，只能追加到 Task List；不能改写历史已完成步骤。
---
## complete：完成任务
完成条件：
- Agent 同步区所有条目完成
- 执行步骤没有 `pending` / `in-progress`
- 关联 workflow 的必须产物已落盘
动作：
1. frontmatter `status: completed`。
2. “当前状态”改为 `completed`。
3. 完成与归档记录写入完成日期和验证结果。
4. 立即把下一步交给 archive；不允许把 `completed` 当成真正结束态长期留在 active。
---
## archive / history：归档与历史
归档对象：active 目录中 `status: completed` 或 `status: cancelled` 的 task。
归档动作：
1. 目标路径：`.codestable/tasks/archived/YYYY-MM-DD-{task}.md`。
2. 如果多个可归档 task，使用当前 Agent 提供的结构化用户问答能力选择。
3. 如果目标文件已存在，询问用户改名或取消；不得覆盖。
4. 移动文件到 archived。
5. frontmatter 改为 `status: archived`，`archived: YYYY-MM-DD`。
6. “当前状态”改为 `archived`，归档记录写明目标路径。
7. 归档完成后重新检查 `.codestable/tasks/active/{task}.md`；如果仍存在同名 active 残留，自动删除。归档的退出条件是 active 中不存在同名任务。
查看历史任务时只读 `.codestable/tasks/archived/*.md`，按文件名前缀日期倒序列出。
---
## 用户询问协议
所有选择都通过当前 Agent 提供的结构化用户问答能力完成。选项尽量编号，用户默认只按键盘。
Task 创建 / 恢复属于 L0 自动编排：进入会写文件的 workflow 后，只要准备首次落盘，就直接 create / recovery，不再询问是否接入 Task。
多选列表也保留一个“自由输入补充信息”。如果自由输入无法消除歧义，重新给编号选项。
---
## 退出条件
- recovery：已明确并自动进入下一步 owner skill，或因真实歧义停在结构化问题；task 路径和未完成步骤已同步。
- create：Task List 已创建并同步运行时任务视图。
- update：Task List 文件先于运行时任务视图更新。
- complete：Task List 状态已改为 `completed`，并准备立即进入 archive。
- archive：Task List 已移动到 archived 且 frontmatter 状态一致。
- cleanup：已归档任务在 active 中没有同名残留。
---
## 常见错误
- 把 Task List 当成 feature checklist 重写。
- 只更新 Agent Todo，不更新 Task List 文件。
- 多个 active task 时自己猜用户要继续哪个。
- 归档时复制文件，导致 active 和 archived 同时存在同一任务。
- 归档完成后没清理 active 中的同名残留。
- 归档目标存在时直接覆盖。
- 为 `cs-task` 自己的状态更新递归创建 Task List。
cs-task/reference.md
-227
View File
@@ -1,227 +0,0 @@
# cs-task 参考协议
本文件定义 Task List 的机器可读字段、人类可读正文和状态流转。`SKILL.md` 保留流程骨架；具体格式以本文件为准。
Task List 是所有会落盘 workflow 的强制运行主线：结束分析并准备首次修改项目内文档或代码时，必须先创建或复用 Task List；`completed` 只是待归档态，归档完成且 active 无残留才算真正闭环。
---
## 1. 目录结构
```text
.codestable/tasks/
├── active/
│ └── {task}.md
└── archived/
└── YYYY-MM-DD-{task}.md
```
规则：
- `active/` 存放 `active`、`blocked`、`completed`、`cancelled` 状态的任务。
- `archived/` 只存放 `archived` 状态的任务。
- active 文件不带日期前缀；archived 文件必须用归档日期前缀。
- 归档是移动文件，不复制文件。
- 如果 archived 中已经存在 `YYYY-MM-DD-{task}.md` 且状态为 `archived`，active 中同名 `{task}.md` 视为归档残留，`cs-task` 必须自动清理。
---
## 2. frontmatter schema
```yaml
---
doc_type: task-list
task: task-core-storage-runtime
goal: Implement the core CodeStable task storage and recovery runtime
status: active
workflow: feature
owner_skill: cs-feat-impl
created: YYYY-MM-DD
updated: YYYY-MM-DD
archived: null
related_docs:
- .codestable/features/YYYY-MM-DD-task/task-design.md
---
```
字段：
| 字段 | 规则 |
|---|---|
| `doc_type` | 固定 `task-list` |
| `task` | 小写英文连字符，必须和 active 文件名一致 |
| `goal` | 人类可读任务目标 |
| `status` | `active` / `blocked` / `completed` / `cancelled` / `archived` |
| `workflow` | `feature` / `issue` / `refactor` / `code-review` / `roadmap` / `req` / `arch` / `audit` / `compound` / `guide` / `libdoc` / `onboard` / `task` |
| `owner_skill` | 当前负责推进的 skill，如 `cs-feat-impl` |
| `created` | 创建日期 |
| `updated` | 最近更新日期 |
| `archived` | 未归档为 `null`，归档后为日期 |
| `related_docs` | 关联 CodeStable 文档路径列表 |
---
## 3. 正文模板
```markdown
# {Goal}
## 1. 任务目标
{一句话说明本任务要完成什么。}
## 2. 当前状态
active
## 3. Agent 原生 Tasks 同步区
- [ ] {task item}
## 4. CodeStable 文档索引
| 类型 | 路径 | 说明 |
|---|---|---|
| design | `.codestable/features/...` | 方案 |
## 5. 执行步骤
### 1. {Step title}
- 状态：pending
- 来源：{design / checklist / roadmap / issue / manual}
- 完成信号：{可观察退出信号}
## 6. 中断恢复提示
下次运行 `cs task` 时，从第一个 pending 步骤继续。
## 7. 完成与归档记录
尚未完成。
```
固定节不能删除；没有内容时写“无”。
---
## 4. 状态机
合法跃迁：
```text
active -> blocked
blocked -> active
active -> completed
active -> cancelled
completed -> archived
cancelled -> archived
```
不合法跃迁：
```text
archived -> active
completed -> active
cancelled -> active
blocked -> archived
active -> archived
```
语义：
- `active`：可以继续执行。
- `blocked`：等待用户或外部条件，正文必须写阻塞原因。
- `completed`：任务内容已完成，等待归档。
- `cancelled`：用户明确取消，等待归档。
- `archived`：历史记录，不能恢复执行。
---
## 5. 用户询问协议
所有需要用户选择的地方，优先使用当前 Agent 提供的结构化用户问答能力。不要用开放式长问题。
Task 创建 / 恢复属于 L0 自动编排：当前 workflow 一旦准备首次落盘，直接执行 `create` 或 `recovery`，不再询问是否接入 Task。只有多任务歧义、归档目标冲突或历史选择时，才进入结构化问题。
### 多任务选择
```text
检测到多个进行中的 Tasks，请选择要继续的任务：
1. {task-a-goal}
2. {task-b-goal}
3. 自由输入补充信息
```
### 多个完成任务归档
```text
检测到多个已完成但未归档的 Tasks，请选择要归档的任务：
1. {task-a-goal}
2. {task-b-goal}
3. 自由输入补充信息
```
选项数量尽量 2-5 个；自由输入不能消除歧义时，再给编号选项。
---
## 6. Agent Native Tasks 同步
同步输入从“Agent 原生 Tasks 同步区”提取：
```yaml
task_list_path: .codestable/tasks/active/task-core-storage-runtime.md
task_items:
- id: create-skill
content: 新增 cs-task skill
status: pending
active_step: create-skill
```
适配规则：
- Cursor：用 TodoWrite 同步。
- Claude Code：用原生 todo/task 工具同步。
- Codex / OpenCode：有原生任务工具就同步，否则降级为 Markdown checklist。
- 未知 Agent：跳过同步，但不能阻塞 Task List 文件更新。
同步失败时，在回复中说明降级方式。
---
## 7. 完成与归档规则
完成任务前必须满足：
- Agent 同步区所有条目已勾选。
- 执行步骤无 `pending` / `in-progress`。
- 关联 workflow 的必须文档已落盘。
`completed` 不是结束，只表示内容已完成、等待归档；真正闭环是 archive 完成且 active 中无同名残留。
归档步骤：
1. 确认 task `status` 是 `completed` 或 `cancelled`。
2. 计算目标路径：`.codestable/tasks/archived/YYYY-MM-DD-{task}.md`。
3. 如果目标存在，询问用户改名或取消。
4. 移动文件。
5. 更新 frontmatter：`status: archived`、`archived: YYYY-MM-DD`。
6. 更新正文“当前状态”和“完成与归档记录”。
7. 复查 active 目录，同名 `{task}.md` 如果仍存在则删除。
归档后 active 目录不应保留同名任务。
## 8. 归档残留清理
每次 recovery / archive / history 前先执行清理：
1. 扫描 `active/*.md` 和 `archived/*.md`。
2. 对每个 active `{task}.md`，查找 archived 中是否存在 `YYYY-MM-DD-{task}.md`。
3. 如果 archived 文件 frontmatter 是 `status: archived`，删除 active 副本。
4. 如果 archived 文件存在但状态不是 `archived`，停下报告状态不一致，不自动删除。
5. 清理后再计算 active / completed / cancelled 任务列表。
清理规则只删除已确认归档的同名 active 残留，不删除没有 archived 对应文件的 active task。
cs-trick/SKILL.md
-8
View File
@@ -17,14 +17,6 @@ cs-trick 是面向问题的**处方性参考库**，回答：**要做 X，经过
---
## Task 接入
- 等级：`auto`（轻）。技巧沉淀挂在引发它的当前流程上，不是独立实现流程。
- 写沉淀文件前复用当前流程的 Task List（`cs-task`）；无关联流程的独立沉淀才建独立 Task。
- 不收口主流程：沉淀写完只更新对应 Task 状态与文档索引，不标主流程 `completed`。
---
## 三种类型
frontmatter 的 `type` 字段：
cs/SKILL.md
+1 -4
View File
@@ -47,7 +47,6 @@ CodeStable 把开发活动建模成 **9 个实体 + 4 个流程**，所有产物
├── issues/ 修 bug spec 聚合根（report / analyze / fix）
├── refactors/ 重构 spec 聚合根（beta）
├── audits/ 审计实体（主动扫描发现清单，不定修）
├── tasks/ 任务账本（active / archived，跨流程恢复与归档）
└── compound/ 知识沉淀（learning / trick / decision / explore）
```
@@ -58,7 +57,7 @@ CodeStable 把开发活动建模成 **9 个实体 + 4 个流程**，所有产物
- **修 bug**：`cs-issue-report` → `cs-issue-analyze` → `cs-issue-fix`
- **重构**（beta）：`cs-refactor` / `cs-refactor-ff`
**横切**：任一流程落盘走 `cs-task` 记账；commit 前走 `cs-code-review` 独立评审；发现"值得记下来" → `cs-learn` / `cs-trick` / `cs-decide` / `cs-explore` 沉淀到 `compound/`。
**横切**：commit 前走 `cs-code-review` 独立评审；发现"值得记下来" → `cs-learn` / `cs-trick` / `cs-decide` / `cs-explore` 沉淀到 `compound/`。
**核心理念**：编排的是软件本身的生命周期（需求、架构、特性、bug、决策），不是 Agent。人在环——程序员对整体把控负责，AI 是高效执行体。
@@ -111,7 +110,6 @@ L2/L3 需 owner 审批/选择/授权/接受风险时，子流程先按 `.codesta
| roadmap 人工确认前的规划审查 / "review 这个 roadmap" | `cs-roadmap-review` |
| 推进已有 roadmap / 执行整个 roadmap / "继续 roadmap" / "用 goal 稳步推进 roadmap" | `cs-roadmap-impl-goal` |
| feature design 人工确认前的方案审查 / "review 这个 design" | `cs-feat-design-review` |
| 任务恢复 / "继续当前任务" / "任务列表" / "历史任务" / "归档任务" | `cs-task`（active / archived 账本；跨流程恢复） |
| 合并前审一下 / "code review" / "代码评审" / 准备 PR / merge | `cs-code-review`（对当前 diff 做独立评审，质量门禁） |
| CodeStable 自身技能 / harness / verifier / installed copy 更新 | `codestable-maintainer`（源码分支验证；真实 `~/.claude/skills` 只从 `origin/main` 同步） |
| 技术选型 / 长期约束 / 编码规约 | `cs-decide` |
@@ -144,7 +142,6 @@ L2/L3 需 owner 审批/选择/授权/接受风险时，子流程先按 `.codesta
| `cs-issue-fix` | L0/L3 | 修复暴露错误 spec、capability boundary 或公开行为变更 |
| `cs-refactor` / `cs-refactor-ff` | L1/L2 | 跨模块、有风险或行为边界不确定 |
| `cs-code-review` | L1/L3 | review 发现 Critical/Important 或触达长期 spec / 公开契约 |
| `cs-task` | L0 | 仅账本记录；任务恢复涉及方向选择时回对应流程 |
| `cs-req` | L3 | 总是：需求工作改变 future agent 的 source-of-truth |
| `cs-arch` | L1/L3 | 出现 code/doc/intent 冲突 |
| `cs-audit` | L1/L2 | owner 须裁定修 / 延 / 忽略 |