openspec-agents
!License: MIT !Built for OpenSpec
> 让多个 AI 智能体按规范流程协作,把 OpenSpec 变更规范落地为经过审查的高质量代码。
openspec-agents 是一组面向 AI 编码工具的插件,把 OpenSpec 的「需求 → 设计 → 任务拆分」成果,自动推进到「实现 → 验证 → 质量审查 → 收尾合并」的完整实施流程。主智能体负责调度,专职智能体分别承担实现、检查与质量把关,每一步都有门禁确认,全程可审计、可恢复。
特性
- 多工具支持:Claude Code、Codex、ZCode、DeepSeek Harness(DSH)、OpenCode 均可原生接入。
- 规范驱动:直接消费 OpenSpec 变更规范(proposal / design / tasks / specs),流程与规范一一对应。
- 智能体团队:不再是单个 AI 从头写到尾,而是「实现者 + 审查者 + 质量把关者」分工协作,结果更稳。
- 质量门禁:实现之后经过工具检查、任务验证与多维度质量审查;发现的问题自动回退修复,也可按规则豁免并留痕。simple 模式下验证按性质分流——开发者执行确定性检查并申报,审查者分级复验(低成本项实跑、高成本项核验申报加抽样重放)并专注对抗性判断。
- 隔离执行:每个变更在独立的环境中实施,互不干扰;变更完成后合并并清理。
- 过程可审计:进度、结论、豁免与恢复点全程记录,随时可以接着上次的进度继续。
快速开始
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@ifrankwangCodex
codex plugin marketplace add https://github.com/ifrankwang/codex-plugins
codex plugin add openspec-agents@ifrankwangZCode
打开 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](LICENSE) © 2025 ifrankwang