cs

v2026.09.24

CodeStable 入口。触发:用户调用 cs、想先讨论或对齐、想了解体系、问该用哪个 skill,或带着诉求未选入口。明确行动同轮直转;先讨论的请求收敛后同轮移交。

GitHub
Install command
npx skhub add codestable/cs
Markdown
SKILL.md

cs

判断用户此刻要执行、先讨论、咨询还是了解体系。明确行动默认直接执行,不先加讨论 gate。 任务类型只决定工程方法,实际风险决定保障强度;cs 只选择 owning skill,不预选流程强度,直接 调用 owning skill 时得到同一语义。

判别与行为

用户输入行为
明确行动诉求(修这个 bug、排查这个报错为什么发生、实现 X、重构 Y、审一下、记住这个…)同轮直转:报一句"按 cs-xxx 处理:{一句理由}",随即在当前回合按该 skill 的纪律继续执行,不要求用户重新调用或再次确认
用户显式要求先讨论,或调查仓库事实后仍无法安全判断行动类型 / owning skill,且产品决策会实质改变建档或改代码路径在当前会话对齐;用户没有要求先讨论且 owning skill 已可判定时,直接转入,不在入口层细化目标或验收
咨询(该用哪个 / 流程怎么走 / 你建议怎么做)只推荐入口并说明理由,不启动执行
只说 cs、想了解体系、无具体诉求输出体系速读
诉求含糊但一个分类问题即可判断先调查可核实事实,只问一个聚焦问题,不默认重流程

会话内讨论与 handoff

  • Execute 默认优先级最高;明确行动仍同轮直转。用户显式要求先讨论时才覆盖该默认;owning skill 已可判定时,目标与验收细化留给该 skill。
  • 讨论只存在于当前会话。仓库可核实的事实由 agent 自行调查;一次只问一个真正需要 owner 决定的问题,给出建议与理由,并用精确术语、具体场景和边界案例检验理解。共享语言只在歧义会改变目标、行为、归属、契约或验收时收敛;已有单义术语不增加提问或产物。
  • handoff-ready 时形成内存 packet:目标入口、原始诉求、目标或期望行为、范围、非目标、验收口径、已核实仓库事实及来源、owner 已确认的术语与决策、未决风险、canonical 资产指针或资产候选。
  • 已有执行授权时同轮移交给三个已确认出口 cs-feat / cs-issue / cs-epic,不再询问“是否继续”;只授权讨论时返回已确认结论,并推荐由 cs-keep 或对应 owning skill 完成资产毕业。
  • 讨论过程本身不产生授权;handoff 不扩大实现、commit、发布或写入授权,也不替代目标 skill 的硬门槛。收敛到其他入口时按既有 Execute / Advise 规则处理,不附带 handoff 的不重复确认契约。
  • 不创建 .codestable/work/discussion-*、transcript 或新状态;未收敛讨论不跨会话恢复,原始问答、未决讨论和候选分支不落盘。
  • 稳定术语交给项目已有 canonical 术语归宿;难逆转、缺少上下文会令人意外且源于真实取舍的决定才进入 ADR;任务契约、永久 Epic 文档、attention.md 与 lessons/ 由 owning skill 按各自规则毕业。

入口表

诉求入口
新功能、功能改造cs-feat
排查、诊断、bug、报错、性能回退、行为异常cs-issue
行为等价的重构、主动性能优化cs-refactor
审查 diff 或按需审计代码cs-review
大需求拆解与长程推进cs-epic
沉淀经验、教训、"记住这个"cs-keep
仓库接入 / v1 升级cs-onboard

大而路线仍不清晰时也只交给 cs-epic;是否需要批准前路线发现由 cs-epic 根据路线级迷雾判断, cs 不创建地图、issue 或平行设计状态。

一次只转一个入口;用户同时给出两个独立诉求时,问先做哪个。转入不扩大授权:目标 skill 的硬门槛、checkpoint 与写入规则照常生效。

体系速读

CodeStable 是一层薄研发纪律加一个项目记忆闭环。项目记忆在 .codestable/:attention.md(每次必读)、lessons/(按关键词检索的经验)、work/(活动中的跨会话任务)。普通任务零产物,证据是 diff 与测试。

Epic 采用职责互斥的双层文档:永久 Epic 上下文优先沿用项目已有 Epic / RFC / initiative 归宿,否则首次使用时按需创建 .codestable/epics/;临时 .codestable/work/epic-{slug}.md 只保存执行游标,完成后清理。cs-goal 中有价值的目标契约、恢复、人工门槛和终态验收已并入 cs-epic,但不恢复 cs-goal 入口、goal package、state.yaml、逐轮 iteration 报告或 runtime gate。

v1 的 24 个旧入口(cs-feat-design、cs-goal、cs-audit、cs-note、cs-feedback、cs-roadmap 系等)已并入 上表:设计与需求澄清是按风险或 Epic 契约触发的可用保障,审计是 cs-review 的模式,沉淀统一走 cs-keep。

导览与推荐本身不写任何文件。

Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

Not specified

Source path

plugins/codestable/skills/cs

Default branch

main

Latest commit

19c796d

Tree SHA

6272d8c