ruvnet/sparc

这是什么？

核心功能

• 01按顺序强制执行 SPARC 五个阶段，并通过确定性门控检查。
• 02通过版本号校验和幂等键，防止冲突或重复的修改。
• 03完成前要求带签名、经验证者认证的测试证据。
• 04提供 npm CLI 以及本地和远程 MCP 服务。
• 05状态私有存储、原子写入，并可检测篡改。

适用场景

• 对 AI 辅助的代码变更进行可审计的阶段门控和测试证据管理。
• 通过 MCP 把结构化开发流程提供给 Claude 或 Codex 使用。
• 在接受变更为完成之前，要求经签名的验证结果。

快速上手

1. 1

   使用 doctor 命令检查安装（需要 Node.js 20 或更新版本）

   npx --yes @ruvnet/sparc@1.0.0 doctor
2. 2

   初始化 SPARC 状态

   npx --yes @ruvnet/sparc@1.0.0 init
3. 3

   创建包含需求和验收测试的运行定义 JSON 文件，然后启动运行

使用前须知

• !通过和例外证据需要在每个读写状态的进程中配置 Ed25519 验证者公钥。
• !远程 MCP 使用需要经过身份验证的 HTTPS 反向代理和外部身份提供方。

收录于专题

标签

常见问题

sparc 是什么？

通过 TypeScript 状态机、CLI 和 MCP 服务强制执行 SPARC 五阶段的证据门控工程流程。 SPARC 是一套软件变更工作流框架，把规格说明、伪代码、架构、细化和完成五个阶段用代码强制执行，而不是依赖提示词约束。每个阶段都有必需的产出物，只有门控检查通过才能进入下一阶段。每次修改必须匹配当前版本号，重试时只会重放原始请求。

sparc 可以免费使用吗？用的什么许可证？

sparc 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

sparc 还在维护吗？

活跃维护中。sparc 最近一次提交是在 2026年11月7日。

sparc 适合用来做什么？

对 AI 辅助的代码变更进行可审计的阶段门控和测试证据管理。 通过 MCP 把结构化开发流程提供给 Claude 或 Codex 使用。 在接受变更为完成之前，要求经签名的验证结果。

sparc 怎么安装和运行？

使用 doctor 命令检查安装（需要 Node.js 20 或更新版本）: npx --yes @ruvnet/sparc@1.0.0 doctor 初始化 SPARC 状态: npx --yes @ruvnet/sparc@1.0.0 init 创建包含需求和验收测试的运行定义 JSON 文件，然后启动运行

在哪里获取 sparc？

源代码和安装说明在 GitHub 上：https://github.com/ruvnet/sparc