Appearance
2026年，AI编程助手已经不再是新鲜事。Claude Code、Codex CLI、Cursor、Gemini CLI……每个工具都能帮你写代码。但用过的人都知道一个残酷的现实：让AI写100行代码容易，让AI高质量地完成一个完整功能，难。
开篇：AI编程的「三体问题」
三个致命短板：
| 问题 | 表现 |
|---|---|
| 需求漂移 | AI在聊天记录里找需求，聊着聊着就忘了最初要做什么 |
| 流程失控 | AI上来就写代码，没有设计、没有测试、没有审查 |
| 纪律缺失 | AI今天用这个风格写，明天换那个方式写 |
这三个问题，恰好对应了三个开源项目的解决方案：
| 问题 | 解决方案 | 核心理念 | 一句话 |
|---|---|---|---|
| 需求漂移 | OpenSpec | Spec-Driven Development | 用文档定AI |
| 流程失控 | Superpowers | Agentic Skills Framework | 用流程带AI |
| 纪律缺失 | Agent Skills | Skill Lifecycle Management | 用纪律管AI |
第一章：认识三位主角
1.1 OpenSpec —— 用文档定AI
- GitHub: Fission-AI/OpenSpec
- Stars: 43.2k ⭐
- 支持工具: Claude Code、Codex、Cursor、Gemini CLI等25+AI编程助手
核心哲学：在人机之间先达成共识，再让AI写代码。
工作原理：
你说：/opsx:propose "添加暗黑模式"
AI自动生成：
├── proposal.md ← 为什么要做，要改什么
├── specs/ ← 需求场景和验收标准
├── design.md ← 技术方案
└── tasks.md ← 实现任务清单关键命令：
| 命令 | 作用 | 使用阶段 |
|---|---|---|
openspec init | 初始化项目 | 一次性 |
/opsx:propose | 提出变更提案 | 需求阶段 |
/opsx:apply | 执行实现 | 开发阶段 |
/opsx:archive | 归档变更 | 完成阶段 |
/opsx:verify | 验证实现 | 质量检查 |
1.2 Superpowers —— 用流程带AI
- GitHub: obra/superpowers
- Stars: 169k ⭐
- 支持平台: Claude Code、Codex CLI、Cursor、OpenCode、Copilot CLI、Gemini CLI
核心哲学：AI不应该「自由发挥」，而应该遵循一套经过验证的软件工程流程。
完整工作流：
brainstorming → using-git-worktrees → writing-plans → subagent-driven-dev
↓ ↓ ↓ ↓
需求澄清 分支隔离 编写计划 子Agent并行
↓ ↓ ↓ ↓
test-driven-dev → requesting-code-review → finishing-branch
↓ ↓ ↓
TDD测试 代码审查 收尾15+技能分类：
| 分类 | 技能 | 说明 |
|---|---|---|
| 协作 | brainstorming | Socratic式需求澄清 |
| 协作 | writing-plans | 详细实现计划 |
| 协作 | subagent-driven-development | 子Agent并行开发 |
| 测试 | test-driven-development | RED-GREEN-REFACTOR |
| 调试 | systematic-debugging | 四阶段根因分析 |
| Git | using-git-worktrees | 并行开发分支 |
| 元 | writing-skills | 创建新技能 |
安装方式：
bash
# Claude Code
/plugin install superpowers@claude-plugins-official
# Cursor
/add-plugin superpowers
# Gemini CLI
gemini extensions install https://github.com/obra/superpowers1.3 Agent Skills —— 用纪律管AI
- GitHub: addyosmani/agent-skills
- Stars: 24.3k ⭐
- 作者: Addy Osmani (Google Chrome团队工程总监)
- 核心创新: 7命令技能生命周期管理
核心哲学：AI Agent需要「可编程的纪律」——不是每次手动提示，而是把最佳实践编码为可复用、可版本控制的技能。
7命令技能生命周期：
init → verify → install → on → off → update → uninstall20个技能分类：
| 阶段 | 技能 | 核心约束 |
|---|---|---|
| 需求分析 | req-clarify | 3轮限定的需求澄清对话 |
| 设计 | design-api | OpenAPI 3.0强制输出 |
| 设计 | design-db | 强制规范命名和数据字典 |
| 开发 | code-structure | 文件≤500行，函数≤50行 |
| 测试 | test-coverage | 分支覆盖率≥80% |
| 安全 | security-dependencies | 检查已知漏洞 |
| 安全 | security-secrets | 防止密钥泄露 |
| 生产 | production-ready | 全面Release Checklist |
安装与使用：
bash
# 初始化技能库
agent-skills init
# 安装所有技能
agent-skills install
# 启用特定技能
agent-skills on test-coverage code-structure
# 停用
agent-skills off design-security第二章：三者如何完美结合
关系模型
| 工具 | 管什么 | 一句话总结 |
|---|---|---|
| OpenSpec | 「说清楚」 | 人和AI之间建立书面契约 |
| Superpowers | 「做对事」 | 确保AI每一步都走对流程 |
| Agent Skills | 「做得好」 | 确保AI产出符合工程标准 |
组合原则
| 原则 | 说明 |
|---|---|
| 层次分明 | 需求层→流程层→纪律层，各司其职 |
| 顺序执行 | 不可跳跃，跳过就会出问题 |
| 工具互补 | OpenSpec的tasks.md是Superpowers的输入 |
第三章：完整工作流8步
真实案例：直播间分享到第三方
| 步骤 | 内容 | 工具主导 |
|---|---|---|
| 1 | 需求对齐（proposal/spec/design/tasks） | OpenSpec |
| 2 | 需求澄清（Socratic反问） | Superpowers |
| 3 | 分支隔离（git worktree） | Superpowers |
| 4 | 计划制定（细化tasks） | Superpowers |
| 5 | 子Agent并行开发 | Superpowers + Agent Skills |
| 6 | 测试+审查 | Superpowers + Agent Skills |
| 7 | 安全检查 | Agent Skills |
| 8 | 验证+收尾 | 三方协作 |
时间估算：
| 步骤 | 耗时（AI推理） |
|---|---|
| 需求对齐 | 5分钟 |
| 需求澄清 | 5-10分钟 |
| 分支隔离 | 30秒 |
| 计划制定 | 1-2分钟 |
| 子Agent开发 | 15-30分钟 |
| 测试+审查 | 8-13分钟 |
| 安全检查 | 1-2分钟 |
| 验证+收尾 | 3分钟 |
| 总计 | 40-65分钟 |
其中人真正需要投入的时间：约10-15分钟。
⚠️ 边界声明
三件套是「行为约束」，不是「系统级强制」：
| 强度等级 | 表现 | 由谁保证 |
|---|---|---|
| 程序性强制 | 命令失败即流程中断 | CLI/编译器/CI闸门 |
| AI行为约束 | AI主动遵守，但可能漏选 | Skill元数据+模型选择 |
| 流程惯例 | 写在文档里 | 团队共识+人审 |
实务建议：
- 关键质量门槛同时落两层（如分支覆盖率既写进skill又配到CI）
- secrets/SDK安全必须以CI闸门为准
- AI漏选skill时要人显式指定
总结：AI编程的「铁三角」
| 维度 | OpenSpec | Superpowers | Agent Skills |
|---|---|---|---|
| 一句话 | 用文档定AI | 用流程带AI | 用纪律管AI |
| 核心能力 | 人机契约 | 工程流 |
