🧠 AI编程工作流工具全景指南

OpenSpec · Superpowers · Compound Engineering Plugin —— 规划 · 执行 · 沉淀

📌 核心理念 —— 这三个工具并非竞争关系,而是互补的“黄金三角”: 三者组合可形成一条从需求到交付、并持续进化的工程流水线。

📐 OpenSpec

规范驱动 · 规划大师
在写任何代码之前,通过结构化的规格文档(proposal, design, tasks, specs)建立“人与AI的契约”,大幅减少返工。

🔧 命令行工具 (CLI)

openspec init

在当前项目中初始化 OpenSpec 目录结构和 AI 集成。

openspec list

列出所有活跃的变更。

openspec view

交互式仪表板,浏览规范和变更。

openspec update

更新配置文件及斜杠命令。

openspec config profile

切换工作流模式(core / expanded)。

🤖 AI 斜杠命令 (Core 工作流)

/opsx:propose

一步创建变更并生成所有规划文件(proposal, design, tasks, specs)。

/opsx:explore

在开发前进行需求探索、方案调研。

/opsx:apply

严格按照 tasks.md 逐步实现功能。

/opsx:archive

变更完成后归档,合并规范至主分支。

Expanded 工作流 额外提供 /opsx:new/opsx:continue/opsx:ff/opsx:verify/opsx:sync/opsx:bulk-archive/opsx:onboard 等精细控制命令。

🛡️ Superpowers

纪律驱动 · 执行总监
通过强制性的工作流(头脑风暴 → 计划 → 子代理执行 → 审查)为 AI 行为套上“护栏”,确保质量与一致性。

🧩 14 项核心技能(分类)

🤝 协作/规划 (9) 🧪 测试 (1) 🐞 调试 (2) ⚙️ 元技能 (2)

🧠 brainstorming 规划

苏格拉底式问答,产出设计文档,未获批准绝不写代码。

📝 writing-plans 规划

将设计拆解为细粒度实施计划(含精确路径和代码)。

🤖 subagent-driven-development 规划

为每个任务派发独立子代理,执行后两阶段审查(规格+质量)。

⚡ dispatching-parallel-agents 规划

并行执行互不依赖的子任务,提高效率。

🔍 requesting-code-review 规划

自动获取 git diff 逐文件审查,按严重程度报告问题。

📬 receiving-code-review 规划

专业地接收和处理审查意见,逐条验证并解决。

🌳 using-git-worktrees 规划

为每个变更创建独立 worktree,隔离开发环境。

🏁 finishing-a-development-branch 规划

引导完成合并、创建 PR 或清理分支。

📋 executing-plans 规划

备选方案(无子代理时)逐步执行并确认。

🔴🟢 test-driven-development 测试

强制“红-绿-重构”循环,先写失败测试,再实现。

🐛 systematic-debugging 调试

四阶段根因分析,禁止随机猜测式修复。

✅ verification-before-completion 调试

必须提供证据(测试/手动验证)才能宣布完成。

🧰 using-superpowers

确保正确识别并调用其他技能。

✍️ writing-skills

高级用户可用 TDD 编写自定义技能。

斜杠命令/superpowers:brainstorm/superpowers:write-plan/superpowers:execute-plan 可主动触发核心流程。

🌱 Compound Engineering

复合增长 · 知识顾问
秉持“每一次工程工作都让下一次更容易”的理念,将 80% 精力投入规划与审查,20% 用于编码,并通过知识沉淀实现持续进化。

🔄 核心工作流(6 个命令)

/ce-brainstorm 规划

交互式问答,将模糊需求转为结构化需求文档。

/ce-plan 规划

细化实施计划,包含任务、测试要点和边缘情况。

/ce-work 执行

按计划执行开发,并自动使用 git worktree 隔离环境。

/ce-simplify-code 执行

代码审查前进行重构优化,提升清晰度和可复用性。

/ce-code-review 审查

多代理(Multi-agent)审查,识别模式而非仅找问题。

/ce-compound 沉淀

将经验、教训、模式记录到 docs/solutions/,供未来复用。

🧰 扩展命令

/ce-ideate

在 brainstorm 前生成多个创意并评估,选出最佳方案。

/ce-strategy

创建/维护 STRATEGY.md,为所有决策提供对齐锚点。

/ce-debug

系统性调试流程,重现问题并追踪根因。

/ce-product-pulse

生成产品使用、性能、错误的定期报告。

/ce-doc-review

检查文档质量。

/ce-setup

检查环境并引导项目配置。

内置 37 项技能 + 51 个专业代理(如 Rails、Python、TypeScript 专项审查、安全审计等),可根据项目上下文自适应激活。

⚖️ 核心对比

维度OpenSpecSuperpowersCompound Engineering
核心定位规范驱动的“总设计师”纪律驱动的“工程总监”复合增长的“知识顾问”
主要目标减少需求理解偏差,建立契约强制流程纪律,防止AI失控让每一次工作都让下一次更容易
工作流重心规划(规格文档)执行(子代理 + TDD + 审查)规划与审查(80%)+ 执行(20%)
产出物proposal.md, design.md, tasks.md, specs/高质量代码 + 测试 + 审查报告需求文档 + 实施计划 + 知识沉淀(solutions/)
关键机制规范变更与归档强制头脑风暴、子代理、两阶段审查复合效应(/ce-compound)与战略对齐
适用场景需求明确、长期维护、严格变更追踪对代码质量和流程纪律要求极高追求长期代码健康、团队知识系统化

🔗 如何结合使用(黄金三角工作流)

① 规划
OpenSpec

生成 proposal / design / tasks

② 执行
Superpowers

子代理 + TDD + 两阶段审查

③ 沉淀
Compound Engineering

/ce-compound 固化经验