前言¶
用 DSH 这类 AI 编码工具干活，最常见的做法是把需求直接丢给一个 AI，让它从头写到尾。上手快，但毛病也明显：过程不可见，写得对不对全靠事后人工检查；一步出问题想回退，只能翻对话记录；换个会话，进度就断了。
OpenSpec（Fission-AI/OpenSpec，openspec.sh）解决的是前半段：先写规范、再写代码，把需求整理成 proposal / design / tasks / specs。但规范写完之后呢？实现、验证、审查、合并，这些环节还是要使用者自己盯着 AI 一步步做。openspec-agents 补的就是这一段：它把 OpenSpec 变更的实施与质量把关编排成固定流程，交给一组分工明确的智能体执行。
这是什么¶
openspec-agents 是一个工作流类插件，作者是 ifrankwang，许可证为 MIT，npm 包名 @ifrankwang/openspec-agents，当前版本 0.133.1。它基于 OpenSpec 构建，专注补全 OpenSpec 变更的实施与质量把关环节。
一句话定位：让多个 AI 智能体按规范流程协作，把 OpenSpec 变更规范落地为经过审查的高质量代码。
插件支持多个 AI 编码工具原生接入：Claude Code、Codex、ZCode、DeepSeek Harness（DSH）、OpenCode。下面以 DSH 为例介绍。
核心能力¶
规范驱动与智能体分工¶
插件直接消费项目中的 OpenSpec 变更规范：proposal（变更说明）、design（设计）、tasks（任务清单）、specs（验收规格），流程与规范一一对应。
执行时不是单个 AI 从头写到尾，而是主智能体负责调度，专职智能体分工协作——实现者写代码，审查者做检查，质量把关者做多维验证。
质量门禁与任务验证¶
实现完成后要依次过三道检查：工具检查、任务验证、多维度质量审查。发现问题会自动回退到实现环节修复；符合规则的也可以豁免，豁免会留痕。
任务验证是一道强制门禁：审查结论以 passed 提交时，必须逐项确认全部已申报任务，verified_tasks 全覆盖。如果因此阻塞，审查者可以补交确认结果解除。
simple 模式下验证按性质分流：确定性检查由开发者执行并申报，审查者分级复验，把精力集中在对抗性判断上。
隔离执行与过程留痕¶
每个变更在独立环境中实施，互不干扰；完成后合并并清理环境。
全过程可审计、可恢复：进度、结论、豁免与恢复点全程记录，中断后可以接着上次的进度继续。人工执行或环境无法验证的任务，通过 blocker 上报，用户确认留痕（blocker_updates）后凭记录申报完成。恢复参数 reset_steps 会按流程模式（full / simple）校验各自的值域后生效。
独立审查会话¶
除了绑定 OpenSpec 变更的编排流程，插件还支持不绑定任何变更的独立代码审查：对 PR 改动区间（review_scope=pr）或全量代码库（review_scope=full）做一次完整审查。review_scope 与 change_id / task_group_id 二选一，互斥。
初始化时可以配置颗粒度与修复策略：
1、颗粒度：thorough（分三层，第二层是回归验证）或 simple（单个审查者完成全部检查）；
2、修复策略：fix（发现问题自动修复后重审）或 none（只审不修）。
thorough 的回归验证要求构建必须通过、既有测试不得出现新失败；能启动服务时，还会做冒烟与既有 API 测试。
审查在独立 worktree 中进行。fix 模式全部通过后，把工作分支合并回目标分支并清理环境；none 模式不合并，直接销毁工作环境。
安装与启用¶
环境准备两样东西：Node.js ≥ 23.6（或 Bun）与 git。
DSH 的理念是「一切皆插件」，接入 openspec-agents 只需要一条命令：
dsh plugin --profile web add @ifrankwang/openspec-agents
安装完成后重启 dsh web 即可。
典型用法¶
一句话接入¶
安装之后（甚至还没安装时也可以），直接把这句提示词发给 DSH：
请帮我安装并启用 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、审查范围：review_scope 传 pr（两个本地分支之间的改动区间）或 full（全量代码库），与 change_id / task_group_id 互斥；
2、颗粒度：thorough 或 simple；
3、修复策略：fix 或 none。
工具会按审查范围推导出会话 ID，并在返回结果中告知，后续步骤都使用这个会话 ID 进行。
适用场景与注意¶
先说代价：这套编排流程比单个 AI 直接修改更慢，API 消耗也更高。换来的是稳定、可复现、可审计的实施过程——每一步有门禁，出了问题能回退，中断了能恢复。
因此它适合对代码质量、过程可控性要求高的团队与项目。如果只是改几行代码的小活，直接让 AI 改完可能更省事。
安全上提醒一句：插件以当前 dsh 进程的权限运行，安装前建议先检查源码与许可证。openspec-agents 的源码在 GitHub 上公开，许可证为 MIT，确认无误后再装。
结尾¶
简单回顾：OpenSpec 负责把需求变成规范，openspec-agents 负责把规范变成经过门禁审查、全程留痕的代码，中间不再需要人肉盯流程。如果你的团队已经在用 OpenSpec 管理变更，值得把它加进工具链。
