English · 中文

面向严肃工程的 AI 编码工作流

厌倦了 OpenSpec 的草台、Oh-My-OpenAgent 的过度设计、Superpowers 的散装——我从 0 写了一套简单轻巧、围绕人在环的 AI Harness。

Status Skills License

安装

npx skills add https://github.com/liuzhengdongfortest/CodeStable

/cs-onboard

/cs

缘起

与其他框架的核心区别:编排的目标是谁

设计:6 个实体 + 3 个流程

6 个实体

3 个流程

技能总览

工作流示意

═══════════════════════════════════════════════════════════════════════
 根入口 · 路由 (任何时刻都可以调用)
───────────────────────────────────────────────────────────────────────
 cs ──▶ 介绍体系 / 把开放式诉求路由到下面任一具体子技能
 (本身不做事,只做分诊和提示)
═══════════════════════════════════════════════════════════════════════
 │
 ┌───────────────┼───────────────┐
 ▼ ▼ ▼
 (未接入) (已接入) (想了解体系)
 走阶段 0 直达 1~4 层 / 横切 给速读
 │
 ▼
═══════════════════════════════════════════════════════════════════════
 阶段 0 · 接入 (只在新项目跑一次)
───────────────────────────────────────────────────────────────────────
 cs-onboard ──▶ 生成 codestable/ 骨架 + 释放 reference/、tools/
═══════════════════════════════════════════════════════════════════════
 │
 ▼
═══════════════════════════════════════════════════════════════════════
 第 1 层 · 长效档案("系统现在长什么样",只记现状)
───────────────────────────────────────────────────────────────────────
 cs-req ──▶ codestable/requirements/{slug}.md
 cs-arch ──▶ codestable/architecture/ARCHITECTURE.md
 └─ {type}-{slug}.md(子系统)
═══════════════════════════════════════════════════════════════════════
 │
 ▼
═══════════════════════════════════════════════════════════════════════
 第 2 层 · 规划("接下来打算怎么做这块大需求",大需求才需要)
───────────────────────────────────────────────────────────────────────
 cs-roadmap ──▶ codestable/roadmap/{slug}/
 把一个"我想要 X 系统"做成完整的事前规划:
 1 概设 —— 拆成哪几个模块 / 组件
 2 架构层详设 —— 模块间接口契约 / 共享协议
 3 子 feature —— 把方案分解成多条可执行的 feature
 2 是 feature-design 的硬约束输入
 (小需求可跳过本层,直接进第 3 层)
═══════════════════════════════════════════════════════════════════════
 │
 ▼
═══════════════════════════════════════════════════════════════════════
 讨论入口(可选 · 想法模糊时进入,做分诊后路由到下游)
───────────────────────────────────────────────────────────────────────
 ┌── case 1 已经够清楚 ──▶ cs-feat-design
 cs-brainstorm ────────▶┼── case 2 小需求方向定 ─▶ feature 流(落 brainstorm.md)
 └── case 3 大需求只有一个词 ─▶ cs-roadmap
═══════════════════════════════════════════════════════════════════════
 │
 ▼
═══════════════════════════════════════════════════════════════════════
 第 3 层 · 执行流程(按事件类型选一条进入)
───────────────────────────────────────────────────────────────────────
 ▸ 事件:新增能力 ┌──────────┐
 cs-feat-design ──▶ cs-feat-impl ──▶ cs-feat-accept │ features │
 cs-feat-ff ──(轻量直通车,跳过 design/accept)─▶ │ /YYYY-.../ │
 └──────────┘
 ▸ 事件:修复缺陷 ┌──────────┐
 cs-issue-report ──▶ cs-issue-analyze ──▶ cs-issue-fix│ issues │
 │ /YYYY-.../ │
 └──────────┘
 ▸ 事件:代码腐化(beta) ┌──────────┐
 cs-refactor / cs-refactor-ff │refactors │
 │ /YYYY-.../ │
 └──────────┘
═══════════════════════════════════════════════════════════════════════
 │
 ▼ 任意阶段觉得"这个值得记下来"都能触发 ▼
═══════════════════════════════════════════════════════════════════════
 横切层 · 知识沉淀(复利工程)
───────────────────────────────────────────────────────────────────────
 cs-learn ──▶ ┐
 cs-trick ──▶ ├─▶ codestable/compound/YYYY-MM-DD-{doc_type}-{slug}.md
 cs-decide ──▶ │ doc_type ∈ { learning, trick, decision, explore }
 cs-explore ──▶ ┘
 ↑
 下一次 cs-arch / cs-feat-design / cs-issue-analyze
 会回头读 compound/,让经验在新工作里被复用
═══════════════════════════════════════════════════════════════════════

运行时结构

你的项目/
├── codestable/
│ ├── requirements/ # 需求实体("为什么要有这个能力")
│ │ └── {slug}.md # 一个能力一份,扁平不分组
│ │
│ ├── architecture/ # 架构实体("用什么结构实现")
│ │ ├── ARCHITECTURE.md # 架构总入口 / 索引
│ │ └── {type}-{slug}.md # 子系统架构 doc(同类 ≥6 份自动收进子目录)
│ │
│ ├── roadmap/ # 路线图("接下来打算怎么走")
│ │ └── {slug}/
│ │ ├── {slug}-roadmap.md # 主文档:背景 / 拆解 / 排期
│ │ ├── {slug}-items.yaml # 机器可读子 feature 清单,acceptance 回写状态
│ │ └── drafts/ # 可选:草稿 / 调研
│ │
│ ├── features/ # 特性流程聚合根
│ │ └── YYYY-MM-DD-{slug}/ # 一个 feature 一个目录
│ │ ├── {slug}-brainstorm.md # 可选(cs-brainstorm 产出)
│ │ ├── {slug}-design.md # 方案(cs-feat-design)
│ │ ├── {slug}-checklist.yaml # 推进清单(impl 跑、accept 回写)
│ │ └── {slug}-acceptance.md # 验收报告(cs-feat-accept)
│ │
│ ├── issues/ # 问题流程聚合根
│ │ └── YYYY-MM-DD-{slug}/
│ │ ├── {slug}-report.md # 问题报告
│ │ ├── {slug}-analysis.md # 根因分析(不显然时才有)
│ │ └── {slug}-fix-note.md # 修复记录
│ │
│ ├── refactors/ # 重构流程聚合根(beta)
│ │ └── YYYY-MM-DD-{slug}/
│ │ ├── {slug}-scan.md
│ │ ├── {slug}-refactor-design.md
│ │ ├── {slug}-checklist.yaml
│ │ └── {slug}-apply-notes.md
│ │
│ ├── compound/ # 知识沉淀(复利工程)统一目录
│ │ └── YYYY-MM-DD-{doc_type}-{slug}.md
│ │ # doc_type ∈ {learning, trick, decision, explore}
│ │
│ ├── tools/ # 跨工作流共享脚本(onboard 释放)
│ └── reference/ # 共享参考文档(onboard 释放)
│ ├── shared-conventions.md # 跨技能口径 / 路径命名 / 元数据规范
│ ├── system-overview.md # CodeStable 体系总览 + 场景路由
│ └── ...
│
└── AGENTS.md # 在项目根,不在 codestable/ 里

硬约束

设计哲学

Roadmap

Star History

MIT License · 作者 @liuzhengdong