Openspec Agents — Development skill for Claude Code

openspec-agents

 

`openspec-agents` 是 [OpenSpec](https://openspec.sh) 的配套插件，兼容 Claude Code / Codex / ZCode / DeepSeek Harness / OpenCode：提案阶段把标准钉得更死（澄清在前、改动范围与契约变更逐条确认），实施阶段由多 Agent 分工——写、查、验收、质量审查各由不同 Agent 担任，按生产级标准把控到收口。

前提：项目正在使用 OpenSpec 管理需求。

适合	变更需要真正落进代码库、有验收标准、需通过检查、过程可追溯的团队与项目
不适合	希望快速产出 demo、不走检查与验收的场景
代价	比单个 AI 直接修改更慢，Token 消耗更高
模型选型	实施用 flash 类模型，提案用旗舰模型

常见痛点

• AI 一次改一大片，改完声称「完成了」——能编译、测试也通过，但其中夹带的空实现与伪成功未被发现。
• 共用逻辑被改动后，其他调用入口仍在使用旧写法，无人察觉。
• 出了问题想复盘，只能翻到大量对话记录，看不出当时按什么标准放行。

与工具自带工作流的区别

Claude Code 和 DeepSeek Harness 自带的工作流能力擅长**并行完成大量独立任务**。这个插件解决的是另一件事，两者可以叠加使用。

	工具自带的工作流	本插件
擅长	并行完成大量独立任务	单个变更按阶段推进，逐层把关
如何放行	由脚本中的判断决定	由程序强制：检查未完成、问题未闭环时无法以「通过」提交
跨工具	各家私有	同一套流程跨工具通用
中断之后	进度依附于对话或单次运行	进度记录在仓库中，换会话、换工具均可继续

一句话：原生工作流负责把任务做完，这个插件负责判定产出是否达到生产级。

局限

使用前请先确认以下三条边界。

**存量项目需要一次收敛成本。** 判据按理想状态定义（方法不超过 50 行、类职责单一、核心域不依赖框架、构建产物需忽略、覆盖率需达标），且工具检查覆盖全量代码——存量违规同样按原级别上报并阻塞。存量项目首次运行会暴露大量存量问题，只能逐个修复，或逐个走豁免裁定；裁定通过的会沉淀进项目级清单，后续变更不再重复阻塞。

**Java 之外只有通用规范。** 23 份 skill 中 10 份技术栈无关、11 份为 Java 后端配套（含具体构建与检查命令、ArchUnit 规则、Spotless / PMD / SonarQube 配置）。非 Java 项目审查照常执行，但编译、格式、静态分析、覆盖率这几项确定性检查没有现成命令，需自行补充一份技术栈 skill，否则只能按降级申报跳过。

**架构规范只有 DDD 一套。** 包组织有两种等价的合法风格——四层分层（domain / application / infrastructure / interfaces）与六边形（内核 + 入站 / 出站适配器），采用哪种由项目声明，未声明时按四层认定。不按 DDD 组织的项目（例如 MVC + Service + DAO 直写）没有对应规范，会被判定为偏离规范并报出问题；项目已有自己的架构规范时以项目规范为准，但该规范需自行写入。

快速开始

项目还没用 OpenSpec 的话，先装上并初始化：

npm install -g @fission-ai/openspec
openspec init

装好后项目根会出现 `openspec/` 目录。

第一步：安装

按你用的工具选一种，装完重启该工具。

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://