mcpField
C
cs

cs

github.com/codestableエージェントワークフロー1.1k1.4k 回インストール10 週間前に更新
リポジトリ

cs について

csは、CodeStableの開発スキル体系を案内するスキルです。実行、議論、相談、体系の確認を見分け、担当スキルへ振り分けます。明確な実行依頼は同じターン内で引き継ぎます。

主な機能

  1. 01依頼の種類と対応方法を判別
  2. 02タスクに適した担当スキルを選択
  3. 03明確な実行依頼を同じターンで引き継ぎ
  4. 04相談では適切な入口のみを推薦
  5. 05CodeStableの記憶とタスク構造を案内

活用シーン

  1. 01バグ調査をcs-issueへ振り分け
  2. 02機能追加の依頼をcs-featへ引き継ぎ
  3. 03進め方の相談で入口を推薦
  4. 04CodeStableのプロジェクト記憶構成を説明

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/codestable/codestable --skill cs

インストール後、Claude Code で/csを入力して読み込まれたか確認します。

詳細

プロジェクトの README より

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。

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

コメント