神译局是36氪旗下编译团队，关注科技、商业、职场、生活等领域，重点介绍国外的新技术、新观点、新风向。 编者按：别再给Agent塞长文档了！掌握这套“数字实习生”管理框架，是让AI从玩具进化为生产力的硬核关键。 目标是编写一份清晰的规范，涵盖恰到好处的细节（包括结构、风格、测试和边界），在引导 AI 的同时避免信息过载。将大任务拆解为小任务，而不是把所有内容都塞进一个庞大的提示词中。先在“只读模式”下进行规划，然后再执行并持续迭代。 “我听过很多关于如何为 AI Agent 编写优秀规范的建议，但始终没发现一套成熟的框架。我也能写出堪比 RFC（征求意见稿）的详尽规范，但一旦上下文过长，模型就会开始‘罢工’。” 许多开发者都有这种挫败感。粗暴地将一份冗长的规范丢给 AI Agent 是行不通的——上下文窗口的限制和模型的“注意力预算”会成为阻碍。关键在于编写“聪明”的规范：这些文档既能清晰地引导 Agent，又能保持在实际的上下文容量内，并随项目同步演进。本指南总结了我在使用 Claude Code 和 Gemini CLI 等开发 Agent ...