mcpField
H
harness

harness

github.com/tomgrvAgent 工作流0122 次安装4 天前更新
代码仓库

关于 harness

Harness 是一项以代码仓库为中心的技能,用于保存项目状态并指导跨会话工作。它通过进度和功能文件记录优先级、验证证据与交接信息,同时以仓库规则为准。

主要功能

  1. 01在仓库文件中记录进度
  2. 02跟踪功能与验证证据
  3. 03依据会话状态恢复工作
  4. 04遵循仓库自身规则
  5. 05独立核查完成声明

适用场景

  1. 01建立持久化项目跟踪
  2. 02在新会话中恢复未完成工作
  3. 03凭记录证据核验功能完成情况

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/tomgrv/devcontainer-features --skill harness

安装后在 Claude Code 中输入/harness确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

templates/
clean-state-checklist.md
session-handoff.md
progress.md
features.json

详细介绍

仓库是唯一可信的数据源,聊天记录不是。必须跨会话保留的状态应存放在文件中;新会话应通过读取这些文件恢复状态,而不是靠猜测。内容基于 Learn Harness Engineering。

初始化(每个仓库仅需一次,跳过已存在的文件)

从此文件旁边的 templates/ 中复制文件,然后进行调整——不要留下占位符:

  1. .agents/progress.md — 会话日志和当前已验证状态。
  2. .agents/features.json — 每项面向用户的功能,包含 id、priority、status、verification 步骤和 evidence。根据仓库的 README、议题和代码编写真正的功能;初始状态均为 not_started。
  3. 大型会话可选:将 templates/session-handoff.md 复制为 .agents/handoff.md。

依赖项由 devcontainer 功能安装,不在此处安装;基准状态是仓库开发平台(GitHub、GitLab、Azure DevOps)上的 CI 状态,钩子会打印该状态。在 .agents/features.json 中为每项功能填写实际的验证步骤。将这些文件作为一次更改提交。.agents/progress.md 或 .agents/features.json 一旦存在,SessionStart 钩子就会打印状态,Stop 钩子则会检查交接记录。

会话开始

  1. pwd — 确认仓库根目录。
  2. 阅读仓库自身的规则:CLAUDE.md、AGENTS.md、.agents/instructions/*.instructions.md(SessionStart 钩子会列出哪些文件存在)。这些规则对提交格式、PR 基础分支和标题、范围限制及工具仍具有权威性;harness 会在此基础上增加工作循环,绝不会覆盖这些规则。
  3. 阅读 .agents/progress.md,然后阅读 .agents/features.json。
  4. 运行 git log --oneline -5。SessionStart 钩子已打印状态和分支的 forge CI 状态。
  5. 分支上的 CI 未通过?这就是基准状态:先修复它。从故障状态开始时,不要开展新工作。
  6. 选择优先级最高的未完成功能,并将其设为 in_progress。一次只处理一项。

工作期间

  • 工作时遵循仓库规则(尽量减少更改、遵循提交和 PR 格式、保持 CI 命名规范)。如果规则与 harness 冲突,以仓库规则为准;在进度日志中记录冲突。
  • 专注于所选功能。遇到阻碍时,可进行一项范围有限的辅助修复。
  • 标记为 passing 前,必须实际运行该功能的 verification 步骤,并记录证据(命令及结果,而不是“看起来没问题”)。
  • 绝不要为了通过而改写、删除或弱化功能或测试。功能进行期间绝不要放宽验证要求。
  • 声明已完成?运行 harness-evaluator Agent:使用全新上下文,尝试证伪该声明。

会话结束

  1. 更新 .agents/progress.md:记录已验证状态、运行过的内容、证据、已知风险和下一步最佳行动。
  2. 更新 .agents/features.json 中的状态和证据。
  3. 按照 templates/clean-state-checklist.md 逐项检查。
  4. 仓库可以安全恢复工作后,按照仓库规则中的提交和 PR 规范进行一次提交。分支上的 CI 必须全部通过,或在进度日志中说明原因;下一个会话开始时不应需要手动修复。

边界

不要编造功能、证据或验证结果。没有运行过就不要标记为 passing。不要通过编辑列表来掩盖未完成的工作。

评论

支持 Markdown