小节一:AGENTS.md 到底解决什么——它不是能力说明,而是“当前项目的合同”
先对照下面这张图看两类信息:通用能力说明告诉 Agent 大体会做哪些事,而项目合同约束它在这个仓库里应该怎样做。同样是修 Bug,换个项目,测试命令、依赖策略和允许修改的位置都可能完全不同...
AGENTS.md:给不同项目定义不同规则
上一节,我们刚刚把 Agent 的通用能力拆成了 Skills。 例如: skills/ ├── python-debug/ │ └── SKILL.md ├── flask-project/ │ └── SKILL.md └── data-analysis/ └── SKIL...
章末自测
题目 1:为什么“把所有能力都写进 System Prompt”不是一个可持续的 Agent 设计? 请从 Context、规则冲突、维护和复用四个角度解释。 所有能力都写进 System Prompt 会让每次请求都携带大量无...
案例分析二:Data Analysis Agent 为什么只加载 data-analysis,而不是同时带上所有 SQL、Flask、Python Skills?
第二个案例关心的不是如何新增 Skill,而是怎样避免过度加载。图中用销售分析任务举例:目录里虽然有多种能力,但选择器应先围绕当前分析目标筛出必要的说明。 本节“昨天收入下降”的问题也一...
案例分析一:Python Debug Skill 如何避免每次都把调试经验写进 System Prompt?
前面讲了不少设计原则,这里用 Python Debug 把它们落到实际任务上。假设用户只需要修一个导入错误,我们真正希望加载的是一套可靠的调试步骤,而不是让模型每次重新从一大段通用 Prompt 中找办...
小节五:Skill、Tool、Memory、AGENTS.md 到底有什么区别——四个概念一定别混
这些名称都可能出现在 Agent 的上下文或执行链路里,所以初学时很容易把它们统称为“Prompt”。把几个概念并排比较,会更清楚每个东西在解决哪一种问题。 看图时尤其注意:Tool 是执行动作的接...
小节四:Skill 怎么动态加载——不要让模型“想加载什么就加载什么”,要有 Selector 与预算
假设 Skill 目录里已经有 Python 调试、Flask 项目和数据分析等多个能力,下一步就不是“全部读进来”,而是先根据用户任务选出相关项。这张图把选择过程拆成了几步,也把预算放到了合适的位置...
小节三:实现 SkillLoader 和 SkillRegistry——把 Skill 从文件系统真正加载进 Agent
前面已经写好了 Skill 文件,接下来要解决的是“文件如何变成运行时可用的能力”。下图把文件目录、Loader、Registry 和 Agent 放在一条线上,能帮助我们理解为什么仅有 SKILL.md 还不够。 Sk...
小节二:SKILL.md 应该怎么设计——不要写成知识百科,要写成“可执行能力说明”
开始写 SKILL.md 之前,可以先看它到底要回答哪些问题。一个适合执行的 Skill,不需要把相关知识全部抄进去,而是要让 Agent 知道何时启用、按什么顺序做、哪些动作要避免,以及做到哪里算完...
小节一:为什么 Prompt 不应该承担所有能力——Context 膨胀只是表面,真正问题是“能力耦合”
如果把调试、分析、写作等任务的规则长期堆在同一份 Prompt 里,最直观的现象是 Context 变长,但麻烦不止于此。下面把几类问题摆在一起,就能看出为什么这一章要把能力单独拆出来。 无关规则占...













