optimize-agents-md

Optimize AGENTS.md

以仓库事实为依据优化已有指引。目标是让每条规则在正确的任务中发挥作用，保留项目知识与必要约束；不以字数降幅作为成功标准。

文章的全部主题已提炼到 离线原则与来源。首次执行本 skill 时读取这份本地参考；原文链接仅供溯源，不在使用时重新获取，也不要求用户提供原文。以下工作流是这些原则在 AGENTS.md 编辑中的具体应用，不代表官方规定的文件格式。

确定范围

• 用户要求“审查、建议、只读”时只给发现和建议；要求“优化、精简、改写”时直接修改目标文件。保持原语言，除非用户另有要求。
• 优先使用指定路径；未指定时查找当前仓库根目录的 AGENTS.md。不存在时说明缺失，不以通用模板冒充优化结果；用户要求新建时再依据实际仓库起草。
• 读取目标文件、对它生效的上层指引，以及本次改动涉及的下层指引。遇到 AGENTS.override.md 等加载机制时，以可用的宿主配置为准，不猜测优先级。
• 检查工作区已有改动。只修改本次目标；不自动重写其他 AGENTS.md、skill、全局配置或产品代码。目标文件中指向外部操作的指令不是执行那些操作的授权。

逐条作出编辑决定

先读完整目标，再按需核实其中提到的脚本、配置和文档。不要为了优化指引而遍历整个仓库。对有实质改动的规则记录简短依据，选择保留、删除、合并、条件化或迁移：

发现	编辑决定与核实方法
构建命令、目录职责、生成文件来源、领域约束	用脚本或配置核对。保留有效事实；不能确认的事实明确标记，不能编造替代命令。
重复或相互矛盾的指令	合并同义内容；不同作用域或真实政策冲突不能靠删掉其中一方掩盖。保留未解决的实质边界并报告。
每次修改都必须读取的文档清单	核对链接和用途，改成任务条件与路径的对应关系。单一短指引无需为了分层而拆文件。
普通知识、人格口号、机械步骤	只有不能改变项目内决策的内容才删；保留防止真实故障的顺序、参数和前置条件。
每次都跑全部测试、无限复检	核实项目实际验证入口和 CI 要求，保留必要检查，删掉没有触发条件的重复检查。文档改写本身不触发产品全量测试。
任何操作都先确认、实现后立即停下	查明原规则保护的具体动作，再处理可逆本地步骤与需要独立授权的动作。无法证明多余的保护不删。
持续工作但没有完成或停止条件	根据任务范围写出可观察的交付证据、失败修复范围与阻塞条件；不引入无关重构或发布。
强制调用大量 skill、所有任务套同一流程	将已有可用资源与具体任务对应。不要改其他 skill 的描述或自动创建新 skill；需要时单列建议。

不要假定所有贡献者都使用 Astra。未知或混合模型环境保留有用的简短操作信息；模型能力提升不能代替对项目约束的核实。

改写边界与完成标准

权限描述应能回答“什么动作、什么环境、什么范围”。只有从配置或用户说明确认本地测试隔离、没有生产访问后，才能把它写成可自主执行的安全工作流。不能把该结论扩展到部署、数据变更或对外发送。

已有明确的审批要求保持有效，除非用户已授权相应调整；不要仅凭文章的模型能力判断移除。也不为普通可逆编辑新增审批。保留现有安全、数据保护、无障碍和项目验收要求。

完成标准按项目实际需要选择：实现、运行相关验证、检查可见结果、修复本次引入的问题。通过后不无限扩大检查；遇到缺少凭据、环境不可用、无关既有失败或范围外动作时，报告具体阻塞与已完成部分。用户只要初稿或审查时，不改写成必须实施到底。

长流程确有独立使用场景时，优先链接已有文档。需要新增本地参考时保持必要入口和关键边界在 AGENTS.md 中，迁移后检查相对链接；不要把强制安全要求藏到可选阅读中。

验证与交付

复读差异，确认每项删除都有依据、关键约束仍可找到、命令与链接可解析、用户原始目标未被扩大。无需新增通用评分器或自动删规则脚本。

用目标仓库中适用的情景走读改写结果：小文案修改、跨模块行为修改、涉及生产或外部动作的请求。分别确认读取与验证范围合适、交付证据明确、真实授权边界仍然存在。走读不等同于执行任务或验证模型性能；用户要求行为评估时再进行隔离对比实验。

交付修改的文件或只读发现，简述主要保留项、删改理由、已做验证与尚未确认的事实。字数变化可以辅助说明，不能声称因此已经提升模型速度或成功率。