osiman/git-learn
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
emdash/cuddly-rockets-rhyme-d5jo4
git-learn/knowledge/entries/knowledge_20260519_CodeStable/knowledge_20260519_CodeStable.html
T

371 lines
25 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>CodeStable 深度解析 — github-learn</title>
<script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>
<style>
*,*::before,*::after{box-sizing:border-box;margin:0;padding:0}
html{scroll-behavior:smooth}
body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI","Noto Sans SC",Roboto,"Helvetica Neue",sans-serif;background:#f8fafc;color:#1e293b;line-height:1.75;font-size:16px}
.wrapper{max-width:860px;margin:0 auto;padding:0 24px}
.article-header{background:linear-gradient(135deg,#0f172a 0%,#1e3a5f 100%);color:#f1f5f9;padding:64px 0 48px;margin-bottom:48px}
.article-header h1{font-size:2rem;font-weight:700;line-height:1.3;margin-bottom:16px;letter-spacing:-0.02em}
.article-header .meta{display:flex;gap:16px;flex-wrap:wrap;font-size:.875rem;color:#94a3b8}
.article-header .tags{display:flex;gap:8px;flex-wrap:wrap;margin-top:12px}
.article-header .tag{background:rgba(255,255,255,0.1);border:1px solid rgba(255,255,255,0.2);padding:2px 10px;border-radius:12px;font-size:.75rem;color:#cbd5e1}
.module{margin-bottom:48px}
.module-title{font-size:1.35rem;font-weight:700;color:#0f172a;padding-bottom:8px;border-bottom:3px solid #3b82f6;margin-bottom:24px;display:flex;align-items:center;gap:8px}
.tldr-box{background:linear-gradient(135deg,#eff6ff,#dbeafe);border-left:4px solid #3b82f6;border-radius:8px;padding:24px;margin-bottom:32px}
.tldr-box .core{font-size:1.1rem;font-weight:600;margin-bottom:12px}
.tldr-box .hook{background:#fff;border:1px dashed #93c5fd;border-radius:6px;padding:12px 16px;margin-bottom:12px;font-size:.95rem}
.tldr-box .anchor{font-style:italic;color:#475569;font-size:.9rem}
.mnemonic-card{background:#fffbeb;border:2px dashed #f59e0b;border-radius:8px;padding:20px 24px;margin:24px 0;font-family:"Courier New",monospace;font-size:.95rem;line-height:1.8;white-space:pre-wrap}
.mnemonic-card::before{content:"🧠 巧记卡片";display:block;font-family:-apple-system,sans-serif;font-weight:700;color:#b45309;margin-bottom:8px;font-size:.85rem}
.story-box{background:#f1f5f9;border-radius:8px;padding:20px 24px;margin:24px 0;border-left:3px solid #64748b}
.story-box .story-label{font-size:.8rem;font-weight:700;color:#64748b;text-transform:uppercase;letter-spacing:.05em;margin-bottom:8px}
.ascii-box{background:#0f172a;color:#a5f3fc;border-radius:8px;padding:20px 24px;margin:24px 0;font-family:"Courier New",monospace;font-size:.85rem;line-height:1.6;overflow-x:auto;white-space:pre}
.mermaid-box{background:#fff;border:1px solid #e2e8f0;border-radius:8px;padding:24px;margin:24px 0;text-align:center}
.table-wrap{overflow-x:auto;margin:24px 0}
table{width:100%;border-collapse:collapse;font-size:.9rem}
th{background:#f1f5f9;text-align:left;padding:10px 14px;border-bottom:2px solid #cbd5e1;font-weight:600}
td{padding:10px 14px;border-bottom:1px solid #e2e8f0}
tr:hover td{background:#f8fafc}
.fission-section{background:#fef2f2;border-left:4px solid #dc2626;border-radius:8px;padding:24px;margin:32px 0}
.fission-section .fission-title{font-size:1.05rem;font-weight:700;color:#991b1b;margin-bottom:16px}
.fission-section .fission-label{display:inline-block;background:#dc2626;color:#fff;font-size:.7rem;font-weight:700;padding:2px 8px;border-radius:4px;margin-bottom:12px}
.fission-section .search-internal{display:inline-block;background:#f1f5f9;border:1px solid #cbd5e1;font-size:.75rem;padding:2px 8px;border-radius:4px;color:#475569;margin-bottom:12px}
.faq-box{margin:24px 0}
details{border:1px solid #e2e8f0;border-radius:6px;margin-bottom:8px;overflow:hidden;transition:border-color .2s}
details:hover{border-color:#94a3b8}
details[open]{border-color:#3b82f6}
summary{padding:14px 18px;cursor:pointer;font-weight:500;background:#f8fafc;user-select:none}
details[open] summary{border-bottom:1px solid #e2e8f0;background:#eff6ff}
details .faq-body{padding:16px 18px;font-size:.95rem;line-height:1.7}
.quiz-box{counter-reset:quiz;margin:24px 0}
.quiz-item{background:#f8fafc;border:1px solid #e2e8f0;border-radius:6px;padding:14px 18px;margin-bottom:10px;font-size:.95rem;counter-increment:quiz}
.quiz-item::before{content:counter(quiz) ". ";font-weight:700;color:#3b82f6}
pre{background:#0f172a;color:#e2e8f0;border-radius:8px;padding:18px 20px;overflow-x:auto;font-size:.85rem;line-height:1.6;margin:20px 0}
code{font-family:"JetBrains Mono","Fira Code","Consolas",monospace}
p code,li code{background:#f1f5f9;padding:2px 6px;border-radius:4px;font-size:.85em;color:#b91c1c}
p{margin-bottom:16px}
ul,ol{margin-bottom:16px;padding-left:24px}
li{margin-bottom:6px}
h2{font-size:1.25rem;margin:28px 0 12px;color:#0f172a}
h3{font-size:1.1rem;margin:24px 0 10px;color:#1e293b}
h4{font-size:1rem;margin:20px 0 8px;color:#334155}
blockquote{border-left:3px solid #3b82f6;padding:12px 18px;margin:20px 0;background:#f8fafc;border-radius:0 6px 6px 0;color:#475569}
.roi-grid{display:grid;grid-template-columns:1fr 1fr;gap:16px;margin:24px 0}
.roi-card{background:#f0fdf4;border:1px solid #bbf7d0;border-radius:8px;padding:16px}
.roi-card .roi-label{font-size:.75rem;font-weight:700;color:#16a34a;text-transform:uppercase;margin-bottom:4px}
.roi-card .roi-value{font-weight:600;font-size:1rem}
.anti-pattern td:first-child{color:#dc2626}
.anti-pattern td:last-child{color:#16a34a}
.article-footer{text-align:center;padding:32px 0;margin-top:48px;border-top:1px solid #e2e8f0;color:#94a3b8;font-size:.85rem}
#search-input{width:100%;padding:12px 16px;border:2px solid #e2e8f0;border-radius:8px;font-size:.95rem;margin-bottom:32px;outline:none;transition:border-color .2s;font-family:inherit}
#search-input:focus{border-color:#3b82f6}
.hidden{display:none !important}
@media(max-width:640px){.article-header h1{font-size:1.5rem}.roi-grid{grid-template-columns:1fr}.wrapper{padding:0 16px}}
@media print{.article-header{background:#fff !important;color:#000 !important;padding:24px 0}.article-header h1{color:#000}#search-input{display:none}}
</style>
</head>
<body>
<header class="article-header">
<div class="wrapper">
<h1>CodeStable 深度解析：编排软件生命周期，而非编排 Agent</h1>
<div class="meta"><span>叫我小杨同学的小码酱</span><span>2026-05-19</span></div>
<div class="tags">
<span class="tag">CodeStable</span><span class="tag">AI Engineering</span><span class="tag">Agent Skills</span><span class="tag">Harness Engineering</span><span class="tag">Human-in-the-Loop</span><span class="tag">工作流</span>
</div>
</div>
</header>
<div class="wrapper" id="content-area">
<input type="text" id="search-input" placeholder="搜索知识点..." autocomplete="off">
<section class="module">
<h2 class="module-title">📌 核心摘要</h2>
<div class="tldr-box">
<p class="core">CodeStable 是首个将 AI 编码工作流的建模对象从"Agent 怎么协作"翻转为"软件要素怎么组织"的框架——它管的不再是 Agent，而是需求、架构、特性、问题、知识这六个实体的完整生命周期。</p>
<div class="hook"><strong>认知挂钩</strong>：想象你在管一个图书馆。SuperPowers 和 OpenSpec 在优化"管理员怎么工作得更高效"。CodeStable 在问一个更根本的问题——书有没有被正确分类、编目、放在对的书架上？管理员再高效，书是乱的，三年后谁也找不到东西。CodeStable 就是那个图书分类法。</div>
<div class="anchor"><strong>真理锚点</strong>："软件工程的混乱本质上不是 Agent 不够强，而是要素没被组织好。" —— liuzhengdong</div>
</div>
</section>
<section class="module">
<h2 class="module-title">🧊 概念破冰</h2>
<div class="mnemonic-card">AI 框架两派分：
Agent 编排派 → 管的是"谁干什么、怎么配合"
软件要素派 → 管的是"需求架构特性问题知识，每样都放对位置"
CodeStable 选了后者。记住6+3：
6 实体（Req, Arch, Roadmap, Feature, Issue, Compound）
3 流程（特性引入、问题修复、代码重构）</div>
<div class="story-box">
<div class="story-label">📖 故事引入</div>
<p>2026 年初，开发者 liuzhengdong 正在开发一套新的 Harness Agent。一开始他用 VibeCoding——只写设计和需求，代码由 AI 改。这样撑了大部分特性开发。</p>
<p>直到有一天，Codex 反复解决不了一个"他认为比较简单"的问题，<strong>反复在同一个地方犯错</strong>。</p>
<p>他意识到：项目变大了，AI 开始迷失。不是因为 AI 不够聪明，而是因为之前的那些需求、设计决策、架构约束全忘了——这些信息散落在对话历史里，每次都丢失。</p>
<p>他调研了 OpenSpec、SuperPowers、Oh-My-OpenAgent，没一个让他满意。于是从零写了 CodeStable。2026 年 4 月发布，不到两个月，781 stars。</p>
</div>
<div class="ascii-box">Agent 编排派（SuperPowers / OpenSpec / OMO）:
┌─────┐ ┌─────┐ ┌─────┐
│Agent1│←→│Agent2│←→│Agent3│ ← 编排的是 Agent
└─────┘ └─────┘ └─────┘
↓ ↓ ↓
[代码] [代码] [代码] ← 软件要素在对话中丢失
软件要素派（CodeStable）:
┌──────────┐ ┌──────────┐ ┌──────────┐
│Requirement│ │Architecture│ │ Feature │ ← 编排的是软件要素
└──────────┘ └──────────┘ └──────────┘
↑ ↑ ↑
└────────────┼────────────┘
│
[Agent 们] ← Agent 是执行体，不是建模对象
│
codestable/ ← 所有产物持久化在文件系统</div>
</section>
<section class="module">
<h2 class="module-title">🔬 深度解析</h2>
<h3>哲学内核：为什么"人在环"不是弱点而是设计选择</h3>
<p>CodeStable 最受争议的点，也是它与主流框架最根本的分歧：<strong>它认为程序员必须是"在环对象"</strong>。</p>
<p>2026 年 2 月，Hashicorp 联合创始人 Mitchell Hashimoto 提出了 <strong>Harness Engineering（驾驭工程）</strong> 概念——"人类掌舵，Agent 执行"。CodeStable 是这一范式在"编码工作流"领域的具体实现。</p>
<p>它不反对自动化。它反对的是<strong>不留下痕迹的自动化</strong>。当 AI 自主完成一个 feature 后，三个月后另一个 developer 面对这段代码时，为什么这么设计？当时有哪些备选方案？这些设计依赖了什么约束？——全部丢失了。</p>
<p>CodeStable 的回答：<strong>每做一个决定，就在 codestable/ 目录里写下来。</strong> 给人读的，不是给 AI 自嗨的。</p>
<h3>6 个实体 + 3 个流程</h3>
<div class="mermaid-box">
<div class="mermaid">
flowchart TD
CS["cs 根入口"] --> ONBOARD["cs-onboard 初始化"]
ONBOARD --> REQ["cs-req: 需求实体"]
ONBOARD --> ARCH["cs-arch: 架构实体"]
REQ --> ROADMAP["cs-roadmap: 路线图实体"]
ARCH --> ROADMAP
ROADMAP --> FEAT["cs-feat: 特性流程"]
ROADMAP --> ISSUE["cs-issue: 问题流程"]
ROADMAP --> REFACTOR["cs-refactor: 重构流程"]
FEAT --> FEAT_D["cs-feat-design"]
FEAT_D --> FEAT_I["cs-feat-impl"]
FEAT_I --> FEAT_A["cs-feat-accept"]
ISSUE --> ISSUE_R["cs-issue-report"]
ISSUE_R --> ISSUE_A["cs-issue-analyze"]
ISSUE_A --> ISSUE_F["cs-issue-fix"]
FEAT_A --> COMPOUND["compound: 知识沉淀"]
ISSUE_F --> COMPOUND
REFACTOR --> COMPOUND
COMPOUND --> LEARN["cs-learn: 经验"]
COMPOUND --> TRICK["cs-trick: 模式"]
COMPOUND --> DECIDE["cs-decide: 决策"]
COMPOUND --> EXPLORE["cs-explore: 探索"]
LEARN -. "下次被检索" .-> ARCH
TRICK -. "下次被检索" .-> FEAT_D
DECIDE -. "下次被检索" .-> ISSUE_A
EXPLORE -. "下次被检索" .-> ROADMAP
</div>
</div>
<div class="table-wrap">
<table>
<tr><th>实体</th><th>英文</th><th>核心用途</th></tr>
<tr><td><strong>需求</strong></td><td>requirements</td><td>原始用户故事、讨论与权衡。代码烂掉时最终的逃生通道</td></tr>
<tr><td><strong>架构</strong></td><td>architecture</td><td>系统编排层文档，精简统一，<strong>给人读的</strong></td></tr>
<tr><td><strong>路线图</strong></td><td>roadmap</td><td>大需求拆解——模块拆分 + 接口契约 + 子 feature 清单</td></tr>
<tr><td><strong>特性</strong></td><td>feature</td><td>实际工程执行，design → impl → accept 三步闭环</td></tr>
<tr><td><strong>问题</strong></td><td>issue</td><td>Bug 单，report → analyze → fix，analyze 和 fix 强制分离</td></tr>
<tr><td><strong>知识</strong></td><td>compound</td><td>复利工程：经验 / 模式 / 决策 / 探索，四种知识类型</td></tr>
</table>
</div>
<h3>分层架构：不是流水线，是"分层 + 事件驱动"</h3>
<div class="table-wrap">
<table>
<tr><th>层</th><th>内容</th><th>触发时机</th></tr>
<tr><td><strong>阶段 0</strong></td><td>cs-onboard 初始化骨架</td><td>新项目接入（一次）</td></tr>
<tr><td><strong>第 1 层</strong></td><td>cs-req / cs-arch 长效档案</td><td>需求/架构变更（反复刷新）</td></tr>
<tr><td><strong>第 2 层</strong></td><td>cs-roadmap 规划</td><td>大需求拆解（按需进入）</td></tr>
<tr><td><strong>讨论入口</strong></td><td>cs-brainstorm 分诊</td><td>想法模糊时（可选）</td></tr>
<tr><td><strong>第 3 层</strong></td><td>cs-feat-* / cs-issue-* / cs-refactor-*</td><td>事件驱动</td></tr>
<tr><td><strong>横切层</strong></td><td>cs-learn / cs-trick / cs-decide / cs-explore</td><td>任意时刻觉得"值得记下来"</td></tr>
</table>
</div>
<h3>运行时结构：codestable/ 目录设计</h3>
<pre><code>你的项目/
├── codestable/
│ ├── requirements/ # 需求（"为什么要有这个能力"）
│ ├── architecture/ # 架构（"用什么结构实现"）
│ ├── roadmap/ # 路线图（"接下来怎么走"）
│ ├── features/YYYY-MM-DD-{slug}/ # 特性执行
│ ├── issues/YYYY-MM-DD-{slug}/ # 问题修复
│ ├── refactors/YYYY-MM-DD-{slug}/ # 重构（beta）
│ ├── compound/ # 知识沉淀（复利工程）
│ │ └── YYYY-MM-DD-{type}-{slug}.md
│ ├── tools/ # 共享脚本
│ └── reference/ # 共享参考文档
└── AGENTS.md</code></pre>
<h3>硬约束：Skill 隔离与依赖注入</h3>
<p>每个 skill 运行时只能看到自己包内的文件。跨 skill 共享的文档由 cs-onboard 从技能包<strong>复制</strong>到项目的 codestable/reference/，其他 skill 通过项目相对路径读取。这本质上是一个<strong>依赖注入</strong>模式——skill 是通用逻辑，codestable/ 是注入的运行时上下文。</p>
</section>
<section class="module">
<h2 class="module-title">💥 深度裂变</h2>
<div class="fission-section">
<div class="fission-label">颠覆认知</div>
<div class="fission-title">"编排软件要素"是真的范式创新，还是旧酒新瓶？</div>
<p>对 CodeStable 最尖锐的批判性审视。</p>
<h4>正方：确实在范式层面做了翻转</h4>
<p>所有主流 AI 编码框架都在"Agent 编排"范式下工作。CodeStable 问的是另一个问题：<strong>软件的需求、约束、决策怎么被记下来、被检索、被复用？</strong></p>
<p>实践后果：知识沉淀从"副作用"变成"一等公民"。SuperPowers 跑完 TDD → 得到代码和测试。CodeStable 跑完 feature → 得到代码 + design + acceptance + compound。后者在"三个月后还能被理解"上有结构性优势。</p>
<h4>反方：四个没有解决的问题</h4>
<ol>
<li><strong>知识检索依赖 AI 上下文窗口</strong>：compound/ 积累 200 个文件后，AI 能一次读完吗？没有索引或向量检索。</li>
<li><strong>没有强制执行机制</strong>：SuperPowers 的 TDD 是铁律，CodeStable 的 accept 执行深度取决于人。人把关不严，质量门形同虚设。</li>
<li><strong>cs-brainstorm 的分诊能力受限</strong>：让 AI 判断模糊想法"该走哪个流程"，这个判断本身就需要很高的理解力。</li>
<li><strong>对竞品的批评不完全公平</strong>：OpenSpec 的 Spec 文件设计目标就是人机双读。很多用户的实际体验并非"人类没法读"。</li>
</ol>
<div class="search-internal">🔍 搜索内化：V2EX 和 LINUX DO 社区反馈——"正确性对我来说够了，按照流程生成完手动审查，不复杂的需求基本一次性搞定"——但也指出"上下文一长就会忘"的知识检索问题。作者在 Roadmap 中坦承多个模块仍在 beta。</div>
<h4>一个被忽略的关键信号：CodeStable 承认自己会"过时"</h4>
<blockquote>"CodeStable 会根据模型能力的发展进行调整。如果未来某个模型做到某个模块的稳定产出，那么这个模块就可以删除。"</blockquote>
<p>这让它区别于绝大多数 AI 框架——不是试图建立永恒的体系，而是承认自己是<strong>过渡性工具</strong>。这种"自我消解的诚实"在 AI 工具领域极为罕见。</p>
</div>
</section>
<section class="module">
<h2 class="module-title">🎯 实战指南</h2>
<h3>快速开始</h3>
<pre><code># 安装
npx skills add https://github.com/liuzhengdongfortest/CodeStable
# 初始化项目
/cs-onboard
# 日常使用——不知道用哪个就喊根入口
/cs</code></pre>
<h3>典型工作流</h3>
<pre><code># 场景 A：新增功能
/cs-feat → /cs-feat-design → /cs-feat-impl → /cs-feat-accept
# 场景 B：修 Bug
/cs-issue → /cs-issue-report → /cs-issue-analyze → /cs-issue-fix
# 场景 C：快速小改动
/cs-feat-ff # 超轻量通道
# 场景 D：沉淀知识
/cs-learn # 踩坑经验
/cs-trick # 可复用模式
/cs-decide # 技术决策</code></pre>
<h3>避坑指南</h3>
<div class="table-wrap">
<table class="anti-pattern">
<tr><th>🔴 反模式</th><th>✅ 正确做法</th></tr>
<tr><td>跳过 cs-onboard，手动创建 codestable/</td><td>必须用 cs-onboard 初始化，确保 reference/ 被正确复制</td></tr>
<tr><td>cs-feat-impl 中不看 design 自己脑补</td><td>design 是唯一输入，偏离 design 必须回退更新 design</td></tr>
<tr><td>所有改动都走 cs-feat（太重）</td><td>小改动用 cs-feat-ff，大功能走完整流程</td></tr>
<tr><td>compound 文件乱命名</td><td>严格遵循 YYYY-MM-DD-{type}-{slug}.md 格式</td></tr>
<tr><td>不写 acceptance 报告</td><td>acceptance 报告是"三个月后能理解"的关键</td></tr>
</table>
</div>
<h3>CodeStable 与你现有 dev-flow 的融合点</h3>
<div class="table-wrap">
<table>
<tr><th>dev-flow 阶段</th><th>CodeStable 替代/增强</th></tr>
<tr><td>Phase 0 初始 PRD</td><td>cs-req 沉淀为需求文档（更持久）</td></tr>
<tr><td>Phase 1.5 结构化 PRD</td><td>cs-feat-design 作为 design 文档</td></tr>
<tr><td>Phase 2 grill-with-docs</td><td>cs-brainstorm 作为讨论入口</td></tr>
<tr><td>Phase 2.5 zoom-out</td><td>cs-arch 单独维护架构文档</td></tr>
<tr><td>Phase 3 执行</td><td>cs-feat-impl + cs-feat-accept</td></tr>
<tr><td>Phase 4 收尾</td><td>cs-learn / cs-decide 沉淀知识</td></tr>
</table>
</div>
<h3>ROI 分析</h3>
<div class="roi-grid">
<div class="roi-card"><div class="roi-label">初始化</div><div class="roi-value">cs-onboard 2 分钟 → 建好所有目录骨架</div></div>
<div class="roi-card"><div class="roi-label">Feature 流程</div><div class="roi-value">比 OpenSpec 多 5-10 分钟 → 留下 design + acceptance + compound</div></div>
<div class="roi-card"><div class="roi-label">学习成本</div><div class="roi-value">30-45 分钟熟悉 22 技能 → 覆盖完整软件生命周期</div></div>
<div class="roi-card"><div class="roi-label">长期收益</div><div class="roi-value">3 个月后 feature 设计可回溯 → 消除隐知识丢失</div></div>
</div>
</section>
<section class="module">
<h2 class="module-title">📝 温故知新</h2>
<h3>FAQ</h3>
<div class="faq-box">
<details><summary>CodeStable 和 dev-flow 谁更好？</summary><div class="faq-body">不是替代关系。dev-flow 是流程编排元技能，CodeStable 是软件生命周期建模体系。可组合使用：dev-flow 的 grill-with-docs 补充 CodeStable 缺少的术语对齐；CodeStable 的 compound 补充 dev-flow 缺少的结构化知识沉淀。</div></details>
<details><summary>CodeStable 适合一个人用吗？</summary><div class="faq-body">非常适合。设计前提就是"一个人在环"——没有团队角色、没有多 Agent 协作。如果是一个人维护的长期项目，CodeStable 是目前最合适的框架。</div></details>
<details><summary>CodeStable 和 SuperPowers 能一起用吗？</summary><div class="faq-body">理论上可以，但不推荐。哲学对立——SuperPowers 希望人少介入，CodeStable 要求人在环。建议根据项目类型选一个主线。</div></details>
<details><summary>codestable/ 目录会变得很臃肿吗？</summary><div class="faq-body">会，这是有意为之。"臃肿"的文档目录好过"干净"的失忆。日期前缀使按时间浏览很自然，compound 通过 type 字段做聚合。</div></details>
<details><summary>轻量通道 cs-feat-ff 什么时候用？</summary><div class="faq-body">非常明确的小改动——"把按钮颜色改蓝"、"加一个表单字段"。不确定该不该走 ff，就走完整流程。</div></details>
<details><summary>如果不想用全部 22 个技能怎么办？</summary><div class="faq-body">技能是松耦合的。最精简子集：cs-onboard + cs-req + cs-feat + cs-issue。</div></details>
<details><summary>知识检索能力有多强？</summary><div class="faq-body">目前是"文件命名约定 + AI 选择性读取"，非向量语义检索。compound/ 积累 50+ 文件后需要引导 AI 只读相关的。</div></details>
<details><summary>和 mattpocock/skills 的关系？</summary><div class="faq-body">同样 Skills 封装形式，建模哲学不同。mattpocock 是"小工具"——每个解决特定问题。CodeStable 是"体系"——每个是软件生命周期中的一个步骤。</div></details>
</div>
<h3>自测题</h3>
<div class="quiz-box">
<div class="quiz-item">CodeStable 的 6 个软件实体是哪 6 个？每个的核心用途是什么？</div>
<div class="quiz-item">"编排 Agent"和"编排软件要素"的根本区别是什么？在工程实践上会产生什么不同的后果？</div>
<div class="quiz-item">CodeStable 的 3 个核心流程分别是什么？每个流程的技能链是什么？</div>
<div class="quiz-item">cs-feat-design 为什么被设计为"后续所有步骤的唯一输入"？这种设计避免了什么问题？</div>
<div class="quiz-item">compound/ 目录下的 4 种知识类型分别是什么？它们会在什么时机被 AI 重新检索？</div>
<div class="quiz-item">CodeStable 为什么要求每个 skill 运行时只能看到自己包内的文件？这个硬约束解决了什么问题？</div>
<div class="quiz-item">CodeStable 作者所说的"复利工程"（Compound Engineering）具体指什么？</div>
<div class="quiz-item">如果你要将 CodeStable 集成到你现有的 dev-flow 中，哪些 Phase 可以保留、哪些可以用 CodeStable 替换？</div>
</div>
<h3>参考资源</h3>
<ul>
<li>GitHub：<a href="https://github.com/liuzhengdongfortest/CodeStable">liuzhengdongfortest/CodeStable</a></li>
<li>作者的项目 MA：<a href="https://github.com/liuzhengdongfortest/MA">liuzhengdongfortest/MA</a></li>
<li>Harness Engineering (Mitchell Hashimoto, 2026.02)</li>
<li>V2EX 讨论：<a href="https://global.v2ex.co/t/1208525">厌倦了 OpenSpec、OMO、SuperPowers？试试 CodeStable</a></li>
</ul>
</section>
</div>
<footer class="article-footer">
<div class="wrapper"><p>© 2026 叫我小杨同学的小码酱 | 知识吸收器 v3.0 | 真理锚定已通过</p></div>
</footer>
<script>
mermaid.initialize({startOnLoad:true,theme:'base',themeVariables:{primaryColor:'#3b82f6',primaryBorderColor:'#1d4ed8',primaryTextColor:'#1e293b',lineColor:'#64748b',secondaryColor:'#f1f5f9',tertiaryColor:'#eff6ff',fontFamily:'-apple-system,BlinkMacSystemFont,"Segoe UI","Noto Sans SC",sans-serif',fontSize:'14px'},flowchart:{useMaxWidth:true,htmlLabels:true,curve:'basis'}});
window.onload=function(){
const input=document.getElementById('search-input');
if(!input)return;
input.addEventListener('input',(e)=>{
const term=e.target.value.toLowerCase().trim();
const contentArea=document.getElementById('content-area');
const blocks=contentArea.querySelectorAll('p,li,blockquote,.fission-section,.mnemonic-card,details,.mermaid-box,.ascii-box,.story-box,.tldr-box,.table-wrap,pre,.quiz-item,.roi-card,.faq-box details');
if(term.length===0){blocks.forEach(el=>el.classList.remove('hidden'));document.querySelectorAll('h1,h2,h3,h4').forEach(el=>el.classList.remove('hidden'));return}
blocks.forEach(el=>el.classList.add('hidden'));document.querySelectorAll('h1,h2,h3,h4').forEach(el=>el.classList.add('hidden'));
blocks.forEach(el=>{if(el.innerText.toLowerCase().includes(term))el.classList.remove('hidden')})})};
</script>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink