企业官网建设流程全解析

Harness Engineering上下文管理指南：Just-in-Time路由让AI Agent告别信息过载

【免费下载链接】harness-engineering🐎 Ryan Lopopolo’s anthology, field guide, and agent context bundle for harness engineering项目地址: https://gitcode.com/gh_mirrors/har/harness-engineering

AI Agent 最常见的失败方式不是不够聪明，而是"喂得太饱"：把整本文档和代码库塞进提示词，只会让它注意力涣散、行为漂移。Harness Engineering（Ryan Lopopolo 的 Agent 上下文合集与实战指南）给出了答案——Just-in-Time（JIT）上下文路由：保持活跃上下文窗口小而精，让知识库可搜索，由任务在决策时刻拉取恰好需要的知识切片。本指南帮你用 4 个步骤为 AI Agent 搭建一套上下文管理系统，真正告别信息过载。

🎯 为什么 AI Agent 会"信息过载"？

很多团队的第一反应是"把更多知识塞进上下文"，但这条路会被两堵墙挡住：

• 上下文窗口再大，注意力也是稀缺的。检索质量、冲突指导的消解、"当前这一步哪个事实最重要"的判断，始终是最贵的资源。
• 确定性的上下文堆叠会失效。当任务经历多次上下文压缩（compaction）后，最初塞入的知识会丢失或被稀释，Agent 无法重新找回。

核心思路只有一句话（来自 docs/just-in-time-context/README.md）：

保持更大的环境可搜索，告诉 Agent 有哪些上下文、在哪里找到它，让任务在需要时拉入下一个相关切片。

也就是说：磁盘是无限的上下文池，提示词是小小的工作台。

🗺️ 用"地图"代替"手册"：AGENTS.md 的路由写法

Just-in-Time 路由的第一块拼图，是根目录的指南文件。它应该只包含 4 件事：

关键原则是逐级收窄：架构、决策、运行手册放在它所管辖的工作旁边；当 Agent 进入某个子包或子目录时，嵌套的指南让路由变得更窄。

本项目根目录的 AGENTS.md 就是活样板：它按"未解决的决策"选路由——例如"上下文过载时该用渐进式披露、技能还是运行手册"直接指向 docs/just-in-time-context/，并且明确"从 1 个论题开始读，只有出现独立的未决问题才加第二条路由"。

📚 四层知识分层：谁住在哪一层？

不同知识通过不同接口进入任务轨迹（见 docs/just-in-time-context/README.md）：

注意：权威数据留在它的主人那里，JIT 路由只负责为单个任务临时组合这些来源，而不把语料搬走。

⏱️ 三阶段投递：在对的时刻喂对的知识

上下文不是一次性给的，而是跟着工作轨迹分三次到达（docs/just-in-time-context/README.md）：

1. Grounding（落地期）：给一份精炼的地图——任务类型、相关架构与决策、关键路径、确认当前状态的命令。让 Agent 知道自己在改什么、该看哪里。
2. Messy Middle（混乱中段）：让代码、工具输出、测试失败、日志自己"揭示"下一块上下文。错误信息应直接指出违反了哪条不变量、以及最可能的修复方向。
3. Review and Landing（评审与交付）：产物成型后，再重新亮出验收标准、证据要求和交付策略，并把整条轨迹压缩成一份人类可直接评审的决策包。

这个时序让全局上下文保持小巧，同时把细节恰好放在"能改变决策"的位置。

✅ 快速上手：4 步给你的仓库搭一套上下文管理

• 第 1 步 · 写根地图：按上文 4 要素写根目录指南，拒绝"1000 页指令手册"。
• 第 2 步 · 给知识分层：照四层表把内容归位，权威记录不要抄进仓库。
• 第 3 步 · 按阶段投递：用嵌套指南、阶段专属的检查器和评审规则，控制细节出现的时机。
• 第 4 步 · 持续修剪路由：交叉链接要机器可检查；在全新会话里测试 Agent 能否检索到正确来源并改变行为；废弃路由替换为规范后继者或显式墓碑（见 docs/just-in-time-context/README.md）。

💡 两条实用边界：技能（skill）用来教方法——描述先广告"它是什么、为什么重要"，完整说明等轨迹需要时再加载；运行手册（runbook）用来保存可重复工作——记录意图、前置条件、步骤、安全边界、证据、回滚。

🚀 延伸阅读

• 完整论题：docs/just-in-time-context/README.md
• 12 个论题索引：docs/README.md
• 改善单个任务的上下文：playbooks/improve-harness.md
• 让工具能力可读可操作：docs/tool-legibility/
• 把反馈变成基础设施：docs/feedback/
• 原始来源库（文章、访谈、案例）：sources/

按这套 Just-in-Time 路由，你的 AI Agent 将只在小窗口里看到当前决策需要的切片，而完整的知识版图随时可以从磁盘上重新找回——上下文管理从此不再是体力活。

【免费下载链接】harness-engineering🐎 Ryan Lopopolo’s anthology, field guide, and agent context bundle for harness engineering项目地址: https://gitcode.com/gh_mirrors/har/harness-engineering