入门教程
Codex Skills 中文入门：什么时候把流程做成可复用技能
介绍 Codex Skills 的适用场景、指令结构、资源组织和验证方法，帮助把重复流程沉淀成可复用能力。
什么时候需要 Skill
当同一类任务反复出现，而且每次都要遵循相同步骤、检查相同文件或复用相同模板时，适合做成 Skill。一次性的项目要求通常写进 AGENTS.md 或当前任务即可。
典型例子包括：生成固定格式的报告、执行发布前检查、按组织规范创建文档、操作特定平台或复用一组脚本。
一个好 Skill 的组成
- 明确的触发范围：什么任务必须使用它；
- 完整的
SKILL.md：按实际顺序写清指令； - 必要的参考资料：只放真正影响执行的内容；
- 可复用脚本或模板：减少重复手写；
- 验证步骤：说明怎样判断结果正确。
避免把 Skill 做成模糊的“万能指南”。范围越明确，触发和执行越可靠。
编写时的三个原则
- 指令必须可执行，而不是只描述目标；
- 秘密和个人账号信息不应写入 Skill；
- 引用的文件与命令要能在目标环境中找到。
完成后，用一个典型任务和一个边界任务分别测试。前者应正确触发并完成，后者不应强行使用不相关流程。