AI 协作工程化

wiki/ai/concepts/AI-协作工程化.md

分类：ai / concepts · 更新：2026-06-14 00:33

AI 协作工程化

专题综述：把两篇微信文章的 13 个概念/实体串成一条线。

一条问题线

AI 编程的核心矛盾：生成快、验证慢、错误累积。

Karpathy 称之为 Vibe Coding——凭感觉写代码。在低风险场景好用，但进入生产级代码库会出现三个结构性缺陷：信息损耗、知识孤岛、验证断档。

公式化表达：代码产出 = AI 能力 × 上下文质量（乘法，不是加法）。上下文质量趋近零，模型再强产出也是零。瓶颈不在模型，在上下文。

两条解决路线

面对同一个矛盾，业界演化出两条路线：

路线 A：三件套（个人/小团队）

工具	职责	核心理念
OpenSpec	想清楚	Spec-driven development，先写规格再写代码
Superpowers	拆清楚	子代理驱动开发 + TDD，任务原子化
gstack	做清楚	Garry Tan 的 23 人虚拟团队，全流程 review/QA/部署

三者组合：规格驱动 + 测试驱动 + 角色化审查。适合个人开发者和小团队。

关键产物：openspec/ 目录（规格）、tasks.md（任务清单）、CLAUDE.md（项目上下文）。

路线 B：Harness Engineering（企业级）

Harness Engineering = 在正确的轨道上高效生成。QQ音乐在 50+ 微服务场景落地：

组件	作用	对标三件套
五阶段 + 四门禁	流程骨架，在错误最便宜的地方拦住它	OpenSpec 的 spec-driven 流程
Skill/Agent/Command（34/24/35）	能力原子化 + 角色化	Superpowers 的 Skill 体系 + gstack 的虚拟角色
三层知识 + 三仓联动	上下文工程 + 跨仓协调	OpenSpec 的 context 注入
Self-Refinement	从错误中沉淀经验	三件套没有的——企业特有的知识闭环

不替代 Claude Code/Cursor 等 L1-L4 执行层工具，只补齐 L5 治理层。

五个共享原则

两条路线表面不同，底层共享五个原则：

1. 先对齐再动手

三件套：OpenSpec proposal → specs → design → tasks
Harness：五阶段流程 + 需求/设计门禁
本质：把"理解需求"从一次性对话变成持久化的工程制品

2. 知识驻留在文件里

三件套：openspec/ 目录、CLAUDE.md
Harness：context/ 三层知识、AGENTS.md、.service-matrix/
本质：Knowledge as Code——可版本化、可审计、可复用

3. 系统性补上下文

三件套：config.yaml 的 context 字段、CLAUDE.md
Harness：三层知识体系（team → framework → project）
本质：Context Engineering——不是每次补 prompt，而是建立上下文基建

4. 能力原子化

三件套：Superpowers 的 Skill、gstack 的 slash command
Harness：34 Skills + 24 Agents + 35 Commands
本质：把复杂任务拆成可委派、可审查、可复用的单元

5. 单一真相源

三件套：openspec/specs/ 是系统行为的唯一描述
Harness：main-process-numbering.md 是流程语义的唯一真相源、.service-matrix/ 是服务拓扑的唯一真相源
本质：规范口径不散落，一次更新全仓生效

你的 LLM Wiki 在哪里

LLM Wiki（你的 ~/llm-wiki/）本质上是这些原则的个人级实践：

企业级（QQ音乐）	个人级（你的 LLM Wiki）
context/ 三层知识	vault/wiki/ 三层目录
AGENTS.md	无（直接与 AI 对话）
.service-matrix/	无（单仓，无跨服务）
24 Agents	无（单会话）
Self-Refinement experience/	log.md + 知识页面持续演进
门禁	人工判断（ingest 时的筛选）

你的 wiki 已经在做 Context Engineering + Knowledge as Code，只是规模是个人级。如果未来想往小团队级扩展，Harness Engineering 的三层知识 + 门禁是最值得借鉴的模式。

概念关系图

Vibe Coding（问题）
    │
    ▼ 核心矛盾：生成快、验证慢、错误累积
    │
    ├─ 路线 A：三件套 ─── OpenSpec → Superpowers → gstack
    │                           │          │
    │                     Spec-driven   子代理驱动
    │
    └─ 路线 B：Harness Engineering ─── 五阶段+四门禁
                                        │
                                  Context Engineering
                                  Knowledge as Code
                                  Self-Refinement

共享原则：先对齐 / 知识即代码 / 补上下文 / 原子化 / 单一真相源