Harness Inspector：让 Agent 交付过程可观察、可检查、可追溯
内容提要
Better Harness 的 Harness Inspector 工具将需求、Agent 会话、文件活动和 Git 提交整合到统一界面，以完整追踪从意图到代码交付的链路。它提供三种观察方式：Workbench 查看整体关系，Trace 展开会话结构，Replay 按顺序回放事件。该工具旨在识别稳定工作路径，为自动沉淀可复用 SKILL 奠定基础。
延伸解读
为什么只看 Session 不够
文章指出，仅查看 Agent 的 Session 只能看到它做了什么，却无法判断行为为何发生，以及哪些行为真正进入了最终交付。例如，Agent 可能因上下文不足而反复读取同一文件，或因命令失败不断重试，这些频繁出现的行为更可能是噪声而非值得复用的经验。因此，需要将需求、Session 和 Commit 连接起来，才能完整理解一次交付。
三种观察方式的分工
Harness Inspector 提供三种观察方式：Workbench 看整体关系，展示需求、过程和产出之间的映射；Trace 看会话结构，按 Turn 组织事件并折叠重复活动；Replay 看事件顺序，只读回放不重新运行工具。三者互补，帮助 Reviewer 从不同层面检查交付，但都不试图还原模型未暴露的思考过程。
SKILL 沉淀的真正标准
文章强调，SKILL 自动沉淀并非简单总结 Session，而是从多次真实交付中识别稳定模式。值得沉淀的路径通常是在相似任务中重复出现，并得到最终产出与验证结果支持的工作方式，例如如何确定修改边界、建立上下文、执行验证。Inspector 当前解决的是基础环节：让真实交付留下边界清晰、可检查的证据。
Q&A
Harness Inspector 是什么？
Harness Inspector 是 Better Harness 的一个本地、只读工作台，它将需求、Agent 会话、文件活动和 Git 提交整合到统一界面，用于追踪从意图到代码交付的完整链路。
如何启动 Harness Inspector？
在项目目录下执行命令 `npx @qoder-ai/better-harness inspector`，即可生成一个本地、只读的 Harness Inspector 页面。
Harness Inspector 提供哪三种观察方式？
Harness Inspector 提供三种观察方式：Workbench（查看整体关系）、Trace（展开会话结构）和 Replay（按顺序回放事件）。
Workbench、Trace 和 Replay 分别有什么作用？
Workbench 展示需求、Agent 行为和 Git 提交之间的整体关系；Trace 按 Turn 组织会话中的用户输入、回复、工具调用和文件活动，并折叠重复操作；Replay 按顺序回放事件，帮助审查者观察任务如何展开。
Harness Inspector 如何帮助识别可沉淀的 SKILL？
通过将需求、会话和提交关联起来，Harness Inspector 帮助识别稳定且得到产出验证的工作路径，这些路径更可能成为可复用的 SKILL，而不是频繁出现的噪声行为。
为什么只看 Session 不足以理解 Agent 的交付过程？
因为 Session 只记录了 Agent 做了什么，但无法解释任务为什么开始，也无法证明哪些行为真正进入了最终交付。只有结合需求（Story）和 Git 提交，才能完整理解交付链路。
Harness Inspector 如何处理关系证据不足的情况？
当关系证据不足时，Inspector 会保留为候选或未映射状态，而不是自动拼凑出看似完整的交付路径。
Harness Inspector 的 Replay 功能是否会重新运行工具或恢复工作区？
不会。Replay 只是只读的证据回放，不会重新运行工具、恢复工作区或继续原来的会话，也不会补充未被记录的过程。
