mirror of
https://github.com/codestable/CodeStable.git
synced 2026-09-19 09:03:09 +08:00
docs: refine CodeStable skill instructions
This commit is contained in:
dafang
+2
-2
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-audit
|
||||
description: 系统审计——从代码中主动发现 bug 隐患、安全漏洞、性能问题、可维护性债务和架构偏离，产出批量发现清单。触发：用户说"审查系统"、"审计代码"、"扫描问题"、"找找 bug"、"有什么可以优化的"。
|
||||
description: 系统审计。触发：审查系统、扫描 bug/安全/性能/架构债，产出发现清单。
|
||||
---
|
||||
|
||||
# cs-audit
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
`cs-issue` 等你报 bug，`cs-refactor` 等你指优化点，`cs-keep` 等你说"这事记一下"——但"我也不知道哪有问题，你先扫一遍看看"这个诉求没人接。`cs-audit` 补上这块：**在用户限定的范围内主动扫描，产出一份按严重度 × 性质交叉分类的发现清单**。
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: cs-brainstorm
|
||||
description: 想法还模糊时的讨论入口，做分诊后路由到 feature-design / feature-brainstorm / roadmap。AI 是思考伙伴不是记录员。触发：用户说"有个想法还没想清楚"、"先 brainstorm 一下"、"聊一聊这块"、"方向还在摇摆"。不处理 bug 和重构。
|
||||
description: 模糊想法分诊。触发：用户想先聊、brainstorm、方向摇摆；不处理 bug/重构。
|
||||
---
|
||||
|
||||
# cs-brainstorm
|
||||
@@ -34,7 +34,7 @@ brainstorm 是"讨论层"统一入口。
|
||||
|
||||
每次都做：
|
||||
|
||||
1. **扫一眼仓库**——先读 `.codestable/attention.md`；Glob `.codestable/` 发现 features / roadmap / brainstorms / compound / requirements，读 `requirements/CONTEXT.md` 拿术语、扫 `requirements/adrs/` 看已拍板决策、看已有 feature 和 roadmap 和 brainstorm、`grep -r` 关键词 compound/ 看有没有相关坑；Grep 用户描述里的关键词防术语冲突。缺 attention.md 视为骨架不完整，不回退读外部 AI 入口
|
||||
1. **扫一眼仓库**——先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）；Glob `.codestable/` 发现 features / roadmap / brainstorms / compound / requirements，读 `requirements/CONTEXT.md` 拿术语、扫 `requirements/adrs/` 看已拍板决策、看已有 feature 和 roadmap 和 brainstorm、`grep -r` 关键词 compound/ 看有没有相关坑；Grep 用户描述里的关键词防术语冲突
|
||||
2. **是不是接续之前的工作**：
|
||||
- `features/` 下有名字相近的 brainstorm？`roadmap/` 下有相近子目录？`brainstorms/` 下有相关创意记录？
|
||||
- 没有 → 当新讨论
|
||||
|
||||
+15
-10
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-code-review
|
||||
description: 横切代码审查 gate——任何流程（feature / issue / refactor / fastforward）实现完成后、commit 前，对照对应 spec 产物和当前 git diff 做独立只读 code review，产出 {slug}-review.md；按 Task agent 选择规则启动独立审查（Paseo subagent 优先，否则原生 Codex/Claude Task/Agent），最终由本 skill 合并定级。有 blocking findings 时回到对应实现技能修复，通过后交回上游收尾（feature 进 cs-feat-qa，其余进各自验收/提交）。触发：用户说"做代码审查"、"code review"、"review 这次改动"、"合并前审一下"、"跑 cs-code-review"。
|
||||
description: Code review gate。触发：实现完成后、QA/验收/commit 前审本轮 diff。
|
||||
---
|
||||
|
||||
# cs-code-review
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
本技能是**横切代码审查 gate**：任何流程实现完成后、commit / QA / 验收前，对当前改动做独立只读 review。它只读代码和产物，只写 `{slug}-review.md`，不直接修代码、不更新 checklist、不改 spec、不替代 QA 或 acceptance。
|
||||
|
||||
@@ -43,7 +43,7 @@ description: 横切代码审查 gate——任何流程（feature / issue / refac
|
||||
- diff 涉及的人写代码文件和相邻关键调用点
|
||||
- spec 指向的 architecture / requirement / roadmap 相关文档（只读，判断改动是否会影响归并；feature 即 design 第 4 节）
|
||||
- goal / gate 模式下的 evidence pack、gate results、DoD results；缺失时回 implementation gate 补证据，不现场猜测
|
||||
- 独立 Task agent reviewer 输出（如果本轮启用了 Paseo 或其他 reviewer）
|
||||
- 独立 Task agent reviewer 输出（如果本轮已启动）
|
||||
|
||||
如果工作区有本轮范围外的既有 dirty 文件，先记录为 baseline/无关变更；审查结论只针对本轮可归因的改动。无法区分归因时写成 `residual-risk`，不要把不确定当通过。
|
||||
|
||||
@@ -69,16 +69,21 @@ description: 横切代码审查 gate——任何流程（feature / issue / refac
|
||||
|
||||
| 环节 | 目的 | 是否 gate 必需 |
|
||||
|---|---|---|
|
||||
| **A 独立隔离 agent review** | spec 视角整体审查，用**独立上下文**避免主 agent 确认偏误 | 是（gate 放行靠它） |
|
||||
| **A 独立 Task agent review** | spec 视角整体审查，用**独立上下文**避免主 agent 确认偏误 | 是（gate 放行靠它） |
|
||||
| **B OCR 行级扫描** | 行级 bug / 安全 / 代码模式扫描，补 A 的盲区 | 否（装了就跑，缺了降级） |
|
||||
|
||||
**检测由主 agent 在运行时自检自己的工具**，不靠脚本猜环境——主 agent 最清楚自己手上有哪些工具。
|
||||
|
||||
---
|
||||
|
||||
### 环节 A：独立隔离上下文 agent review（gate 必需）
|
||||
### 环节 A：独立 Task agent review（gate 必需）
|
||||
|
||||
主 agent 按 `.codestable/reference/execution-conventions.md` 的 Task agent 选择规则启动独立 Task agent reviewer：Paseo subagent 优先，否则用当前宿主的原生 Codex/Claude Task/Agent；都没有则记 `local-only`，不能伪装启动。gate 默认不放行，需用户明确降级（见 `reviewer` 字段）。
|
||||
主 agent 按 Task agent 选择规则启动独立 Task agent reviewer（优先 Paseo subagent，否则当前宿主原生 Codex/Claude Task/Agent；都不可用时按 local-only fallback 处理）：
|
||||
|
||||
1. **有 `mcp__paseo__create_agent` 工具** → 用 Paseo subagent（**首选**：能换 provider，做到真正异构审查）。
|
||||
先加载 / 读取 `paseo` skill 的当前说明并遵守其规则：读取 `~/.paseo/orchestration-preferences.json`，使用 `providers.audit`，不要硬编码 provider；文件缺失时用合理默认并在报告说明。
|
||||
2. **否则有当前宿主原生 Codex/Claude Task/Agent 工具** → 启动原生 Task agent。独立上下文同样达成；若同模型，在报告里记录降级和残余风险。
|
||||
3. **两者都没有** → 记 `local-only`，不能伪装启动。gate 默认不放行，需用户明确降级（见 `reviewer` 字段）。
|
||||
|
||||
独立 Task agent reviewer prompt（只给原始材料，不透露主 agent 的任何 review 结论）：
|
||||
|
||||
@@ -170,8 +175,8 @@ gate 默认要求 `subagent` 或 `subagent+ocr`；`ocr` 和 `self` 需配 `CODES
|
||||
|
||||
### 2. 独立审查合并
|
||||
|
||||
- 主 agent 自检工具：是否有 Task agent 能力（Paseo subagent / 原生 Codex/Claude Task/Agent），`which ocr` 是否可用。
|
||||
- 环节 A（独立隔离 Task agent）和环节 B（OCR）可并行启动，互不等待。
|
||||
- 主 agent 自检工具：是否有 `mcp__paseo__create_agent` / 原生 Codex/Claude Task/Agent 工具，`which ocr` 是否可用。
|
||||
- 环节 A（独立 Task agent，Paseo subagent 优先→原生 Task agent）和环节 B（OCR）可并行启动，互不等待。
|
||||
- 本地可以先做整体审查草稿，但最终 verdict 必须等所有已启动 reviewer 返回后才能定稿。
|
||||
- 每环节返回后：逐条本地事实核验，OCR 结果按 High/Medium/Low 映射严重度，能复现 / 有证据才采纳；证据不足只写 residual-risk。
|
||||
- 某环节失败 / 卡住：不要默默降级；报告该环节 `failed|blocked`，交给用户决定重试或明确降级。
|
||||
@@ -268,7 +273,7 @@ gate 默认要求 `subagent` 或 `subagent+ocr`；`ocr` 和 `self` 需配 `CODES
|
||||
- [ ] 已做整体审查和行级审查。
|
||||
- [ ] 已明确区分 blocking / important / nit / suggestion / learning / praise / residual-risk。
|
||||
- [ ] 已写来源 spec 目录下的 `{slug}-review.md`（feature 即 `.codestable/features/{feature}/{slug}-review.md`）。
|
||||
- [ ] `status: passed` 时 frontmatter `reviewer` 已按双环节实际完成写 `subagent+ocr` / `subagent`（或确属无 subagent 平台的 `ocr` / `self` fallback）——这是下游 gate 的放行锚点。
|
||||
- [ ] `status: passed` 时 frontmatter `reviewer` 已按双环节实际完成写 `subagent+ocr` / `subagent`（或确属无 Task agent 能力的 `ocr` / `self` fallback）——这是下游 gate 的放行锚点。
|
||||
- [ ] 有 blocking 时没有进入下游，而是指向来源实现技能的 review-fix。
|
||||
- [ ] 无 blocking 时明确告诉用户「进入来源」表的通过后去向（feature→`cs-feat-qa`）。
|
||||
|
||||
@@ -281,7 +286,7 @@ gate 默认要求 `subagent` 或 `subagent+ocr`；`ocr` 和 `self` 需配 `CODES
|
||||
- 只看测试是否通过，不判断测试是否有效。
|
||||
- 把格式、命名偏好、个人写法升级成 blocking。
|
||||
- 发现设计外实现却不回到 design 契约判断。
|
||||
- 外部 reviewer（Paseo / native-agent / OCR）的结论没经本地事实核验就直接照抄成 blocking。
|
||||
- 外部 reviewer（Paseo subagent / native-agent / OCR）的结论没经本地事实核验就直接照抄成 blocking。
|
||||
- OCR High 直接映射成 blocking，跳过本地核验。
|
||||
- 某路 reviewer 还没返回，就把本地 review 定稿为 passed。
|
||||
- 某路 reviewer 卡住时不问用户就默默降级成 local-only。
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
interface:
|
||||
display_name: "CodeStable Feature Review"
|
||||
short_description: "本地 feature 代码审查，可选 Task agent 辅助"
|
||||
default_prompt: "使用 $cs-code-review 对已实现的 feature 做本地代码审查，并输出 review 报告。"
|
||||
short_description: "实现后 code review gate"
|
||||
default_prompt: "使用 $cs-code-review 审查本轮实现 diff；按 Task agent 选择规则启动独立 Task agent reviewer，并输出 review 报告。"
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
| issue | `issue-review` | `issue: YYYY-MM-DD-slug` |
|
||||
| refactor / refactor-ff | `refactor-review` | `refactor: YYYY-MM-DD-slug` |
|
||||
|
||||
`status` / `reviewed` / `round` 各来源通用。`reviewer` 是 gate 锚点字段，按本轮实际启动的独立 reviewer 组合写：
|
||||
`status` / `reviewed` / `round` 各来源通用。`reviewer` 是 gate 锚点字段，按本轮实际启动的独立 Task agent reviewer / OCR 组合写：
|
||||
|
||||
| 值 | 含义 |
|
||||
|---|---|
|
||||
@@ -106,7 +106,7 @@ round: 1
|
||||
## 6. Verdict
|
||||
|
||||
- Status: passed|changes-requested|blocked
|
||||
- Next: 按「进入来源」表的通过后去向（feature→`cs-feat-qa`，其余→各自验收/提交） | 来源实现技能 review-fix | 等 independent reviewer 完成 / 用户确认降级后重跑本审查 | 补齐输入后重跑本审查
|
||||
- Next: 按「进入来源」表的通过后去向（feature→`cs-feat-qa`，其余→各自验收/提交） | 来源实现技能 review-fix | 等独立 Task agent reviewer 完成 / 用户确认降级后重跑本审查 | 补齐输入后重跑本审查
|
||||
```
|
||||
|
||||
没有某类 finding 时写 `none`，不要删除章节；下一轮复审要能对比。
|
||||
|
||||
+3
-3
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-doc-api
|
||||
description: 给库的公开表面（组件 / 函数 / 命令）逐条目生成参考文档，带清单追踪，支持单条目和批量。信息源是源码本身（与 doc-tutorial 任务导向不同）。触发：用户说"写 API 文档"、"组件文档"、"doc-api"，或 acceptance 后发现新增公开接口。
|
||||
description: API 参考文档。触发：写组件/函数/命令文档，或 acceptance 后新增公开接口。
|
||||
---
|
||||
|
||||
# cs-doc-api
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
doc-tutorial 教你"怎么用 X 做 Y"，doc-api 告诉你"X 的每个零件长什么样、怎么配"。
|
||||
|
||||
@@ -86,7 +86,7 @@ doc-api 产物**不在 `.codestable/` 下**——API 参考是面向外部读者
|
||||
|
||||
1. **先出样板**——从清单选 2-3 个有代表性的条目（不同 category）走"读源码 → 提取 → 按模板生成"并落盘，状态先 `draft`（不直接进 current——批量模式下样板是"风格参考样本"等整体 review 一起转 current）
|
||||
2. **用户确认质量标准**——review 这 2-3 篇确认模板 / 详略 / 风格。**这步不能跳**——50 篇全白写就因为用户想要的风格不一样
|
||||
3. **批量生成**——剩余 `pending` 逐条走"读源码 → 提取 → 生成"，可用 subagent 并行；每条 `status: draft`
|
||||
3. **批量生成**——剩余 `pending` 逐条走"读源码 → 提取 → 生成"，可用 Task agent 并行；每条 `status: draft`
|
||||
4. **整体 review**——批量完成展示概况（条目数 / 跳过数 / 待确认数）；review 前先 `validate-yaml.py --dir docs/api --require doc_type --require entry --require status` 批量校验 Markdown docs（目录模式默认不扫 `manifest.yaml`）
|
||||
5. **确认落定**——用户确认后把样板和批量产出一起改 `status: current`
|
||||
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-doc-tutorial
|
||||
description: 写或更新对外指南文档——开发者指南（dev-guide）和用户指南（user-guide），产物在项目 docs/ 目录。任务导向（怎么用 X 做 Y），与 doc-api 的零件参考不同。触发：用户说"写文档"、"开发者指南"、"用户指南"，或 feature-acceptance 收尾时推送。
|
||||
description: 对外指南文档。触发：写开发者/用户指南，或 acceptance 后需要任务导向 docs。
|
||||
---
|
||||
|
||||
# cs-doc-tutorial
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
代码解决问题，文档让别人能用它解决问题。spec 记录"做了什么、为什么这么做"，但下游开发者和终端用户不需要、也不应该读 spec——他们需要面向自己角色的、可发布的指南。doc-tutorial 就是从 spec 和代码出发写成读者真正能用的指南。
|
||||
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-docs-neat
|
||||
description: CodeStable 文档与知识库收尾整理技能。用于阶段结束、里程碑完成、准备交接/提交、用户说"整理文档"、"同步记忆"、"更新 AGENTS/CLAUDE"、"收尾"、"这个阶段做完了"、"新人能直接上手"、"docs 过期/冲突了"、"sync up"、"tidy up docs"、"update memory"、"/sync"、"/neat"时，对 `.codestable/`、项目根 `CLAUDE.md` / `AGENTS.md`、README、docs/ 和可用 agent 记忆做全局盘点、反膨胀、补漏和冲突修正。
|
||||
description: CodeStable 文档收尾。触发：阶段结束、整理文档、同步记忆、/sync、/neat。
|
||||
---
|
||||
|
||||
# cs-docs-neat
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
你是**知识库编辑**，不是记录员。记录员只会追加；编辑要审查全局、合并重复、修正过期、删除废弃，把稳定知识放到正确受众层。目标是让下一位人类、下一次 agent、下游项目都不会被旧文档误导。
|
||||
|
||||
|
||||
+2
-2
@@ -1,11 +1,11 @@
|
||||
---
|
||||
name: cs-domain
|
||||
description: 维护项目的领域模型（domain model）——CONTEXT.md 术语表 + ADR 决策记录 + 单/多 context 拓扑。触发：用户说"记一条决策"/"拍板了"/"加个术语"/"这个项目要分子系统了"，或 cs-brainstorm / cs-feat-design / cs-refactor 拍板时路由过来。
|
||||
description: 领域模型维护。触发：记决策、加术语、拆 context、维护 CONTEXT/ADR。
|
||||
---
|
||||
|
||||
# cs-domain
|
||||
|
||||
先读 `.codestable/attention.md`；缺失提示跑 `cs-onboard`。
|
||||
先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
cs-domain 管三件事：**术语**（CONTEXT.md）、**决策**（ADR）、**拓扑**（单 context ↔ 多 context）。所有产物在 `.codestable/requirements/` 下。
|
||||
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-feat-accept
|
||||
description: feature 流程阶段 3——验收闭环：对照 design 核实现 + review 报告 + QA 报告或验收现场验证证据 + 盘点 cs-domain 候选（提示而非代写）+ 回写 requirement / roadmap，最后产出 {slug}-acceptance.md；可选只读 acceptance Task agent auditor 辅助复核，但最终状态写入由本技能负责。触发：用户说"功能写完了验收一下"、"做最后检查"、"准备 merge"、"出验收报告"。
|
||||
description: Feature acceptance。触发：实现、review、QA 后最终验收，或准备 merge/出验收报告。
|
||||
---
|
||||
|
||||
# cs-feat-accept
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
代码已经写完，但流程没结束。本阶段做四件事，缺一不可：
|
||||
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-feat-design-review
|
||||
description: feature design 人工确认前的方案审查 gate。对照 {slug}-design.md、{slug}-checklist.yaml、相关 roadmap / requirement / architecture / compound / 代码事实做只读 review，产出 {slug}-design-review.md；按 Task agent 选择规则启动独立审查（Paseo subagent 优先，否则原生 Codex/Claude Task/Agent），主 agent 等待结果、事实核验并合并定级。触发：用户说"review 这个 design"、"feature design 人审前先独立审查"、"跑 cs-feat-design-review"、"方案审查"。
|
||||
description: Feature design review gate。触发：人审前审 design/checklist，或用户要求方案审查。
|
||||
---
|
||||
|
||||
# cs-feat-design-review
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
本阶段是 feature design 交给用户人工确认前的方案审查 gate。它只读 design、checklist、相关文档和必要代码事实，只写 `{slug}-design-review.md`，不直接改 design/checklist、不替用户批准 design、不进入实现。
|
||||
|
||||
@@ -31,7 +31,7 @@ description: feature design 人工确认前的方案审查 gate。对照 {slug}-
|
||||
- design 第 4 节指向的 architecture 文档
|
||||
- 相关 compound 沉淀：用项目搜索工具按 feature 关键词检索 decision / learning / explore / trick
|
||||
- design 中引用到的关键代码位置、接口、类型、组件、命令、配置
|
||||
- 独立 Task agent reviewer 输出（如果本轮启用了 Paseo 或其他 reviewer）
|
||||
- 独立 Task agent reviewer 输出（如果本轮已启动）
|
||||
|
||||
没有代码引用时不强行扫全仓库；但 design 声称复用、修改、挂载或约束某个现有模块时，必须读对应代码或文档事实核验。
|
||||
|
||||
@@ -52,13 +52,17 @@ description: feature design 人工确认前的方案审查 gate。对照 {slug}-
|
||||
|
||||
## 独立 Task agent reviewer 增强项
|
||||
|
||||
本阶段默认由当前 agent 做本地方案审查；独立 Task agent reviewer 是增强项，不是硬依赖。检测不到 Task agent、provider 未配置或用户明确要求快速完成时，可以继续本地 review，并在报告里记录 `Independent reviewer: local-only` / `skipped-by-user`。
|
||||
本阶段默认由当前 agent 做本地方案审查；独立 Task agent reviewer 是增强项，不是硬依赖。检测不到 Task agent 能力、provider 未配置或用户明确要求快速完成时，可以继续本地 review，并在报告里记录 `Independent reviewer: local-only` / `skipped-by-user`；若需要用户授权降级，先按 `.codestable/reference/approval-conventions.md` 写 `approval-report.md`，再让用户选择。
|
||||
|
||||
但一旦本轮已经启动独立 Task agent reviewer，它就是本轮 review gate 的输入。主 agent 可以先做本地审查草稿，但不能在 reviewer 返回前定稿 `{slug}-design-review.md`、不能给出 `passed`、不能把 design 交给用户确认。reviewer 卡住、失败、权限阻塞或耗时过长时，只能把本轮标成 `blocked` / `independent-review-pending`，让用户决定继续等待、重试 reviewer，或明确降级为 local-only review。
|
||||
|
||||
**检测由主 agent 在运行时自检自己的工具**，按 `.codestable/reference/execution-conventions.md` 的 Task agent 选择规则启动独立 Task agent reviewer：Paseo subagent 优先，否则用当前宿主的原生 Codex/Claude Task/Agent。都没有则本地 review，记录 `local-only`，并写入 `approval-report.md` 请 owner 授权降级；不要伪装启动。不要无限轮询运行中的 agent；若已启动但未返回，停止在 review gate，记录 pending/blocked，等待通知或用户决定。
|
||||
**检测由主 agent 在运行时自检自己的工具**，不靠脚本猜环境——主 agent 最清楚自己手上有哪些工具。按 Task agent 选择规则启动独立 Task agent reviewer（优先 Paseo subagent，否则当前宿主原生 Codex/Claude Task/Agent）：
|
||||
|
||||
Task agent prompt 必须只给原始材料和边界，不透露本地 review 结论：
|
||||
1. **有 `mcp__paseo__create_agent` 工具**：优先用 Paseo subagent 做只读独立审查（**首选**：能换 provider，做到真正异构审查）。启动前先加载 / 读取 `paseo` skill 的当前说明，并遵守它的规则：读取 `~/.paseo/orchestration-preferences.json`，使用 `providers.audit`，不要硬编码 Claude 或 Codex。不要无限轮询运行中的 agent；如果 reviewer 已启动但结果未返回，停止在 review gate，记录 pending/blocked，等待通知或用户决定。
|
||||
2. **否则有当前宿主原生 Codex/Claude Task/Agent 工具**：用原生 Task agent 做独立上下文审查。如属同类 agent，在报告里记录降级和残余风险。
|
||||
3. **两者都没有**：本地 review，记录 `local-only`，并在需要授权降级时写 `approval-report.md`；不要伪装启动。
|
||||
|
||||
独立 Task agent reviewer prompt 必须只给原始材料和边界，不透露本地 review 结论：
|
||||
|
||||
```text
|
||||
你是 CodeStable feature design 的独立方案审查 agent。只读，不修改文件，不更新 design/checklist。
|
||||
@@ -77,7 +81,7 @@ Task agent prompt 必须只给原始材料和边界，不透露本地 review 结
|
||||
不要写 {slug}-design-review.md；只把审查结果回传给主 agent。
|
||||
```
|
||||
|
||||
主 agent 仍是最终审查责任方：必须逐条核验 reviewer 的 finding，去重、定级、合并进 `{slug}-design-review.md`。未经本地事实核验的外部结论只能写 `residual-risk` 或忽略，不能直接升级成 `blocking`。
|
||||
主 agent 仍是最终审查责任方：必须逐条核验独立 Task agent reviewer 的 finding，去重、定级、合并进 `{slug}-design-review.md`。未经本地事实核验的外部结论只能写 `residual-risk` 或忽略，不能直接升级成 `blocking`。
|
||||
|
||||
---
|
||||
|
||||
@@ -97,7 +101,7 @@ Task agent prompt 必须只给原始材料和边界，不透露本地 review 结
|
||||
|
||||
- 记录主 agent 自检结果：`paseo` / `native-agent` / `local-only`。
|
||||
- 没有启动独立 Task agent reviewer 时，记录原因，本地 review 可以定稿。
|
||||
- 启动 Task agent 后，最终 verdict 必须等 reviewer 返回。
|
||||
- 启动 Paseo subagent / 原生 Task agent 后，最终 verdict 必须等 reviewer 返回。
|
||||
- reviewer 返回后逐条做本地事实核验；能用 design / checklist / 文档 / 代码证据支撑才合并。
|
||||
- reviewer 失败、权限阻塞、超时或仍在运行时，不要默默降级；报告 `status: blocked`。
|
||||
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
interface:
|
||||
display_name: "CodeStable Feature Design Review"
|
||||
short_description: "Feature design 人审前的 Task agent 审查"
|
||||
default_prompt: "使用 $cs-feat-design-review 在人工确认前审查 feature design 和 checklist。"
|
||||
short_description: "Feature design 人审前 gate"
|
||||
default_prompt: "使用 $cs-feat-design-review 在人工确认前审查 feature design 和 checklist；按 Task agent 选择规则处理独立 Task agent reviewer。"
|
||||
|
||||
+5
-31
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-feat-design
|
||||
description: feature 流程阶段 1——为新功能起草 {slug}-design.md 和 {slug}-checklist.yaml，先交给 cs-feat-design-review 做人审前方案审查，再由用户整体确认为 approved。触发：用户说"开始设计方案"、"写 design doc"、"准备实现 XX"，前提是已知道做什么、为谁、怎么算成功。
|
||||
description: Feature design。触发：新功能已清楚，需要起草 design/checklist。
|
||||
---
|
||||
|
||||
# cs-feat-design
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
这一阶段的产出是一份方案文件 `{slug}-design.md`，加上从中抽出的行动清单 `{slug}-checklist.yaml`，以及人审前的 `{slug}-design-review.md`。这些东西后面会被 implement / code review / QA / acceptance 消费，所以这里写错或写漏，下游就跟着错。
|
||||
|
||||
@@ -34,34 +34,8 @@ description: feature 流程阶段 1——为新功能起草 {slug}-design.md 和
|
||||
|
||||
1. **和用户快速对齐两件事**——一句话需求概要 + 敲定 slug（小写字母、数字、连字符；`user-auth`、`export-csv` 这种）。日期取当天（frontmatter 用 `currentDate` 即可）。feature 目录命名是 `YYYY-MM-DD-{slug}`。
|
||||
2. **创建 `.codestable/features/{YYYY-MM-DD}-{slug}/` 目录**。
|
||||
3. **写一份空的 `{slug}-intent.md`** 作为草稿骨架，内容就是下面这段：
|
||||
|
||||
```markdown
|
||||
---
|
||||
doc_type: feature-intent
|
||||
feature: {YYYY-MM-DD}-{slug}
|
||||
status: draft
|
||||
summary: {一句话需求，AI 按和用户对齐的结果填}
|
||||
---
|
||||
|
||||
# {slug} intent
|
||||
|
||||
## 背景 / 为什么做
|
||||
|
||||
（一句话就够）
|
||||
|
||||
## 大致怎么做
|
||||
|
||||
（100 字左右描述想法，含关键步骤 / 数据流）
|
||||
|
||||
## 相关数据结构 / 类型
|
||||
|
||||
（贴相关 types、接口签名、或指向代码位置）
|
||||
|
||||
## 已知不做 / 待定
|
||||
|
||||
（可选：明确的边界或自己也没想清楚的地方）
|
||||
```
|
||||
3. **写一份空的 `{slug}-intent.md`** 作为草稿骨架，模板见 `references/intent-template.md`
|
||||
的“feature intent 草稿模板”。
|
||||
|
||||
4. **告知用户"骨架已建好，填完后再来找我，我基于 intent 写正式 design"**，然后**本轮结束，不继续推进 design 流程**。
|
||||
|
||||
@@ -244,7 +218,7 @@ AI 默认翻车的姿势是**不思考就往眼前最顺手的文件里加**。
|
||||
|
||||
- `passed`：才能把 design + checklist + design-review 报告交给用户整体 review。
|
||||
- `changes-requested`：按 finding 修 design/checklist，重新校验 yaml 并重跑 `cs-feat-design-review`。
|
||||
- `blocked`：补齐输入、等待 independent reviewer，或让用户明确降级 local-only 后重跑。
|
||||
- `blocked`：补齐输入、等待独立 Task agent reviewer，或让用户明确降级 local-only 后重跑。
|
||||
|
||||
### 6. 用户整体 review
|
||||
|
||||
|
||||
@@ -0,0 +1,30 @@
|
||||
# feature intent 草稿模板
|
||||
|
||||
`cs-feat-design` 初始化模式使用本模板创建 `{slug}-intent.md`。创建后本轮结束，等用户填完再回到正式 design。
|
||||
|
||||
```markdown
|
||||
---
|
||||
doc_type: feature-intent
|
||||
feature: {YYYY-MM-DD}-{slug}
|
||||
status: draft
|
||||
summary: {一句话需求，AI 按和用户对齐的结果填}
|
||||
---
|
||||
|
||||
# {slug} intent
|
||||
|
||||
## 背景 / 为什么做
|
||||
|
||||
（一句话就够）
|
||||
|
||||
## 大致怎么做
|
||||
|
||||
（100 字左右描述想法，含关键步骤 / 数据流）
|
||||
|
||||
## 相关数据结构 / 类型
|
||||
|
||||
（贴相关 types、接口签名、或指向代码位置）
|
||||
|
||||
## 已知不做 / 待定
|
||||
|
||||
（可选：明确的边界或自己也没想清楚的地方）
|
||||
```
|
||||
+2
-2
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-feat-ff
|
||||
description: feature 流程的超轻量通道——不写 design / checklist 直接动手，但先指引 AI 查 CodeStable 知识库再开工。触发：用户说"快速模式"、"fastforward"、"别那么多步骤"、"直接开干"，且需求小到不值得走 design 流程。
|
||||
description: Feature 快速通道。触发：快速模式/直接开干，且需求小到不值得 design。
|
||||
---
|
||||
|
||||
# cs-feat-ff
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
用户让你做小功能时本来 AI 就会直接动手——这个技能**不改变这件事**。它只做一件事：动手前把项目里已沉淀的 CodeStable 知识指给你，按需搜一下，写出来的代码就比裸写多一层保护；动手后回写一份**最简的 `{slug}-ff-note.md`** 让这次工作可追溯、可被 cs-req / cs-domain backfill 看到、能纳入 scoped-commit 提交。
|
||||
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-feat-impl
|
||||
description: feature 流程阶段 2——按 {slug}-checklist.yaml 里 design 切好的 paradigm 维度 steps 推进，每步具体改哪个文件由 implement 自决，写完用统一格式汇报；也处理 cs-code-review 返回的 review-fix 和 cs-feat-qa 返回的 qa-fix。触发：用户说"方案确认了开始实现"、"按方案写代码"、"开工"、"修 review blocking"、"修 QA 失败项"。前提是 design 已 approved 且有 checklist。遇到方案外情况要回方案谈不要硬冲。
|
||||
description: Feature 实现。触发：approved design/checklist 后开工，或修 review/QA blocking。
|
||||
---
|
||||
|
||||
# cs-feat-impl
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
到这一步用户已经在方案上签过字了，你的活是把方案变成代码。容易出问题的不是写代码本身，而是**实现路上发现方案没覆盖到的情况时怎么办**——硬冲下去就把方案当摆设了。下面整套规则就是为了让"停下来"成为默认动作。
|
||||
|
||||
|
||||
+2
-2
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-feat-qa
|
||||
description: feature 流程阶段 2.6——代码审查通过后的 QA 验证 gate。对照 design / checklist / review 报告和最终 diff，运行必跑命令、测试、浏览器或手工验证，产出 {slug}-qa.md；可选独立 QA Task agent 辅助执行验证，但正式 verdict 和报告由本技能落盘；QA 失败时回到 cs-feat-impl 的 qa-fix。触发：用户说"做 QA"、"跑测试验收前验证"、"review 过了跑 QA"、"跑 cs-feat-qa"。
|
||||
description: Feature QA gate。触发：code review passed 后跑验证，或用户要求 QA。
|
||||
---
|
||||
|
||||
# cs-feat-qa
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
本阶段是 review 通过后、acceptance 前的 QA gate。它只读代码和产物、运行验证命令 / 浏览器 / API / 手工检查，并写 `{slug}-qa.md`。默认不改代码、不改 checklist、不改 design；发现失败后回到 `cs-feat-impl` 的 qa-fix。
|
||||
|
||||
|
||||
+2
-2
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-feat
|
||||
description: 新功能开发的子流程入口，把"加个 X 能力"从想法走到验收闭环。触发：用户说"做新功能"、"加个 X"、"实现 XX"。只做路由，根据已有产物决定走 brainstorm / design / design-review / fastforward / implement / code-review / QA / acceptance。不处理 bug。
|
||||
description: Feature 路由入口。触发：新功能/加 X/实现 XX，按状态进入 design/impl/review/QA/accept。
|
||||
---
|
||||
|
||||
# cs-feat
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
新功能流程在"需求"和"代码"之间塞了一份方案文件，让两边有交接点——AI 直接拿到需求就写代码会出三个老问题：名字跟原代码对不上、改着改着改出范围、改完不留存档。
|
||||
|
||||
|
||||
+3
-1
@@ -1,10 +1,12 @@
|
||||
---
|
||||
name: cs-goal
|
||||
description: 有界起点/终点目标的自主迭代流程。触发：owner 给出期望结果、验收结果、预算，或要求 AI "达成这个 goal"、"一直跑到验收"、"自主迭代"、"先 grill me 再实现"。在 `.codestable/goals/` 下创建起点、iteration 和功能验收产物；报告正文遵守 `.codestable/attention.md`。
|
||||
description: Goal 自主达成。触发：明确终点/验收/预算、持续迭代到完成，或 grill me 后开工。
|
||||
---
|
||||
|
||||
# cs-goal
|
||||
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
`cs-goal` 处理有界 goal：owner 给出起点和期望终态，CodeStable 先做轻量
|
||||
interview / grill，动手前写起点报告，然后自主实现、验证、迭代；完成前必须请求
|
||||
Task agent 做功能验收，并写 iteration 报告。报告正文遵守
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
interface:
|
||||
display_name: "cs-goal"
|
||||
short_description: "用报告和 Task agent 功能验收推进有界 goal"
|
||||
default_prompt: "使用 $cs-goal 处理有界起点/终点目标：创建带日期的 goal 目录，轻量 grill，按项目报告语言写起点和 iteration 报告，自主迭代，并在完成前要求 Task agent 功能验收。"
|
||||
short_description: "有界目标自主迭代"
|
||||
default_prompt: "使用 $cs-goal 处理有明确起点和终点的目标：创建 goal 目录，写起点和迭代报告，自主实现/验证，并在完成前要求 Task agent 功能验收。"
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-issue-analyze
|
||||
description: issue 流程阶段 2——读 report + 读代码定位根因、评估风险，给用户 2-3 个修复方案让 TA 拍板。这一步不改代码。触发：用户说"分析这个 bug"、"找根因"、"定位问题"，且已有 {slug}-report.md。
|
||||
description: Issue 根因分析。触发：已有 report 后找根因、评估风险、给修复方案；不改代码。
|
||||
---
|
||||
|
||||
# cs-issue-analyze
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
用户已把问题描述清楚，你的活是**通过实际读代码找根因**——不是脑子里推断、不是在报告基础上猜。读代码是核心动作，跳过它写出来的分析没价值。
|
||||
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-issue-fix
|
||||
description: issue 流程阶段 3——按已确认根因和方案定点修复、验证、写 {slug}-fix-note.md 落档。两个入口：标准路径从 analyze 来，快速通道从 report 直接来。触发：用户说"开始修 bug"、"按分析修"、"动手改代码"。只动方案声明的文件，不顺手优化。
|
||||
description: Issue 定点修复。触发：按根因方案修 bug、动手改代码；只动方案声明范围。
|
||||
---
|
||||
|
||||
# cs-issue-fix
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
根因和方案已经确定（标准路径在 analysis、快速通道在 report 阶段口头确认过），你的活是按方案改代码、验证效果、写下修复记录。
|
||||
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-issue-report
|
||||
description: issue 流程阶段 1——通过对话把问题落成可复现、可追溯的 {slug}-report.md，并判定走标准路径还是快速通道。只问现象不猜根因。触发：用户说"提个 issue"、"记录这个 bug"、"我发现一个问题"。issue 工作流的起点。
|
||||
description: Issue 报告起草。触发：提 issue/记录 bug/发现问题；只问现象，不猜根因。
|
||||
---
|
||||
|
||||
# cs-issue-report
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
这一阶段做两件事：把用户脑子里的问题落成结构化记录 + 判断走标准路径还是快速通道。
|
||||
|
||||
|
||||
+2
-2
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-issue
|
||||
description: 修 bug 的子流程入口，把"发现问题"走到验证修复闭环，留下 report / analysis / fix-note 三份文件。触发：用户说"修 bug"、"有个问题"、"修复 XX"。只做路由，根据已有产物走 report / analyze / fix。简单问题走快速通道。
|
||||
description: Issue 流程路由。触发：修 bug/有问题/修复 XX；按状态进入 report/analyze/fix。
|
||||
---
|
||||
|
||||
# cs-issue
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
修 bug 直觉是"找到错的地方改了完事"，但这个直觉路径反复制造同样的麻烦：
|
||||
|
||||
|
||||
+2
-2
@@ -1,11 +1,11 @@
|
||||
---
|
||||
name: cs-keep
|
||||
description: 把刚发现的坑、技巧、决策、调研沉淀到 .codestable/compound/，纯 markdown 文件，靠 grep 检索。触发：用户说"记下来"、"沉淀一下"、"留个 note"，或 cs-feat-accept / cs-issue-fix / cs-feat-design / cs-issue-analyze 收尾时推送。
|
||||
description: 项目知识沉淀。触发：用户说“记下来/沉淀/留个 note”，或流程收尾发现可复用坑、技巧、决策。
|
||||
---
|
||||
|
||||
# cs-keep
|
||||
|
||||
先读 `.codestable/attention.md`；缺失就提示跑 `cs-onboard`。
|
||||
先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
把这次值得记的事写到 `.codestable/compound/YYYY-MM-DD-{slug}.md`：
|
||||
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: cs-note
|
||||
description: 把"短到不值得起一份文件、但 AI 每次启动 CodeStable 技能都必须知道"的项目碎片知识追加到 `.codestable/attention.md` 的固定分节里——比如编译特殊 flag、运行前要先起的服务、路径陷阱、命令别名、环境变量约定。触发：用户说"记一笔"、"加到 attention.md"、"项目要 X 才能编译"、"以后每次都得 Y"，或刚踩到一个一句话能讲清的项目特殊设置。
|
||||
description: attention 短规则追加。触发：记一笔/加到 attention/以后每次都得知道 X。
|
||||
---
|
||||
|
||||
# cs-note
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: cs-onboard
|
||||
description: 把新仓库或有零散文档的仓库接入 CodeStable 体系，两条路径自动判断：空仓库从零搭骨架，已有文档走审计 + 迁移映射。触发：用户说"在这个项目里用 CodeStable"、"搭 CodeStable 结构"、"初始化 CodeStable"、"迁移到 CodeStable"。
|
||||
description: CodeStable 接入。触发：初始化/迁移/搭骨架，自动判断空仓库或已有文档。
|
||||
---
|
||||
|
||||
# cs-onboard
|
||||
|
||||
@@ -4,6 +4,17 @@
|
||||
`.codestable/reference/execution-conventions.md`。它负责共享的执行、
|
||||
worktree、review、finish 和 handoff 规则。
|
||||
|
||||
## CodeStable Preflight
|
||||
|
||||
任何 CodeStable skill 在判断或动作前先执行 preflight：
|
||||
|
||||
1. 读取 `.codestable/attention.md`。
|
||||
2. 缺 `.codestable/attention.md` 时视为骨架不完整，提示补齐或运行 `cs-onboard`。
|
||||
3. 不回退读取 `AGENTS.md` / `CLAUDE.md` / `.cursorrules` 等外部 AI 入口文件。
|
||||
4. 正文报告语言按 `.codestable/attention.md` 的报告语言策略执行；frontmatter / yaml 字段不翻译。
|
||||
|
||||
`cs-note` 是唯一例外：`.codestable/` 存在但 `attention.md` 缺失时，它可以创建最小分节骨架后写入。
|
||||
|
||||
## 主协调检出与执行 worktree
|
||||
|
||||
CodeStable 把讨论 / 规划和代码编辑分开：
|
||||
@@ -74,6 +85,7 @@ unit。若 goal 还没有子 unit，在 goal iteration 中记录原因，并采
|
||||
工具时）；否则使用当前宿主平台的原生 Codex/Claude Task/Agent 能力。两者都不可用或
|
||||
未获授权时，记录限制，并按该 gate 的显式 fallback / owner-stop 路径处理。
|
||||
|
||||
凡涉及只读独立审查、QA runner、acceptance auditor 或实现协作时，统一按这条规则启动。
|
||||
不要把主 agent 的结论泄露进 Task agent prompt。只提供原始产物、审查范围和期望输出。
|
||||
主 agent 仍负责核验返回 findings，并负责所有最终状态写入。
|
||||
|
||||
|
||||
@@ -36,7 +36,7 @@ onboard 完成后骨架（`cs-onboard` 负责搭建）：
|
||||
│ ├── {slug}-start-report.md 起点报告
|
||||
│ ├── {slug}-state.yaml 机器可读状态
|
||||
│ ├── {slug}-iteration-*.md 迭代报告
|
||||
│ └── {slug}-functional-acceptance.md 子 agent 功能验收
|
||||
│ └── {slug}-functional-acceptance.md Task agent 功能验收
|
||||
├── features/ feature spec 聚合根
|
||||
│ └── YYYY-MM-DD-{slug}/ 每个 feature 一个目录
|
||||
│ ├── {slug}-brainstorm.md （可选，case 2 时产出）
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-refactor-ff
|
||||
description: refactor 流程的超轻量通道——直接识别 1-3 条低风险优化、一次确认、原地改、跑测试自证。触发：用户说"快速重构"、"小重构"、"简单优化下 XX 函数"、"别那么多步骤"，且改动在单函数 / 单组件局部、有测试可自证。
|
||||
description: 快速重构通道。触发：小重构/简单优化局部函数组件，且可测试自证。
|
||||
---
|
||||
|
||||
# cs-refactor-ff
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
用户说"优化一下这个函数"而改动明显很小（单函数变长、组件里抽个 composable、一段重复代码合并）时走完整三阶段太重。fastforward 让 AI 像平时一样直接改但守住底线——行为等价、引用经典方法、跑测试自证。
|
||||
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-refactor
|
||||
description: 代码优化的子流程入口，处理"行为不变、结构变"的工作（结构 / 性能 / 可读性），按 scan → design → apply 分步执行每步人工放行。触发：用户说"优化一下 / 重构 / 重写 / 拆一下 / 性能不行 / 代码太长"且不夹带行为改动。不处理新需求 / bug / 跨模块架构重划。
|
||||
description: 受控重构入口。触发：优化/重构/拆分/性能/代码太长，且不改变行为、不新增需求。
|
||||
---
|
||||
|
||||
# cs-refactor
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
AI 自己重构有两个稳定失败模式：一是不知道模块真实需求和约束，改出来的东西功能不等价；二是一次吞掉的范围超过上下文承载，改到后面忘了前面的约束。这流程在"想优化"和"动手改"之间塞了扫描清单 + 方法库，让 AI 只接自己能稳定做对的活。
|
||||
|
||||
|
||||
+2
-2
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-req
|
||||
description: 维护 `.codestable/requirements/` 下的能力愿景文档。三种模式 draft / backfill / update。触发：design 阶段起草愿景、acceptance 阶段落档，或用户说"刷新 requirements"、"补一份 req"、"先把愿景写下来"。
|
||||
description: 能力愿景维护。触发：起草/回填/更新 requirements，或 design/acceptance 需要 req delta。
|
||||
---
|
||||
|
||||
# cs-req
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
`.codestable/requirements/` 是项目的"能力清单"——每份描述**一个能力因什么问题而产生、怎么解决、边界在哪**，写成人话非技术读者也能看懂。架构文档讲"怎么搭"，需求文档讲"为什么要有"。
|
||||
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-roadmap-impl-goal
|
||||
description: CodeStable 大需求端到端 goal 编排技能。用于用户给出一个较大软件需求，并希望先用 cs-roadmap 沉淀 roadmap，经 cs-roadmap-review 通过后用户确认，再为 roadmap items 中每个子 feature 完成 cs-feat-design/checklist 和 cs-feat-design-review，经过用户确认后输出一条可直接粘贴的 /goal 指令，由 goal 会话循环逐个 feature 执行 cs-feat-impl、cs-code-review、cs-feat-qa 和 cs-feat-accept，直到整个 roadmap 验收完成。触发：用户说“做完整个 roadmap”、“把这个大需求拆完并自动推进”、“生成 goal 指令跑完整个 CodeStable roadmap”、“像 supergoal 一样规划并执行这些 features”、“一次性跑完 roadmap 里的所有 feature”等。
|
||||
description: Roadmap goal 编排。触发：完整推进大需求、执行整个 roadmap、输出 /goal 指令。
|
||||
---
|
||||
|
||||
# cs-roadmap-impl-goal
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
---
|
||||
|
||||
@@ -197,11 +197,7 @@ features:
|
||||
|
||||
## 输出给用户的 goal 指令
|
||||
|
||||
确认通过后，打印一条 fenced `/goal`，然后停止：
|
||||
|
||||
```text
|
||||
/goal "执行 CodeStable roadmap 目录 .codestable/roadmap/{slug} 下的 goal 执行包。先读取 goal-protocol.md、goal-protocol-feature-loop.md、goal-protocol-gates.md、goal-protocol-audit.md、goal-state.yaml、goal-plan.md；这是已由用户确认 roadmap 和全部 feature design 后的 goal 模式，按 goal-plan.md 的 Gate Policy 与 goal-protocol-gates.md 的 gate 接管规则执行。按 goal-state.yaml 的 features 顺序循环处理每个 feature：读取 goal-features/{feature-slug}.md、对应 design 和 checklist，完成 cs-feat-impl，再完成 cs-code-review；如果 review 有 blocking findings，按 review-fix 修复后重跑 cs-code-review；review passed 后完成 cs-feat-qa；如果 QA failed / blocked，按 qa-fix 修复后重跑 cs-code-review 和 cs-feat-qa；QA passed 后完成 cs-feat-accept，并更新 goal-state.yaml 与 roadmap items。每个 feature 验证通过后打印 CS_ROADMAP_GOAL_FEATURE_DONE。所有 feature 完成后，按 goal-protocol-audit.md 做最终 roadmap 审计。只有当 CS_ROADMAP_GOAL_COMPLETE 出现在 transcript 中，且所有 feature 都已 review passed、QA passed 且 accept、最终审计通过、没有 CS_ROADMAP_GOAL_HANDOFF，本 goal 才算完成。"
|
||||
```
|
||||
确认通过后，读取 `references/goal-command-template.md`，替换 `{slug}`，打印一条 fenced `/goal`，然后停止。
|
||||
|
||||
只输出指令，不替用户执行；slash command 只能由用户粘贴触发。
|
||||
|
||||
@@ -231,4 +227,4 @@ features:
|
||||
|
||||
## 资源
|
||||
|
||||
写 `goal-protocol*.md` 时读取 `references/protocol.md`、`references/protocol-feature-loop.md`、`references/protocol-gates.md`、`references/protocol-audit.md`。
|
||||
写 `goal-protocol*.md` 时读取 `references/protocol.md`、`references/protocol-feature-loop.md`、`references/protocol-gates.md`、`references/protocol-audit.md`。输出 slash command 时读取 `references/goal-command-template.md`。
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
interface:
|
||||
display_name: "CodeStable Roadmap Goal"
|
||||
short_description: "把大需求编排成 roadmap goal"
|
||||
default_prompt: "使用 $cs-roadmap-impl-goal 把这个大需求沉淀成 CodeStable roadmap，跑 roadmap/design review gate，完成全部 feature design，并输出可直接粘贴的 goal 指令。"
|
||||
default_prompt: "使用 $cs-roadmap-impl-goal 把大需求沉淀成 CodeStable roadmap，跑 roadmap/design review gate，完成全部 feature design，并输出可直接粘贴的 /goal 指令。"
|
||||
|
||||
@@ -0,0 +1,7 @@
|
||||
# Roadmap Goal 指令模板
|
||||
|
||||
`cs-roadmap-impl-goal` 在完成两次用户确认、写完 goal 执行包并自查通过后，按本模板输出 fenced `/goal`。替换 `{slug}`，保留 `{feature-slug}` 运行时占位。
|
||||
|
||||
```text
|
||||
/goal "执行 CodeStable roadmap 目录 .codestable/roadmap/{slug} 下的 goal 执行包。先读取 goal-protocol.md、goal-protocol-feature-loop.md、goal-protocol-gates.md、goal-protocol-audit.md、goal-state.yaml、goal-plan.md；这是已由用户确认 roadmap 和全部 feature design 后的 goal 模式，按 goal-plan.md 的 Gate Policy 与 goal-protocol-gates.md 的 gate 接管规则执行。按 goal-state.yaml 的 features 顺序循环处理每个 feature：读取 goal-features/{feature-slug}.md、对应 design 和 checklist，完成 cs-feat-impl，再完成 cs-code-review；如果 review 有 blocking findings，按 review-fix 修复后重跑 cs-code-review；review passed 后完成 cs-feat-qa；如果 QA failed / blocked，按 qa-fix 修复后重跑 cs-code-review 和 cs-feat-qa；QA passed 后完成 cs-feat-accept，并更新 goal-state.yaml 与 roadmap items。每个 feature 验证通过后打印 CS_ROADMAP_GOAL_FEATURE_DONE。所有 feature 完成后，按 goal-protocol-audit.md 做最终 roadmap 审计。只有当 CS_ROADMAP_GOAL_COMPLETE 出现在 transcript 中，且所有 feature 都已 review passed、QA passed 且 accept、最终审计通过、没有 CS_ROADMAP_GOAL_HANDOFF，本 goal 才算完成。"
|
||||
```
|
||||
@@ -59,7 +59,7 @@
|
||||
|
||||
- review 基于当前 diff。
|
||||
- review `status=passed`。
|
||||
- review 必须由独立 reviewer 完成；frontmatter `reviewer: subagent` 或 `subagent+ocr` 是默认放行锚点。`reviewer: ocr` / `self` 只能作为用户显式降级 fallback，不能静默通过。
|
||||
- review 必须由独立 Task agent reviewer 完成；frontmatter `reviewer: subagent` 或 `subagent+ocr` 是默认放行锚点。`reviewer: ocr` / `self` 只能作为用户显式降级 fallback，不能静默通过。
|
||||
- 无 unresolved blocking。
|
||||
- review 明确消费 evidence pack 和 gate results。
|
||||
- high-risk provider warnings 已解释或交给 QA。
|
||||
|
||||
@@ -28,7 +28,7 @@
|
||||
仍必须 handoff 的情况：
|
||||
|
||||
- 需要改变已批准 design、roadmap item、接口契约或 feature 范围。
|
||||
- 独立 reviewer pending / failed / blocked，且没有用户明确降级。
|
||||
- 独立 Task agent reviewer pending / failed / blocked，且没有用户明确降级。
|
||||
- 同一失败项三轮修复仍不通过。
|
||||
- 外部凭证或环境缺失导致核心行为无法判断。
|
||||
- 功能性核心路径或 roadmap 级核心验收路径无法验证。
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-roadmap-review
|
||||
description: roadmap 人工确认前的规划审查 gate。对照 roadmap 主文档、items.yaml、相关 requirement / architecture / compound / 代码事实做只读 review，产出 {slug}-roadmap-review.md；按 Task agent 选择规则启动独立审查（Paseo subagent 优先，否则原生 Codex/Claude Task/Agent），主 agent 等待结果、事实核验并合并定级。触发：用户说"review 这个 roadmap"、"roadmap 人审前先独立审查"、"跑 cs-roadmap-review"、"规划审查"。
|
||||
description: Roadmap review gate。触发：人审前审 roadmap/items，或用户要求规划审查。
|
||||
---
|
||||
|
||||
# cs-roadmap-review
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
本阶段是 roadmap 交给用户人工确认前的规划审查 gate。它只读 roadmap、items、相关文档和必要代码事实，只写 `{slug}-roadmap-review.md`，不直接改 roadmap、不替用户批准 roadmap、不推进 feature design。
|
||||
|
||||
@@ -30,7 +30,7 @@ description: roadmap 人工确认前的规划审查 gate。对照 roadmap 主文
|
||||
- 相关 compound 沉淀：用项目搜索工具按大需求关键词检索 decision / learning / explore / trick
|
||||
- items.yaml 中已存在 `feature` 字段的 feature design / acceptance（update 模式或复审时）
|
||||
- roadmap 中接口契约或模块拆分引用到的关键代码位置
|
||||
- 独立 Task agent reviewer 输出（如果本轮启用了 Paseo 或其他 reviewer）
|
||||
- 独立 Task agent reviewer 输出（如果本轮已启动）
|
||||
|
||||
没有代码引用时不强行扫全仓库；但 roadmap 声称复用现有模块、接口、命令、配置或数据结构时，必须读对应代码或文档事实核验。
|
||||
|
||||
@@ -51,13 +51,17 @@ description: roadmap 人工确认前的规划审查 gate。对照 roadmap 主文
|
||||
|
||||
## 独立 Task agent reviewer 增强项
|
||||
|
||||
本阶段默认由当前 agent 做本地规划审查；独立 Task agent reviewer 是增强项，不是硬依赖。检测不到 Task agent、provider 未配置或用户明确要求快速完成时，可以继续本地 review，并在报告里记录 `Independent reviewer: local-only` / `skipped-by-user`。
|
||||
本阶段默认由当前 agent 做本地规划审查；独立 Task agent reviewer 是增强项，不是硬依赖。检测不到 Task agent 能力、provider 未配置或用户明确要求快速完成时，可以继续本地 review，并在报告里记录 `Independent reviewer: local-only` / `skipped-by-user`；若需要用户授权降级，先按 `.codestable/reference/approval-conventions.md` 写 `approval-report.md`，再让用户选择。
|
||||
|
||||
但一旦本轮已经启动独立 Task agent reviewer，它就是本轮 review gate 的输入。主 agent 可以先做本地审查草稿，但不能在 reviewer 返回前定稿 `{slug}-roadmap-review.md`、不能给出 `passed`、不能把 roadmap 交给用户确认。reviewer 卡住、失败、权限阻塞或耗时过长时，只能把本轮标成 `blocked` / `independent-review-pending`，让用户决定继续等待、重试 reviewer，或明确降级为 local-only review。
|
||||
|
||||
**检测由主 agent 在运行时自检自己的工具**，按 `.codestable/reference/execution-conventions.md` 的 Task agent 选择规则启动独立 Task agent reviewer：Paseo subagent 优先，否则用当前宿主的原生 Codex/Claude Task/Agent。都没有则本地 review，记录 `local-only`，并写入 `approval-report.md` 请 owner 授权降级；不要伪装启动。不要无限轮询运行中的 agent；若已启动但未返回，停止在 review gate，记录 pending/blocked，等待通知或用户决定。
|
||||
**检测由主 agent 在运行时自检自己的工具**，不靠脚本猜环境——主 agent 最清楚自己手上有哪些工具。按 Task agent 选择规则启动独立 Task agent reviewer（优先 Paseo subagent，否则当前宿主原生 Codex/Claude Task/Agent）：
|
||||
|
||||
Task agent prompt 必须只给原始材料和边界，不透露本地 review 结论：
|
||||
1. **有 `mcp__paseo__create_agent` 工具**：优先用 Paseo subagent 做只读独立审查（**首选**：能换 provider，做到真正异构审查）。启动前先加载 / 读取 `paseo` skill 的当前说明，并遵守它的规则：读取 `~/.paseo/orchestration-preferences.json`，使用 `providers.audit`，不要硬编码 Claude 或 Codex。不要无限轮询运行中的 agent；如果 reviewer 已启动但结果未返回，停止在 review gate，记录 pending/blocked，等待通知或用户决定。
|
||||
2. **否则有当前宿主原生 Codex/Claude Task/Agent 工具**：用原生 Task agent 做独立上下文审查。如属同类 agent，在报告里记录降级和残余风险。
|
||||
3. **两者都没有**：本地 review，记录 `local-only`，并在需要授权降级时写 `approval-report.md`；不要伪装启动。
|
||||
|
||||
独立 Task agent reviewer prompt 必须只给原始材料和边界，不透露本地 review 结论：
|
||||
|
||||
```text
|
||||
你是 CodeStable roadmap 的独立规划审查 agent。只读，不修改文件，不更新 roadmap/items。
|
||||
@@ -76,7 +80,7 @@ Task agent prompt 必须只给原始材料和边界，不透露本地 review 结
|
||||
不要写 {slug}-roadmap-review.md；只把审查结果回传给主 agent。
|
||||
```
|
||||
|
||||
主 agent 仍是最终审查责任方：必须逐条核验 reviewer 的 finding，去重、定级、合并进 `{slug}-roadmap-review.md`。未经本地事实核验的外部结论只能写 `residual-risk` 或忽略，不能直接升级成 `blocking`。
|
||||
主 agent 仍是最终审查责任方：必须逐条核验独立 Task agent reviewer 的 finding，去重、定级、合并进 `{slug}-roadmap-review.md`。未经本地事实核验的外部结论只能写 `residual-risk` 或忽略，不能直接升级成 `blocking`。
|
||||
|
||||
---
|
||||
|
||||
@@ -94,7 +98,7 @@ Task agent prompt 必须只给原始材料和边界，不透露本地 review 结
|
||||
|
||||
- 记录主 agent 自检结果：`paseo` / `native-agent` / `local-only`。
|
||||
- 没有启动独立 Task agent reviewer 时，记录原因，本地 review 可以定稿。
|
||||
- 启动 Task agent 后，最终 verdict 必须等 reviewer 返回。
|
||||
- 启动 Paseo subagent / 原生 Task agent 后，最终 verdict 必须等 reviewer 返回。
|
||||
- reviewer 返回后逐条做本地事实核验；能用文档 / 代码 / items 证据支撑才合并。
|
||||
- reviewer 失败、权限阻塞、超时或仍在运行时，不要默默降级；报告 `status: blocked`。
|
||||
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
interface:
|
||||
display_name: "CodeStable Roadmap Review"
|
||||
short_description: "Roadmap 人审前的 Task agent 规划审查"
|
||||
default_prompt: "使用 $cs-roadmap-review 在人工确认前审查已起草的 roadmap。"
|
||||
short_description: "Roadmap 人审前 gate"
|
||||
default_prompt: "使用 $cs-roadmap-review 在人工确认前审查已起草的 roadmap；按 Task agent 选择规则处理独立 Task agent reviewer。"
|
||||
|
||||
+3
-3
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs-roadmap
|
||||
description: 把"大到塞不进单个 feature"的需求做成完整事前规划：概设 + 接口契约 + 子 feature 拆解清单，放在 `.codestable/roadmap/{slug}/`。两种模式 new / update。触发：用户说"我想要一个 X 系统"、"帮我把这块需求拆一下"、"开一份 roadmap"，或 feature-design 阶段发现需求太大。
|
||||
description: Roadmap 规划。触发：需求大到需要拆 feature，或用户说拆需求/开 roadmap。
|
||||
---
|
||||
|
||||
# cs-roadmap
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
`.codestable/roadmap/` 是项目的"规划层"——每个子目录承载一块大需求，主文档由三块构成：
|
||||
|
||||
@@ -158,7 +158,7 @@ description: 把"大到塞不进单个 feature"的需求做成完整事前规划
|
||||
|
||||
- `passed`：才能把 roadmap 交给用户 review。
|
||||
- `changes-requested`：按 finding 修 roadmap/items，重新校验并重跑 `cs-roadmap-review`。
|
||||
- `blocked`：补齐输入、等待 independent reviewer，或让用户明确降级 local-only 后重跑。
|
||||
- `blocked`：补齐输入、等待独立 Task agent reviewer，或让用户明确降级 local-only 后重跑。
|
||||
|
||||
### Phase 6：用户 review
|
||||
|
||||
|
||||
+2
-2
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: cs
|
||||
description: CodeStable 工作流根入口，介绍体系全貌并把诉求路由到对应 cs-* 子技能。触发：用户只输入 `cs`、说"介绍一下 codestable"、"该用哪个技能"、"不知道用哪个"，或诉求还很开放未收敛。本技能只做路由不做事。
|
||||
description: CodeStable 路由入口。触发：用户只说 cs/该用哪个 skill/介绍体系，或诉求未收敛。
|
||||
---
|
||||
|
||||
# cs
|
||||
|
||||
## 启动必读
|
||||
|
||||
开始任何判断或动作前，先读取 `.codestable/attention.md`；缺失则视为骨架不完整，提示先补齐或运行 `cs-onboard`，不要回退到外部 AI 入口文件。
|
||||
开始任何判断或动作前，先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。
|
||||
|
||||
`cs` 是 CodeStable 工作流家族的统一入口。用户开口大概率不会指名某个 `cs-xxx`——可能只说"我想加个权限校验"、"这个地方有 bug"、"介绍下 codestable"，甚至只发一个 `cs`。本技能负责接住开放式输入，弄清意图，路由到对的子技能。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user