"# Codex Skill 根文档越长越难用？按“触发、禁止、引用”拆成可路由结构

把部署、审查、故障和交接规则全部塞进一个SKILL.md，看似信息充分，实际会模糊最重要的问题：这次任务是否该触发它。近期 OpenAI 官方文章建议把多工作流的根文档做成简短路由，再按任务读取支持材料。下面用一个 Demo 部署 Skill 展开，不把示例当成生产发布指导。

根文件只回答三个问题

根文件可以保持在可扫读的范围：

适用：用户明确要求发布 Demo，且本地检查已通过。 禁止：不处理生产环境，不跳过健康检查。 引用：发布读 references/deploy.md；回滚读 references/rollback.md。

用户问“怎样部署 Demo”时，只读取发布参考；用户要求回滚时，才读取回滚参考。预期是输入与加载文件能对应，而不是每次都把事故手册塞进上下文。把命令、环境变量和故障分支移入引用文件，并不等于删除它们。

用相邻任务测试触发边界

准备两条测试输入：A 为“发布通过本地检查的 Demo”；B 为“解释部署文档的结构”。A 应进入部署 Skill，B 只需要普通说明。若 B 也触发，先收窄 description 中的动作与前置条件；不要在根文档继续补一长串例外。若 A 触发后缺少回滚说明，则检查引用链接是否存在、是否写清输入和停止条件。

避免把路由当权限系统

Skill 的触发描述只决定加载