OpenSpec、Spec Kit 与 Harness:理清关系,再选 AI 研发工具
同时使用 Codex、Cursor 和 Claude Code 后,团队很容易遇到三类问题:
- 同一个项目,在不同工具里维护了不同版本的规则。
- 需求已经说过,AI 实现时仍然遗漏关键场景。
- 任务做到一半,换个会话后又要重新解释进度。
这些问题彼此相关,却需要不同的解决办法。Rulesync、Spec Kit、OpenSpec、Trellis,以及经常被提到的 Harness,就分别涉及其中的不同环节。
选型的第一步,是把它们放回各自的位置。
一、先分清:规范、规范工具和 Harness
"项目宪法"通常记录长期工程原则,例如架构边界、依赖管理、测试要求;具体功能的 Spec 则描述本次要实现的行为、边界条件和验收标准。
Spec Kit、OpenSpec 是帮助团队组织这些内容并推进开发的工具。Harness 是更广泛的工程概念,涉及模型如何获取上下文、调用工具、保存进度和执行验证。
| 概念或工具 | 主要作用 |
|---|---|
| 项目宪法、工程规范 | 明确项目长期遵守的原则 |
| Spec | 明确具体需求及验收标准 |
| Spec Kit、OpenSpec | 组织规格、计划、任务和开发流程 |
| Harness | 为 AI 执行任务提供上下文、工具、状态与反馈机制 |
| Trellis | 提供团队级 Harness 与项目知识管理方案 |
| Rulesync、Ruler | 将统一规则或配置分发给不同 AI 工具 |
因此,OpenSpec 和 Spec Kit 可以放在一起比较;Harness 是理解执行机制的概念,Trellis 是这一方向的具体方案。
实际产品的能力会有交集。这张表强调的是选型时最值得关注的职责,而不是严格的软件分层。
Anthropic 对长时间运行 Agent 的研究,就将环境初始化、进度记录、增量开发和验证作为 Harness 设计的重要部分。Harness 实践说明
二、用一个开发需求,看它们如何配合
假设团队准备给语聊房增加"断线自动重连"。
这件事可以拆成四个环节:
| 环节 | 需要解决的问题 | 示例 |
|---|---|---|
| 工程规范 | 开发时遵守什么原则? | 复用现有 RTC 封装,不在页面中直接调用底层 SDK |
| 需求规格 | 功能应该怎样表现? | 断线后显示重连状态;超时后允许退出;避免重复加入房间 |
| 执行与验证 | 怎样持续完成任务? | 读取相关代码,逐项实现,执行检查,记录尚未完成的场景 |
| 跨工具配置 | 换个工具后如何获得相同规则? | 从统一来源生成或加载各工具的项目指令 |
Spec Kit 或 OpenSpec,可以帮助团队把需求、方案和任务组织起来。
Harness 负责提供执行过程所需的支撑。例如,下一次会话开始时,能够找到任务进度;修改完成后,能够调用已有测试并保留结果。
Rulesync 或 Ruler 则可以处理跨工具配置的一致性。
规格清楚,有助于减少理解偏差;执行机制完整,有助于任务持续推进;配置统一,有助于不同工具获得一致要求。 三者可以配合,但不意味着每个项目都要额外安装三套框架。
三、Spec Kit 和 OpenSpec,应该怎么选
两者都支持规范驱动开发。选择时,更值得比较的是它们组织工作的方式。
Spec Kit 更适合希望明确建立项目原则和开发步骤的团队。
它提供从项目宪法、需求规格,到计划、任务和实现的流程。团队可以在进入下一阶段前审阅产物,逐步明确要做什么、怎样做以及如何拆分工作。Spec Kit 官方说明
OpenSpec 更适合围绕具体变更组织工作。
它将提案、需求、设计和任务放在一次变更中,完成后再归档,并明确强调对已有项目的支持。对于持续增加功能、修复问题和调整既有行为的产品,这种组织方式值得评估。OpenSpec 官方说明
可以按下面的偏好做第一轮选择:
| 团队更看重什么 | 优先评估 |
|---|---|
| 明确项目原则,建立共同的规格与计划流程 | Spec Kit |
| 围绕一个个版本变更推进开发 | OpenSpec |
| 希望采用阶段清晰、逐步审阅的工作方式 | Spec Kit |
| 希望把某次修改的原因、方案和任务集中管理 | OpenSpec |
这是基于工作方式的建议。两者都可以用于新项目和已有项目,也都在持续扩展能力,不能简单按"新项目用谁、老项目用谁"来划分。
我更建议用同一个真实需求分别试一遍,比较文档维护成本、团队理解程度和修改需求时的操作是否顺畅。
四、用了 OpenSpec 或 Spec Kit,还需要 Trellis 吗
取决于团队还缺少什么。
如果现有 AI 编程工具已经能够支持正常开发,团队也能清楚记录需求、进度和测试结果,那么可以先使用选定的规范流程。
当问题进一步变成下面这些情况时,Trellis 更值得考虑:
- 开发跨越多个会话,进度和决策经常需要重新解释。
- 多个人、多个工具参与,项目知识分散。
- 希望统一任务状态、上下文加载和工作记录。
Trellis 将规范、任务及日志保存在仓库中,并通过平台适配机制组织 AI 工作流。它覆盖的范围包括共享规范,也包括项目知识和执行过程。Trellis 架构说明
但引入 Trellis,也意味着团队需要维护它的工作方式。
如果同时采用 Trellis 和 OpenSpec,需要提前明确:需求放在哪里、任务状态以哪一处为准、完成后更新哪些文件。这属于组合方案的设计工作,不能默认安装后就会自动协调好。
五、如果只是同步"宪法约束",可以从更直接的方案开始
对于"同一套工程规则,要让 Codex、Cursor、Claude Code 都能使用"的需求,我会先评估 Rulesync。
它支持从统一来源生成不同工具的配置,也支持导入已有配置,范围覆盖规则、Skills、MCP 等内容。Rulesync 官方说明
Ruler 也是可选方案:集中维护 Markdown 规则,再分发到支持的工具。它的核心思路比较直接。Ruler 官方说明
这里需要区分两个目标:
- 配置一致: 各工具获取同一版本的规则。
- 结果符合要求: 最终代码通过测试、静态检查和人工评审。
同步工具主要帮助解决前者。即使规则已经正确分发,仍然需要验证实际代码。
对于已经采用 OpenSpec 或 Spec Kit 的团队,可以保留现有开发流程,只补充需要的配置同步能力。组合时,为每个生成文件指定唯一的管理工具,避免相互覆盖。
六、按当前问题选,而不是一次装齐
如果现在要给一个团队做第一轮选型,我会使用下面这张表:
| 当前最突出的问题 | 建议起点 |
|---|---|
| 多个 AI 工具的工程规则不一致 | Rulesync;也可以对比 Ruler |
| 需求到实现的步骤不清楚 | Spec Kit |
| 已有产品持续迭代,变更内容难追踪 | OpenSpec |
| 多会话、多成员协作时,上下文和进度难延续 | Trellis |
| 规则写得很完整,交付质量仍然不稳定 | 先补充测试、检查与评审机制 |
以上是根据官方文档做出的适配判断,最终还需要在实际客户端和项目中验证。
试点时,可以只选一个项目、一个真实需求,再观察三个结果:团队是否少了重复解释,规则是否得到正确加载,交付前是否有明确的验证证据。
下一轮是否增加工具,就根据这三个结果决定。