SuperAPI AI 工具集

agent-instruction-hygiene

智能体与模型

查看项目

更新于 10-16 05:07

技能介绍

用途:当指令体系本身成为设计对象时使用该技能,目标不是记录所有经验,而是让未来的智能体指向最小、持久且能改变行为的指令。

主要能力:审查 AGENTS.md、CLAUDE.md 和 .agents/skills,识别指令膨胀、重复指引、路由重叠与流程细节放错位置的问题;通过放置规则决定内容应放在 AGENTS.md、SKILL.md、references/、scripts/、CLAUDE.md 还是删除。

放置规则:AGENTS.md 承载所有智能体在任何技能被选中前都必须携带的规则;SKILL.md 承载由具体用户意图触发的可重复工作流;references/ 存放仅在需要时加载的长示例或条件细节;scripts/ 存放更适合由代码完成的确定性脆弱工作;CLAUDE.md 通常是兼容垫片,一般只写 @AGENTS.md;一次性建议、品味备注或已被他处拥有的规则应删除。若已有技能拥有相同用户意图,不应新建技能,而应更新现有技能、收窄其描述或把细节移入 reference。

使用方式:先写出产品句——AGENTS.md 路由始终生效的仓库约束;技能拥有可触发工作流;references 保存条件细节;CLAUDE.md 垫片导入 AGENTS.md。若拟议指令不符合该句,先改放置位置再改文字。随后按顺序自问:防止什么重复失败、哪个未来提示应触发、哪个近似提示不应触发、谁必须在每个任务中携带该文本、哪个现有指令已拥有该行为、什么可删除或移入 references 或缩短、新形态是否减少加载上下文。默认在“曾经有用一次”时删除,在“相同触发、更锐利行为”时更新现有技能,仅在“独立触发、可重复工作流且总路由成本更低”时新建技能。

输出形态:编辑前按指令句、当前表面、漂移、决定、为何降低复杂度报告。

最终检查:对变更或新增技能运行 bun x --package skills skills add /Users/braden/Code/epicenter/.agents/skills --skill <skill-name> --list;对触及的指令文件运行 git diff --check;按 writing-voice 标点规范检查文字;仅在用户要求时暂存特定文件。

限制:资料未提供该技能的收费、平台支持范围或效果保证。