/cs
CodeStable 入口。触发:用户调用 cs、想先讨论或对齐、想了解体系、问该用哪个 skill,或带着诉求未选入口。明确行动同轮直转;先讨论的请求收敛后同轮移交。
$ npx -y skills add liuzhengdongfortest/codestable --skill cs --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/cs
Context preview
The summary Claude sees to decide when to auto-load this skill.
CodeStable 入口。触发:用户调用 cs、想先讨论或对齐、想了解体系、问该用哪个 skill,或带着诉求未选入口。明确行动同轮直转;先讨论的请求收敛后同轮移交。
SKILL.md
cs.SKILL.mdname: cs
description: CodeStable 入口。触发:用户调用 cs、想先讨论或对齐、想了解体系、问该用哪个 skill,或带着诉求未选入口。明确行动同轮直转;先讨论的请求收敛后同轮移交。
argument-hint: "[诉求]"
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。
导览与推荐本身不写任何文件。
Read more
name: cs description: CodeStable 入口。触发:用户调用 cs、想先讨论或对齐、想了解体系、问该用哪个 skill,或带着诉求未选入口。明确行动同轮直转;先讨论的请求收敛后同轮移交。 argument-hint: "[诉求]"
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。
导览与推荐本身不写任何文件。
让 AI 编码在长期项目中保持边界、证据和记忆。 CodeStable 是一组面向严肃软件开发的轻量 skill 契约:不编排 Agent 团队,也不为项目建立第二套文档系统。模型在明确边界内行动,用证据证明结果,并把知识放回项目已有归宿。
Other skills on codestable.
- /build-cs-skill
CodeStable skill authoring and evolution protocol. Use when creating, refactoring, simplifying, or reviewing cs-* skills under plugins/codestable/skills or .claude/skills. Produces a thin harness, an explicit context plan, evidence gates, and an optional agent collaboration
Open skill - /eval-cs-skill
CodeStable skill 工程化闭环入口。触发:写/改一个 cs skill、评测 skill 效果、跨 model/agent 量化、优化 skill 提示词、把收敛结论固化回 skill。内部推进 author、eval、optimize、release。
Open skill - /cs-code-review
cs-review 的兼容别名(v1 沿用名)。触发后在当前 agent 中转到 cs-review,不维护独立规则或创建子 agent。
Open skill - /cs-epic
大需求或系统级能力的路线发现、拆解与长程推进。单个功能走 cs-feat,bug 走 cs-issue。
Open skill - /cs-feat
实现新功能或功能改造。不用于纯 bug 修复(cs-issue)、行为等价重构(cs-refactor)、大需求拆解(cs-epic)。
Open skill - /cs-issue
诊断或修复 bug、报错、性能回退或既有行为异常。不用于新功能(cs-feat)或行为等价重构(cs-refactor)。
Open skill

