CtrlK
BlogDocsLog inGet started
Tessl Logo

cs

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

69

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

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.mdlessons/ 由 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。

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

Repository
codestable/CodeStable
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.