关于 harness
Harness 是一项以代码仓库为中心的技能,用于保存项目状态并指导跨会话工作。它通过进度和功能文件记录优先级、验证证据与交接信息,同时以仓库规则为准。
主要功能
- 01在仓库文件中记录进度
- 02跟踪功能与验证证据
- 03依据会话状态恢复工作
- 04遵循仓库自身规则
- 05独立核查完成声明
适用场景
- 01建立持久化项目跟踪
- 02在新会话中恢复未完成工作
- 03凭记录证据核验功能完成情况
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ tomgrv/ devcontainer-features --skill harness安装后在 Claude Code 中输入/harness确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
templates/clean-state-checklist.mdsession-handoff.mdprogress.mdfeatures.json详细介绍
仓库是唯一可信的数据源,聊天记录不是。必须跨会话保留的状态应存放在文件中;新会话应通过读取这些文件恢复状态,而不是靠猜测。内容基于 Learn Harness Engineering。
初始化(每个仓库仅需一次,跳过已存在的文件)
从此文件旁边的 templates/ 中复制文件,然后进行调整——不要留下占位符:
.agents/progress.md— 会话日志和当前已验证状态。.agents/features.json— 每项面向用户的功能,包含id、priority、status、verification步骤和evidence。根据仓库的 README、议题和代码编写真正的功能;初始状态均为not_started。- 大型会话可选:将
templates/session-handoff.md复制为.agents/handoff.md。
依赖项由 devcontainer 功能安装,不在此处安装;基准状态是仓库开发平台(GitHub、GitLab、Azure DevOps)上的 CI 状态,钩子会打印该状态。在 .agents/features.json 中为每项功能填写实际的验证步骤。将这些文件作为一次更改提交。.agents/progress.md 或 .agents/features.json 一旦存在,SessionStart 钩子就会打印状态,Stop 钩子则会检查交接记录。
会话开始
pwd— 确认仓库根目录。- 阅读仓库自身的规则:
CLAUDE.md、AGENTS.md、.agents/instructions/*.instructions.md(SessionStart钩子会列出哪些文件存在)。这些规则对提交格式、PR 基础分支和标题、范围限制及工具仍具有权威性;harness 会在此基础上增加工作循环,绝不会覆盖这些规则。 - 阅读
.agents/progress.md,然后阅读.agents/features.json。 - 运行
git log --oneline -5。SessionStart钩子已打印状态和分支的 forge CI 状态。 - 分支上的 CI 未通过?这就是基准状态:先修复它。从故障状态开始时,不要开展新工作。
- 选择优先级最高的未完成功能,并将其设为
in_progress。一次只处理一项。
工作期间
- 工作时遵循仓库规则(尽量减少更改、遵循提交和 PR 格式、保持 CI 命名规范)。如果规则与 harness 冲突,以仓库规则为准;在进度日志中记录冲突。
- 专注于所选功能。遇到阻碍时,可进行一项范围有限的辅助修复。
- 标记为
passing前,必须实际运行该功能的verification步骤,并记录证据(命令及结果,而不是“看起来没问题”)。 - 绝不要为了通过而改写、删除或弱化功能或测试。功能进行期间绝不要放宽验证要求。
- 声明已完成?运行
harness-evaluatorAgent:使用全新上下文,尝试证伪该声明。
会话结束
- 更新
.agents/progress.md:记录已验证状态、运行过的内容、证据、已知风险和下一步最佳行动。 - 更新
.agents/features.json中的状态和证据。 - 按照
templates/clean-state-checklist.md逐项检查。 - 仓库可以安全恢复工作后,按照仓库规则中的提交和 PR 规范进行一次提交。分支上的 CI 必须全部通过,或在进度日志中说明原因;下一个会话开始时不应需要手动修复。
边界
不要编造功能、证据或验证结果。没有运行过就不要标记为 passing。不要通过编辑列表来掩盖未完成的工作。
评论
支持 Markdown