Harness Inspector：让 Agent 交付过程可观察、可检查、可追溯
内容提要
Better Harness 推出 Harness Inspector，将 Agent 交付拆分为 Story（意图）、Session（过程）、Commit（产出）三段，并在本地只读界面中连接展示。它提供 Workbench（看关系）、Trace（看结构）、Replay（看顺序）三种视图，帮助追溯一次软件变更的起因、执行过程与最终产出。作者指出，SKILL 沉淀不应只总结单次会话，而应从多次真实交付中识别稳定、可验证的工作路径。
延伸解读
从会话调试到交付链路：观察对象的转变
文章指出，Harness Inspector 最初只是会话调试工具，用于查看 Agent 说了什么、调用了哪些工具、修改了哪些文件。但随着 Session、文件活动和 Git 历史被连接起来，作者意识到真正需要观察的不是会话本身，而是一次软件变更如何从意图出发，经过执行，最终形成可进入工程系统的产出。这一转变意味着观察对象从孤立的对话记录扩展为包含 Story、Session、Commit 的完整交付链路，Session 只是中间部分。
证据图而非流水线：关系展示的克制设计
文章强调，虽然叙述上交付是一条连续链路，但在真实项目中它更接近一张证据图：一个 Story 可能经历多个 Session，一段 Session 也可能涉及多个 Commit。Workbench 视图关注的是展示需求、过程和产出之间已经观察到的关系，当关系证据不足时，Inspector 会将其保留为候选或未映射，而不是自动拼出一条看起来完整的交付路径。这种克制设计避免了过度推断，让检查者能区分已证实与待确认的关联。
只读回放的边界：不重跑、不补全
Replay 视图沿着已保留的事件逐步回看任务如何展开，但文章明确其边界：它只是一次只读的证据回放，不会重新运行工具、恢复工作区或继续原来的 Session；对于没有精确时间的内容，也只保留顺序，不会补充没有被记录的过程。Trace 同样不试图还原模型未暴露的思考过程，而是将已记录的行为重新组织成可阅读的工作轨迹。这些限制提醒读者，Inspector 提供的是基于记录证据的检查，而非对 Agent 内部状态的完整还原。
SKILL 沉淀的前提：先看清交付，再识别稳定路径
文章指出，值得沉淀成 SKILL 的经验不是出现次数最多的 Tool Call，因为反复读取同一文件或不断重试命令更可能是噪声。真正值得沉淀的，是能在相似任务中重复出现、并得到最终产出与验证结果支持的工作路径。只有把行为放回对应的 Story、Session 和 Commit 中，才能判断它是偶然选择还是可迁移的工作方式。因此，SKILL 自动沉淀需要从多次真实交付中识别稳定模式，而 Inspector 当前解决的是最基础的一环：让真实交付留下边界清晰、可检查的证据。
Q&A
Harness Inspector 是什么？它主要解决什么问题？
Harness Inspector 是一个面向 Agent 交付过程的本地、只读工作台。它将需求、Agent Session、文件活动和 Git Commit 放在同一个交互界面中，用来检查一次软件变化为什么发生、怎样发生，以及最终留下了什么。它解决的是仅看 Session 无法判断行为原因和最终产出，仅看 Commit 无法了解执行过程的问题。
Harness Inspector 如何拆解一次 Agent 交付？
它将一次 Coding Agent 的交付拆成三个连续但边界不同的部分：Story（意图）、Session（过程）和 Commit（产出）。Story 说明为什么要修改，Session 展示修改是怎样发生的，Commit 记录最后留下了什么。
Harness Inspector 提供了哪几种视图？各自有什么作用？
它提供三种视图：Workbench 看关系，展示需求、过程和产出之间已观察到的关系；Trace 看结构，按 Turn 组织用户输入、中间回复、Tool Call 和文件活动，并折叠重复活动；Replay 看顺序，沿着已保留的事件逐步回放任务如何展开。
如何使用 Harness Inspector 生成查看页面？
在项目目录执行命令：npx @qoder-ai/better-harness inspector，即可生成一个本地、只读的 Harness Inspector 页面，把当前项目中的 Agent Session、文件活动和 Git Commit 放到同一个交互界面里。
为什么不能只靠 Session 来沉淀 SKILL？
因为 Session 只能记录 Agent 做了什么，却无法单独解释任务为什么开始，也不能证明哪些行为最终形成了工程产出。出现次数最多的 Tool Call 可能是噪声（如反复读取同一文件或重试失败命令），真正值得沉淀的是能在相似任务中重复出现、并得到最终产出与验证结果支持的工作路径。
Harness Inspector 如何帮助 SKILL 自动沉淀？
它先让真实交付留下边界清晰、可以检查的证据，将需求、Session、文件活动和 Git Commit 重新连接起来。在此基础上，才能从多次真实交付中识别稳定模式，为它补充适用场景、上下文边界、执行步骤和验证方式，进而形成 SKILL 候选并在后续交付中验证。
