Agent 设计与改进

围绕实际任务，帮助设计 Agent 完成目标所需的能力、指令与协作方式，并通过执行证据发现问题、检验取舍和改进效果。

先理解设计原理，再通过设计地图选择优化方向，最后进入具体专题形成方案；改动效果通过任务证据检验。

表达、链接与结构调整做对应检查；涉及行为效果的主张使用任务证据。只要求讨论或文档编辑时，不自动调用模型、安装或发布。

何时用

• 判断任务是否需要 Agent，比较模型、程序、人的分工和工程机制。
• 设计或改进 Agent 的指令、工具、上下文与任务推进方式。
• 创建、评审或修改 Skill，包括能力定位、入口组织和文档写法。
• 根据执行偏差定位原因，设计测试、比较方案或验证改进。
• 调优本地模型部署，比较上下文、缓存、MTP 等设置对容量与速度的影响。

何时不用

• 单纯的框架接入、业务实现或非模型推理的环境排障：结合对应项目和工具处理；其中涉及的 Agent 设计取舍可使用本 Skill。
• 通用文档的组织、表达与可用性改进：使用 document-writing Skill；Skill 的能力定位与行为设计仍属于本 Skill。
• Skill 发布、同步和 runtime 管理：使用目标环境已有的维护能力。
• 普通任务执行，仅仅使用了 Agent、工具或 Skill，不需要调用本 Skill。

阅读路径

完整阅读按以下顺序展开：

1. 设计原理：理解完成任务的条件、持续推进的过程、工程分工与评价依据。
2. 设计地图：依据速度、成本、效果和具体场景，找到可选的优化方向及其取舍。
3. 下方专题：围绕选定方向，进一步设计指令与工具、创建或改进 Skill、调整模型部署，并验证结果；维护本 Skill 时查阅维护说明。

已有明确问题时，可直接进入对应专题；需要重新判断原因或方向时，再回到原理和地图。

专题索引

当前需要	读取	得到什么帮助
设计或改进指令、上下文与工具	指令与工具设计	指令约束、信息组织、工具契约与反馈
创建、评审或修改 Skill，包括局部修改与整体重写	Skill 设计原则	确定能力、入口与资源；按其中的“编写依据”读取写作原则和模板
Skill 不触发、读错资料、执行偏差或组合失效	Skill 问题诊断	用对照区分发现、路由、内容与交接问题
本地模型生成慢、内存紧张，或要理解缓存、MTP 等调优取舍	模型本地部署调优	理解容量与速度的影响因素，选择调整项并比较效果
设计测试、比较方案，或根据结果判断改动是否有效	测试与迭代	明确待测问题、输入与标准，安排执行、评审和下一轮
已确定测试目的与标准，需要用 Pi + Docker 执行	Agent 测试使用指南	准备 Case、模型配置和多组 Input，运行批次并查回证据
修改本 Skill 携带的全局行为准则，或核对发布差异	Skill 维护说明	确认源文件、发布钩子的全局写入范围及核对方式；发布与同步使用环境已有的维护能力

创建或修改任何 Skill 前，必须先读Skill 设计原则。 再按其中的编写依据，读取本次修改涉及的入口模板、文档写作原则或脚本规范后动手。此要求同样适用于局部修改。