代理指令维护
概述
保持代理指引的范围明确、可发现,并源自单一规范来源。在修改指令内容、适配器、部署或验证之前,应用共享维护策略。
用法
在修改全局或项目指令、特定代理规则文件以及暴露这些规则文件的配置时使用此技能。例如:$agent-instructions add a Codex instruction source。
步骤
- 完整阅读
references/maintenance.md。 - 检查现有的指令层次结构以及受该更改影响的每个发现路径。
- 选择一个规范来源,并将特定代理位置保持为投影或适配器。
- 更新所有消费该来源的安装程序、生成文件、索引和验证屏障。
- 独立验证每个受影响的代理投影。
易错点
- 将条件性指引放入始终加载的指令中——每个任务都会付出上下文成本;对于支持渐进式披露的代理,应将其作为技能暴露。
- 将名称相同的机制视为等同——Claude Markdown 规则和 Codex 命令规则具有不同的语义;验证消费者发现契约。
- 仅更新一个投影——另一个代理会静默地保持过时行为;枚举每个声明的消费者并测试其实际目的地。
约束
- 为共享指令行为维护一个规范来源。
- 切勿将条件规则作为兼容性垫片注入始终加载的指令文件中。
- 除非检查了实际部署的目标,否则切勿报告投影处于健康状态。