从 Trellis 看 AI 研发工具选型:OpenSpec、Spec Kit 与 Harness 如何配合

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
规则写得很完整,交付质量仍然不稳定 先补充测试、检查与评审机制

以上是根据官方文档做出的适配判断,最终还需要在实际客户端和项目中验证。

试点时,可以只选一个项目、一个真实需求,再观察三个结果:团队是否少了重复解释,规则是否得到正确加载,交付前是否有明确的验证证据。

下一轮是否增加工具,就根据这三个结果决定。

相关推荐
FungLeo1 小时前
成为全栈·Vue 管理后台篇·可折叠侧栏与移动抽屉:后台导航的响应式实现
前端·javascript·vue.js·侧边栏·响应式布局·无障碍·移动端导航
deli0073 小时前
翻到第 1000 页为什么卡?LIMIT OFFSET 与游标分页实测
前端
johnjincaaaa3 小时前
猿人学第22题「初识-魔改标准算法」逆向实录:jsconfuser 混淆下的 AES + MD5 魔改还原
前端
deli0073 小时前
马赛克打多粗才安全?8 档像素块 PSNR 实测,脸还认得出吗
前端
JianZhen✓3 小时前
IM 聊天列表为什么总“消息乱跳“:有序插入、时间轴派生、本地截断、已读回执
开发语言·前端·php
deli0073 小时前
为什么 5 个人 5 把叉子会全卡住?deadlock 四条件逐项实测
前端
闻缺陷则喜何志丹3 小时前
可视化前端Web组态软件
前端·数字孪生·可视化·web组态·吾乐吾
哈士奇冲鸭4 小时前
实战:AG-Grid 在 qiankun 下的 CSS 命名空间隔离
前端
哈士奇冲鸭4 小时前
实战:qiankun 微前端主题隔离,把 data-theme 从 html 挪进自己的容器
前端