mirror of
https://github.com/codestable/CodeStable.git
synced 2026-09-19 09:03:09 +08:00
dafang
9efc569a61
The skill has outgrown its name — it reviews designs and runs repo audits, not only code. cs-review is the canonical entry; cs-code-review ships as the one thin forwarding alias (the explicit exception to the no-shim rule, kept for the carried-over v1 habit). References in cs / cs-feat / cs-epic / cs-issue / cs-refactor, the Codex agent config, both contract-test skill sets (V2_SKILLS + SHIM_SKILLS), and all public docs / CHANGELOG / ADR-004 updated. Also refreshed the leftover v1 openai.yaml wording. 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2.5 KiB
2.5 KiB
CodeStable v2 工作流与项目结构
工作流
CodeStable v2 是 8 个独立安装的 thin-harness skill，加一个项目记忆闭环。cs 判别用户
此刻要什么：明确行动诉求同轮直转对应 skill 并继续执行；咨询只给推荐；无诉求时介绍体系。
不确定入口 -> cs
仓库接入 / v1 升级 -> cs-onboard
新功能 -> cs-feat ---------\
bug / 行为异常 -> cs-issue ----------> cs-review（高风险或按需）
行为等价重构 -> cs-refactor ------/
大需求拆解 -> cs-epic -> cs-feat / cs-issue / cs-refactor
经验与项目记忆 -> cs-keep
执行强度与风险相称：
cs-feat默认直接理解、实现、验证；公开契约、数据、权限、并发或真实方案取舍先经用户确认。cs-issue先建立能明确变红的验证，再修复并证明它变绿。cs-refactor先建立等价性证据，分步改动并持续保持验证为绿。cs-epic用一个 work 文档维护子项、依赖和验收；拆解与边界变更由用户确认。cs-review是只读独立审查，也承接模块或全仓 audit。cs-keep把高频事实压进 attention，把可复用经验写成 lesson。
普通任务不生成阶段文档。diff、测试输出和交付说明就是证据；只有跨会话、多人交接或用户 要求留痕时，才维护一个 work 文档，完成后删除或按用户要求保留。
项目记忆
/cs-onboard 为新项目创建最小骨架：
.codestable/
├── attention.md # 每次会话需要的少量项目事实，最多 25 条
├── lessons/ # 一条经验一个 Markdown 文件，按关键词检索
└── work/ # 活动中的跨会话任务，完成即清
skill 专属 context 与 helper 分别由 owning skill 的 references/ 和 scripts/ 提供。项目
事实放在上述目录或项目既有文档与 ADR 中。skill 不读取 sibling skill 文件，也不依赖集中式
onboard runtime；worktree、branch 和 agent backend 策略由宿主或 owner 决定。
v1 升级边界
v2 不迁移或清理 v1 项目的历史目录。已有 requirements/、roadmap/、features/、
issues/、compound/、tool、gate、hook 和 manifest 原样保留；新 skill 可以按任务关键词
检索其中的项目知识，但不会执行旧 runtime，也不会继续生成 v1 阶段产物。
v1.0.4 的 32 个 skill 在 v2 收敛为 8 个；其余 24 个入口已退役且不随 v2 安装。完整映射见 SKILL_CATALOG.md。