principle-guard-the-context-window

守护上下文窗口

一次会话中的上下文窗口有限，且无法续用。每个 token 都应物有所值。

**原因：**上下文溢出会降低推理质量、造成压缩失真，并让进度停滞。

模式：

• 隔离大型负载。 将冗长输出、屏幕截图和大型文档交给子 Agent 处理。主上下文只接收摘要，而非原始数据。只读扫描或解析若返回的是精简结果，则使用 routine 角色，除非调用该技能明确指定了其他角色。使用 pstack-harness 技能的 Spawn a role 部分来确定角色。
• 将常用内容内联。 每次调用都会用到的模板和参考资料应放在技能文件中，而不是放在每次读取都要耗费上下文的独立文件中。
• 控制各阶段规模并限制范围。 限制每个阶段处理的文件数量，设定轮次预算，并考虑机制成本。
• 精简返回内容。 如果子 Agent 的报告会用于你的下一步操作，其任务说明应指出完整报告的存放位置（子 Agent 写入的文件或 PR），并要求只返回结论或状态行、任何阻碍，以及该路径或 URL。只有为了解决阻碍时才阅读完整报告。若子 Agent 的输出就是你要转交的交付物，例如 how 说明、why 综合分析、trail 审查者的标记，或 arena 交叉评审者的评分，则应完整返回。
• 控制主负责人的读取量。 除非你要编辑文件，否则超过约 150 行的文件或命令输出应交给子 Agent 处理。使用 head、tail、grep 或 --jq 精简命令输出，再将其传给你。除非即将编辑某个文件，否则不要重新阅读 how 阶段已梳理过的文件。工作手册或技能步骤分配给你阅读的内容（例如 Code review 中的变更文件、Eval 的候选输出，或 show-me-your-work 的转录审查）不受此限制。
• 阅读步骤，而非整本工作手册。 打开任务清单时，应使用 awk '/^[0-9]+\. /{p=1} !p && !/^#/ && NF {print; next} p && /^[^ ]/ && !/^[0-9]+\. /{exit} p' <playbook>，打印工作手册中步骤 1 之前的正文以及带缩进子项的编号步骤，而不是读取整个文件。步骤 1 前的正文是任务清单的第一项。如果该正文要求完整阅读工作手册，则应完整阅读。