把重复工作写成第一个项目 Skill

01 · 选择一个足够小的重复任务

本例做“发布前只读检查”，不代替部署，也不调用外部服务。先确认项目没有同名 Skill，再创建 .agents/skills/release-check 目录。当前 Codex 文档支持在项目 .agents/skills 下发现 Skill。

mkdir -p .agents/skills/release-check
# 如果已有同名文件，先阅读并合并，不要覆盖
ls -la .agents/skills/release-check

02 · 创建 SKILL.md

用编辑器新建下面的文件。name 使用稳定的短名称，description 写清楚什么时候触发；正文给出检查步骤与边界。这里刻意不附带脚本，先用简单规则验证价值。

---
name: release-check
description: 用户明确要求发布前检查时使用。只读核对改动与检查脚本，不执行部署。
---

# 发布前检查
1. 读取 git status 和 git diff --stat。
2. 读取 package.json，找出已有检查命令。
3. 列出本次改动可能影响的页面与接口。
4. 输出建议执行的检查，不擅自运行部署命令。
5. 明确已验证、未验证和需要人工确认的事项。

不要读取或展示环境变量文件与凭据。

03 · 显式调用并检查输出

在项目中的新会话发送下面的请求，检查 Skill 是否被发现、输出是否引用真实文件。当前版本可自动发现变更；没有出现时重新启动客户端再试。Skill 只是一套工作指令，不会凭空增加工具或账号权限。

请使用 $release-check 做一次发布前只读检查。
不要执行部署，不要修改任何文件。

04 · 用反例调整触发条件

再发送一个普通问题，例如“解释这个组件”，检查它是否错误触发发布检查。若经常误触发，缩小 description 的适用范围。等流程稳定后再考虑脚本；不要为了一个简单检查引入服务或数据库。保留许可证和来源说明，分享第三方 Skill 前核对其授权。

常见问题