用途：为智能体将要调用的工具、脚本和 CLI 设计接口，让接口本身教会使用方法，而不是依赖大段说明和示例。资料指出，示例只教会一条路径并悄悄封死其他路径，展示三种调用方式，模型往往只会产出这三种；好的接口能一次性教会整个空间。
主要能力与做法：先查清工具实际被误用的方式，再动手重设计，可读对话记录、日志或用户反馈；误用首先是接口症状，其次才是文档症状，修复通常是改名或改类型，而非加一段文字。把含义推进参数：用枚举代替自由文本，例如状态 pending | in_progress | completed 无需一句话就教会整个状态机；按意图而非实现命名，让正确的调用读起来就是对的；在类型系统允许处让非法状态无法表达，无法表达的错误就不需要警告。把行为指令放在工具自身的描述里、使用点上，且只放那里；同一指引在全局前言里重复，是代码库产生矛盾的方式。想加用法示例应视为诊断信号，通常意味着某个参数定义不足，先修接口；只有真正无法猜出的格式（如自定义查询语法）才保留示例。区分常驻与可发现：多数轮次都需要的工具放进上下文，很少用的按需可查，不用时不占成本。最后指出设计仍允许的错误，并说明它是否便宜到可以接受，还是需要显式护栏。
限制与护栏：需要解释参数含义的描述，说明参数该改名；不可逆和高风险操作是上述原则的例外，那里显式约束与确认优于优雅；重设计签名前必须先找出所有现有调用方；简洁不是目标，表达力才是，删掉承载真实行为的描述比描述过长更糟。资料未提供具体安装命令、代码示例或平台信息。