openspec-agents

让多个 AI 智能体按规范流程协作，把 OpenSpec 变更规范落地为经过审查的高质量代码。

openspec-agents 是一组面向 AI 编码工具的插件，把 OpenSpec 的「需求 → 设计 → 任务拆分」成果，自动推进到「实现 → 验证 → 质量审查 → 收尾合并」的完整实施流程。主智能体负责调度，专职智能体分别承担实现、检查与质量把关，每一步都有门禁确认，全程可审计、可恢复。

特性

• 多工具支持：Claude Code、Codex、ZCode、DeepSeek Harness（DSH）、OpenCode 均可原生接入。
• 规范驱动：直接消费 OpenSpec 变更规范（proposal / design / tasks / specs），流程与规范一一对应。
• 智能体团队：不再是单个 AI 从头写到尾，而是「实现者 + 审查者 + 质量把关者」分工协作，结果更稳。
• 质量门禁：实现之后经过工具检查、任务验证与多维度质量审查；发现的问题自动回退修复，也可按规则豁免并留痕。
• 隔离执行：每个变更在独立的环境中实施，互不干扰；变更完成后合并并清理。
• 过程可审计：进度、结论、豁免与恢复点全程记录，随时可以接着上次的进度继续。

快速开始

1. 准备环境：Node.js ≥ 23.6（或 Bun）与 git。
2. 按下方「安装」选择你正在使用的 AI 工具完成安装。
3. 重启该工具后，把下面「一句话接入」的提示词发给你的 AI 即可开始。

安装

按你使用的 AI 工具选择一种方式：

Claude Code

claude plugin marketplace add https://github.com/ifrankwang/claude-code-plugins
claude plugin install openspec-agents@ifrankwang

Codex

codex plugin marketplace add https://github.com/ifrankwang/codex-plugins
codex plugin add openspec-agents@ifrankwang

ZCode

打开 ZCode 插件页，添加市场 ifrankwang/zcode-plugins，然后安装 openspec-agents。

DeepSeek Harness（DSH）

dsh plugin --profile web add @ifrankwang/openspec-agents

安装后重启 dsh web 即可。

OpenCode

npm install -D @ifrankwang/openspec-agents

然后在 OpenCode 配置中加载 @ifrankwang/openspec-agents 插件，重启 OpenCode。

让 AI 帮你接入（一句话）

安装后（甚至还没安装时），直接把这句提示词发给你的 AI 编码工具：

请帮我安装并启用 openspec-agents 插件，然后基于当前项目的 OpenSpec 变更规范，执行完整的变更实施编排流程。

英文版：

Please install and enable the openspec-agents plugin for my current AI coding tool, then run the OpenSpec change orchestration workflow on this repository.

如果已经安装，只需说一句「请运行 openspec-agents 编排流程」即可开工。AI 会负责完成安装、初始化、任务分派与质量把关的全部步骤。

工作原理（简述）

1. 输入：项目中的 OpenSpec 变更规范（变更说明、设计、任务清单、验收规格）。
2. 分派：主智能体把任务交给专职智能体——实现者负责写代码，审查者负责检查，质量把关者负责多维验证。
3. 门禁：每一步的结论通过检查后才进入下一步；不通过的结论自动回到实现环节修复。
4. 收尾：变更完成后自动合并分支并清理执行环境，全程留痕可审计。

适用场景与代价

| | | |---|---| | 适合 | 对代码质量、过程可控性要求高的团队与项目 | | 代价 | 比单个 AI 直接修改更慢，API 消耗更高 |

如果你愿意用一点成本换取稳定、可复现、可审计的实施过程，这个项目就是为你准备的。

开发

bun install            # 安装依赖
bun test               # 运行测试
bun run typecheck      # 类型检查
bun run build:plugins  # 构建各平台的插件包（发布用）

贡献

欢迎提交 Issue 与 Pull Request，也欢迎 Star 支持。

致谢

本项目基于 OpenSpec（openspec.sh）构建——感谢 OpenSpec 团队带来的规范驱动开发方法：先写规范、再写代码，让 AI 开发有据可依。本插件专注于补全 OpenSpec 变更的实施与质量把关环节，是对 OpenSpec 工作流的编排增强。

许可证

MIT © 2025 ifrankwang