Development
Plugin
codestable
让 AI 编码在长期项目中保持边界、证据和记忆。 CodeStable 是一组面向严肃软件开发的轻量 skill 契约：不编排 Agent 团队，也不为项目建立第二套文档系统。模型在明确边界内行动，用证据证明结果，并把知识放回项目已有归宿。
Plugin Signal70/100Solid
maintained98
capable52
documented50
adopted65
Install on Claude Code
> /plugin marketplace add liuzhengdongfortest/codestable> /plugin install codestable@codestable
What's inside
Skill(11 skills)
/build-cs-skillCodeStable 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/eval-cs-skillCodeStable skill 工程化闭环入口。触发：写/改一个 cs skill、评测 skill 效果、跨 model/agent 量化、优化 skill 提示词、把收敛结论固化回 skill。内部推进 author、eval、optimize、release。/cs-code-reviewcs-review 的兼容别名（v1 沿用名）。触发后在当前 agent 中转到 cs-review，不维护独立规则或创建子 agent。/cs-epic大需求或系统级能力的路线发现、拆解与长程推进。单个功能走 cs-feat，bug 走 cs-issue。/cs-feat实现新功能或功能改造。不用于纯 bug 修复（cs-issue）、行为等价重构（cs-refactor）、大需求拆解（cs-epic）。/cs-issue诊断或修复 bug、报错、性能回退或既有行为异常。不用于新功能（cs-feat）或行为等价重构（cs-refactor）。
README
CodeStable
English · 中文
让 AI 编码在长期项目中保持边界、证据和记忆。
CodeStable 是一组面向严肃软件开发的轻量 skill 契约：不编排 Agent 团队，也不为项目建立第二套文档系统。模型在明确边界内行动，用证据证明结果，并把知识放回项目已有归宿。
30 秒运行模型
用户诉求
↓
cs：直接执行 / 当前会话讨论 / 给出建议
↓
feat · issue · refactor · epic
↓
相称的验证 + 必要的 review / owner gate
↓ 代码结果 + 项目已有的 canonical knowledge
团队使用时，可以按职责组合：
- 稳定编码：使用 CodeStable 明确任务边界、保障、证据和项目记忆；
- 团队上下文共享：推荐使用 Threadshare，把 Codex、Claude Code 等 Agent 会话转换成只读链接，供团队成员和后续 Agent 阅读、交接；
- 多 Agent 编码协同：推荐使用 cs-agent，在编码过程中统一创建、 调用和管理 Codex、Claude 等子 Agent，也可承担异构独立 review。
三者互补：CodeStable 不负责发布会话或编排 Agent，Threadshare 和 cs-agent 也不替代 CodeStable 的工程契约。
你只需要告诉 cs 想完成什么：
- 需求清楚时：它直接开始，并用足够的验证交付结果；
- 遇到具体风险时：它只增加与风险对应的确认、测试或 review，不自动启用整套流程；
- 你想先讨论时：它先和你对齐目标、术语和边界；未经明确授权，不会修改代码；
- 名词可能影响理解时：它先对齐含义，形成当前任务的共享语言；没有歧义时，直接沿用项目已有说法。
纯讨论、咨询和体系导览默认不写项目文件。还没讨论清楚的内容，CodeStable 不会专门保存，也不保证下次会话自动恢复。
5 分钟开始
安装
Codex plugin marketplace：
codex plugin marketplace add codestable/CodeStable
codex plugin add codestable@codestable
Claude plugin marketplace：
/plugin marketplace add codestable/CodeStable
/plugin install codestable@codestable
skills CLI（v1 用户须先按升级指南精确删除 24 个退役入口，再安装 v2）：
npx skills@latest add codestable/CodeStable/plugins/codestable
如果 marketplace catalog 没有发现插件实体，可改用 npx skills@latest add codestable/CodeStable/plugins/codestable --full-depth 深度扫描。
接入项目
在仓库根目录运行 /cs-onboard。它只创建最小项目记忆骨架，不接管项目文档结构、worktree 或 branch 策略。
开始工作
不知道该用哪个入口时调用 /cs；也可以直接调用 owning skill。v2 交付 8 个 skill：
| Skill | 用途 |
|---|---|
cs | 路由明确行动、会话内讨论、咨询与体系导览 |
cs-onboard | 为仓库创建最小项目记忆骨架 |
cs-feat | 实现新功能或改变既有行为 |
cs-issue | 诊断问题；获授权后用红到绿证据修复 |
cs-refactor | 在行为等价证据下调整结构或性能 |
cs-epic | 拆解并按已确认策略推进多个可交付子项 |
cs-review | 只读叶子执行器；单轮审查，不创建子 agent |
cs-keep | 管理有证据的项目事实、lesson 生命周期与 canonical 归宿 |
cs-code-review 是 cs-review 的兼容别名，只转发，不包含独立规则。
三个核心原则
1. thin harness, thick context
CodeStable 给强模型写责任，不写逐步脚本。skill 只约束目标、硬边界和完成证据；模型结合仓库事实选择路径，工程参考按需加载。
薄不等于没有门槛，而是不使用常驻状态机和阶段产物微操模型。
2. 证据先于结论
功能实现需要与风险相称的设计和验证；bug 修复先红后绿；重构先建立行为等价证据。独立审查由外层流程创建只读 reviewer。
人在产品契约变化、重大风险或整体接受时进入，不在每个机械步骤上重复确认。
3. 一个事实，一个 canonical owner
项目文档、ADR、代码和既有领域文档继续拥有原有事实。CodeStable 不复制平行档案，只补充少量会话事实、经验和活动游标。
稳定结论由 owning skill 放回唯一归宿；没有归宿时先请 owner 选择。
项目记忆
/cs-onboard 创建：
.codestable/
├── attention.md
├── lessons/
└── work/
attention.md保存每次会话都需要的少量项目事实，最多 25 条。lessons/一条经验一个文件，按 observed / validated / retired 演化，并在写入前查重合并。work/只服务活动中的跨会话任务、多人交接或明确要求的持久记录。
CodeStable 边做边识别晶化时刻：任务中静默观察，普通收尾最多给一条有证据的候选。
能机械化的错误优先进入测试或 checker。新 lesson 仍需明确授权，后续会话核实后再验证或退役。
普通任务不生成 CodeStable 阶段文档。diff、测试输出和交付说明就是证据。会话内讨论不进入 work/；只有稳定、值得复用的结论才由 owning skill 毕业到 canonical 归宿。
Epic 的双层模型
大型需求把长期契约和临时执行状态分开。永久 Epic 文档保存目标、范围、验收、已批准子项、关键决策与最终交付。
当路线尚不清晰时，永久 Epic 文档本身就是路线地图，决策依赖派生 frontier。
agent 解决事实，真正的产品判断与取舍进入 HITL。路线清晰、可审查、可执行后，才进入既有 design review、owner 确认与执行。
临时 work 游标只保存永久文档指针、批准 revision、执行进度、策略与证据。
Epic 优先沿用项目已有的 Epic、RFC 或 initiative 归宿；没有时才按需创建 .codestable/epics/。执行结束后删除临时游标，永久文档保留。
完整 owner gate、恢复与终态规则见 WORKFLOW.md。
适用边界
CodeStable 更适合：
- 会持续迭代数月或数年的软件项目；
- 需要让不同会话、模型或开发者准确召回历史约束；
- 希望 AI 高效执行，同时由人掌握产品边界和最终接受；
- 重视可验证结果、独立审查和知识复用的团队。
它不是：
- 多 Agent 团队编排器或自动接力平台；
- 强制所有任务经过同一流水线的流程引擎；
- 替代项目现有文档、ADR、issue 或 PR 的第二套系统；
- 面向一次性原型、且完全不关心长期维护的必要依赖。
CodeStable 可以与 Agent 编排工具共存。它负责软件任务的边界、证据和记忆，不接管宿主如何组织 Agent。
需要多 Agent 协作，或需要在 CodeStable 流程中由异构 Agent 承担独立 review 时，推荐配合 cs-agent 使用。
深入文档
MIT License · 作者 @liuzhengdong、@dafang、Codex、Claude
File tree
liuzhengdongfortest/codestableView on GitHub
.agents/
plugins/
marketplace.json
.claude/
.claude-plugin/
marketplace.json
skills/
build-cs-skill/
agents/
openai.yaml
references/
cs-skill-fixture-patterns.md
cs-skill-quality-gates.md
cs-skill-spec-standard.md
SKILL.md
eval-cs-skill/
references/
author/
protocol.md
autonomy/
protocol.md
eval/
protocol.md
optimize/
protocol.md
support/
hypotheses-template.md
iteration-template.md
release/
protocol.md
scripts/
_model.py
adapt_extracted_skill.py
buildprompt.py
bump_version.py
calibrate_judge.py
config.py
e2e_env.py
enqueue_experiment.py
fixtures.py
harness/
__init__.py
adapter_api.py
adapter_claude.py
adapter_codex.py
adapter_paseo.py
base.py
mock_weak.py
mock.py
metrics.py
optimize.py
probe_targets.py
promote_feedback_fixture.py
regression.py
runner.py
scorers/
__init__.py
base.py
dod_gate.py
e2e_outcome.py
learning_transfer.py
llm_judge.py
planted_defect.py
recall_judge.py
routing_decision.py
sequence.py
SKILL.md
tests/
conftest.py
test_cs_learning_transfer_oracle.py
test_cs_learning_transfer_sequence.py
test_cs_skill_convergence.py
test_cs_skill_eval_harness.py
test_cs_skill_eval.py
test_cs_skill_release.py
test_cs_skill_selfref.py
.codestable/
.gitignore
attention.md
audits/
.gitkeep
brainstorms/
.gitkeep
compound/
.gitkeep
epics/
cs-continuous-learning-lifecycle.md
v2-project-knowledge-lifecycle.md
features/
.gitkeep
2026-07-01-plugin-market-distribution/
approval-report.md
plugin-market-distribution-acceptance.md
plugin-market-distribution-checklist.yaml
plugin-market-distribution-design-review.md
plugin-market-distribution-design.md
plugin-market-distribution-qa.md
plugin-market-distribution-review.md
2026-07-10-cs-feedback-evidence-pipeline/
approval-report.md
cs-feedback-evidence-pipeline-acceptance.md
cs-feedback-evidence-pipeline-checklist.yaml
cs-feedback-evidence-pipeline-design-review.md
cs-feedback-evidence-pipeline-design.md
cs-feedback-evidence-pipeline-dod-results.json
cs-feedback-evidence-pipeline-evidence-pack-results.json
cs-feedback-evidence-pipeline-evidence-pack.md
cs-feedback-evidence-pipeline-gate-results.json
cs-feedback-evidence-pipeline-implementation-review-fixes.md
cs-feedback-evidence-pipeline-implementation.md
cs-feedback-evidence-pipeline-qa.md
cs-feedback-evidence-pipeline-review-history.md
cs-feedback-evidence-pipeline-review.md
goal-plan.md
goal-protocol.md
goal-state.yaml
2026-07-10-cs-router-direct-dispatch/
cs-router-direct-dispatch-acceptance.md
cs-router-direct-dispatch-checklist.yaml
cs-router-direct-dispatch-design-review.md
cs-router-direct-dispatch-design.md
cs-router-direct-dispatch-implementation.md
cs-router-direct-dispatch-qa.md
cs-router-direct-dispatch-review.md
goal-plan.md
goal-protocol.md
goal-state.yaml
feedback/
.gitkeep
gates/
roadmap-goal-gates.yaml
goals/
.gitkeep
2026-07-14-fix-skills-update-and-standalone-version/
functional-acceptance.md
goal.md
iterations/
001.md
002.md
state.yaml
hooks/
hooks.codex.json
issues/
.gitkeep
2026-07-03-task-agent-lifecycle-cleanup/
task-agent-lifecycle-cleanup-analysis.md
task-agent-lifecycle-cleanup-fix-note.md
task-agent-lifecycle-cleanup-report.md
task-agent-lifecycle-cleanup-review.md
2026-07-13-risk-tiered-short-flow/
risk-tiered-short-flow-analysis.md
risk-tiered-short-flow-fix-note.md
risk-tiered-short-flow-report.md
risk-tiered-short-flow-review.md
2026-07-14-skills-update-removes-cs-skills/
skills-update-removes-cs-skills-analysis.md
skills-update-removes-cs-skills-fix-note.md
skills-update-removes-cs-skills-report.md
skills-update-removes-cs-skills-review.md
2026-07-14-standalone-runtime-version-unknown/
standalone-runtime-version-unknown-analysis.md
standalone-runtime-version-unknown-fix-note.md
standalone-runtime-version-unknown-report.md
standalone-runtime-version-unknown-review.md
2026-07-15-cs-skills-release-contract-hardening/
cs-skills-release-contract-hardening-analysis.md
cs-skills-release-contract-hardening-fix-note.md
cs-skills-release-contract-hardening-report.md
cs-skills-release-contract-hardening-review.md
2026-07-16-epic-goal-dispatch-authorization-regression/
approval-report.md
epic-goal-dispatch-authorization-regression-analysis.md
epic-goal-dispatch-authorization-regression-fix-note.md
epic-goal-dispatch-authorization-regression-report.md
epic-goal-dispatch-authorization-regression-review.md
refactors/
.gitkeep
2026-07-01-skill-entry-simplification/
skill-entry-simplification-checklist.yaml
skill-entry-simplification-dogfood-report.md
skill-entry-simplification-paseo-agent-verification.md
skill-entry-simplification-refactor-design.md
skill-entry-simplification-review.md
skill-entry-simplification-workflow-test-report.md
reference/
agent-conventions.md
approval-conventions.md
branch-guard-hooks.md
code-dimensions.md
execution-conventions.md
goal-conventions.md
maintainer-notes.md
requirement-example.md
shared-conventions.md
solution-depth-conventions.md
spec-governance-tools.md
system-overview.md
tools-context.md
tools.md
worktree-conventions.md
requirements/
.gitkeep
feedback-evidence-pipeline.md
plugin-market-distribution.md
VISION.md
roadmap/
.gitkeep
runtime-manifest.json
tools/
build-context-packet.py
build-review-packet.py
check-context-sufficiency.py
codestable_common.py
codestable_gate_common.py
codestable_runtime.py
codestable-ai-branch-guard.py
codestable-backlog.py
codestable-doctor.py
codestable-dod-contract-gate.py
codestable-dod-runner.py
codestable-evidence-pack.py
codestable-finish-worktree.py
codestable-goal-consistency-gate.py
codestable-implementation-gate.sh
codestable-main-publish.py
codestable-runtime-sync.py
codestable-scope-gate.py
codestable-spec-governance.py
codestable-workflow-next.py
codestable-worktree-gate.py
codestable-worktree-inbox.py
plan-commits.py
search-yaml.py
validate-implementation-review.py
validate-yaml.py
work/
epic-cs-continuous-learning-lifecycle.md
.gitignore
AGENTS.md
asset/
2026-04-25-deepseek-thinking-provider/
deepseek-thinking-provider-brainstorm.md
deepseek-thinking-provider-checklist.yaml
deepseek-thinking-provider-contracts.md
deepseek-thinking-provider-design.md
deepseek-thinking-provider-implementation.md
CodeStableVSAgent.png
CodeStabvle.png
programming-paradigm-extensions.md
programming-paradigm-practices.md
programming-paradigm.md
PromotionalImage.png
CHANGELOG.md
CLAUDE.md
CNAME
docs/
adr/
001-skill-global-tool-runtime.md
002-codestable-does-not-own-worktree-strategy.md
003-cs-skill-evaluation-loop.md
004-project-knowledge-not-runtime-distribution.md
005-project-knowledge-and-epic-lifecycle.md
006-project-learning-lifecycle.md
007-minimum-sufficient-assurance.md
008-shared-language-before-design-execution.md
cs-skill-e2e-eval-plan.md
why-codestable.en.md
why-codestable.md
experiments/
cs-code-review-001/
calibration.md
config.json
fixtures/
planted-defect/
pd-001.json
pd-002.json
pd-003.json
pd-004.json
pd-005.json
pd-006.json
pd-007.json
pd-008.json
pd-009.json
pd-010.json
pd-011.json
pd-012.json
pd-013.json
sanity/
sn-001.json
sn-002.json
hypotheses.md
results.md
cs-epic-001/
config.json
fixtures/
planted-defect/
epic-001.json
epic-002.json
epic-003.json
epic-004.json
epic-005.json
epic-006.json
epic-007.json
epic-008.json
hypotheses.md
results.md
cs-epic-e2e-001/
config.json
fixtures/
planning/
e01.json
e02.json
e03.json
hypotheses.md
results.md
variants/
bare.md
cs-epic-e2e-002/
analyze.py
config.json
hypotheses.md
results.md
run_review_loop.py
cs-epic-routing-001/
config.json
fixtures/
routing/
rt-p01.json
rt-p02.json
rt-p03.json
rt-p04.json
rt-p05.json
rt-p06.json
rt-p07.json
rt-p08.json
rt-p09.json
rt-p10.json
rt-p11.json
rt-p12.json
rt-p13.json
rt-p14.json
results.md
variants/
hardened.md
original.md
cs-feat-001/
config.json
fixtures/
planted-defect/
feat-001.json
feat-002.json
feat-003.json
feat-004.json
feat-005.json
feat-006.json
feat-007.json
feat-008.json
hypotheses.md
results.md
cs-feat-e2e-001/
config.json
fixtures/
e2e/
f01.json
f02.json
f03.json
hidden/
f01/
test_f01_explicit.py
test_f01_implicit.py
f02/
test_f02_explicit.py
test_f02_implicit.py
f03/
test_f03_explicit.py
test_f03_implicit.py
hypotheses.md
README.md
results.md
variants/
bare.md
cs-feat-refactor-ab-001/
config.json
fixtures/
planted-defect/
feat-001.json
feat-002.json
feat-003.json
feat-004.json
feat-005.json
feat-006.json
feat-007.json
feat-008.json
hypotheses.md
README.md
results.md
variants/
original.md
cs-feat-routing-001/
config.json
... 321 moreFAQ
codestable is a Claude Code plugin with 11 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes build-cs-skill, eval-cs-skill, cs-code-review. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is codestable?
- 让 AI 编码在长期项目中保持边界、证据和记忆。 CodeStable 是一组面向严肃软件开发的轻量 skill 契约：不编排 Agent 团队，也不为项目建立第二套文档系统。模型在明确边界内行动，用证据证明结果，并把知识放回项目已有归宿。
- How do I install codestable?
- Run these in Claude Code: /plugin marketplace add liuzhengdongfortest/codestable then /plugin install codestable@codestable. Then prompt normally.
- Does codestable auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is codestable free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.