整理 Skill、AGENTS.md 或 CLAUDE.md 的结构、触发条件和完成标准，让指引更清楚。
安装与准备
在项目目录的终端执行以下命令，安装后在 Claude Code 中输入下方提示。这里选择项目内的可编辑文件安装。
npx skills@latest add mattpocock/skills --skill writing-for-agents --agent claude-code
使用 Codex 时，把安装命令最后的 claude-code 换成 codex，对话里把 /writing-for-agents 换成 $writing-for-agents。如果使用完整的 Claude Code 插件，则选择 /mattpocock-skills:writing-for-agents，不要再重复安装文件版本。
准备要修改的文件和至少一个实际偏差：例如漏跑检查、错误触发或读不到配套资料。说明哪些规则必须保留，避免把整理指引变成重新制定团队流程。
第一次使用
把下面的场景和路径替换成你的项目情况，在 Agent 对话里输入：
/writing-for-agents
请整理这个项目的 AGENTS.md。目前部署说明混在日常开发步骤里，Agent 经常过早准备发布。保留现有权限要求，明确部署章节的触发条件，把开发完成标准写清楚。
怎样推进任务
先定位实际失效的位置
区分问题发生在触发、阅读还是完成判断。部署章节过早进入上下文，可能需要更明确的条件；测试要求被跳过，则可能缺少可判断的结束标准。不同问题不应统一用“再强调一次”处理。
把步骤与参考材料分开
把每次任务都需要的动作留在主路径，把只在特定条件下使用的长篇说明移到有明确入口的参考文件。入口需要说明什么时候读取，而不只是“更多信息见某文件”。相关定义和例外放在一起，减少来回查找。
用可观察结果表达结束条件
将“检查完成后交付”改成能判断的标准，例如列出实际运行的项目检查及结果、指出未完成项。不要把 package.json 已明确的命令复制到多份文件，优先告诉 Agent 到哪里查，减少更新后不一致。
完成后检查什么
对照原始要求阅读 diff，确认必要规则仍在、触发条件可判断、引用文件存在。用原先失败的任务再走一遍，观察行为是否改善；字数减少只是副产品。
常见问题
会自动创建可安装插件吗？ 它提供文档写作方法，打包与分发需要另外处理。
文件越短越好吗？ 关键是信息层次和执行时需要什么，必要约束不能为了短而删掉。
适用于普通文章吗？ 本 Skill 面向 Agent 读取的工作指引；面向读者的文章通常需要不同的表达方式。
用客服分拣指引试一次精简
另一个适用场景是团队的 Agent 把每条客服消息都升级为工程故障。可以输入：“用 writing-for-agents 精简 support/AGENTS.md；保留隐私和转交要求，明确什么情况才读退款、故障和账号恢复的参考文件。用‘重复扣费但查不到订单’作为失败样本，改完后检查是否先查订单与支付记录，再决定升级。”先确认原来的具体误判，不要泛泛要求“写得更清楚”。
修改后分别试普通退款咨询和真正的重复扣费：前者不该启动工程排障，后者不能因为简化指引而漏掉升级。若 Agent 只是把同一句规则在主文档和三个参考文件各加粗一次，触发歧义仍在。保持能判定的入口、必要例外与可观察的结束条件，比一味增加字数更有效。
把重复规则收成一个判断点
修改一份长 Skill 时，把相同的判断规则放在一个位置，其他流程只引用它；再检查依赖文件何时加载、停止条件能否由执行者判断。曾有贡献者用 writing-for-agents 重新整理七份工作流，其中第二轮把重复评审规则和依赖加载说明合并，并压缩了三份 Skill 的篇幅。那是编辑成果，不代表更短的文字已被证明带来更高任务成功率。实际验收应拿一个以前会失败的任务重新运行，看触发时机、步骤与交付结论是否改善。