Codex Skills 使用与安全编写指南

一、Skill 应解决什么问题

适合固化的是重复出现、步骤相对稳定且能够验证的任务，例如发布检查、代码审查或文档转换。一次性的临时指令不必包装成 Skill。

二、先写触发条件和边界

开头应说明什么时候使用、什么时候不要使用，以及需要哪些文件或工具。不要假设当前会话一定拥有某个目录、凭据或权限。

触发：需要对静态站点做逐页发布验证时
前置：已确认发布目录和回滚备份位置
禁止：未确认源仓库时覆盖线上目录

三、步骤要可执行

1. 检查前置条件和当前状态。
2. 先备份，再做单一范围的修改。
3. 执行格式、链接和运行状态验证。
4. 记录未完成、阻塞项和回滚方式。

命令应使用占位符替代密钥、Cookie、私有地址和个人数据。对会改变系统状态的命令，写清楚确认点。

四、设计验收标准

• 输入和输出都能明确识别。
• 成功、失败和异常分支都有处理方式。
• 结果能通过文件、HTTP 状态、日志或测试复核。
• 不会把“计划执行”描述成“已经完成”。

五、维护 Skill

工具版本、目录结构或部署流程变化后，应重新验证 Skill。发现命令失效时及时修订，避免让旧流程成为新的故障来源。