跳转到内容
Codex 使用说明

废才俱乐部 Codex 教程摘记：目标合同和 Skill 文件树

采集日期：2026-06-20。复测日期：2026-06-20。来源类型：社区教程，不作为官方事实引用。

这两篇资料值得收录，不是因为里面有某个“神奇提示词”，而是它们刚好补上本站两个新手缺口：

  • 新手不知道怎么把“我想做个东西”变成 Codex 能执行的任务说明。
  • 新手看到 Skill 文件夹时，只知道它“好像很高级”，但不知道应该先看哪里、风险在哪里。

先记住一句话

Section titled “先记住一句话”

给 Codex 的好任务说明，不是长流程，而是一份小合同：

合同字段新手要写什么为什么有用
目标最后要得到什么结果避免 Codex 只理解局部动作
成功标准什么样算完成避免“优化一下”“改好一点”这种空话
边界哪些不能改、不能碰避免顺手重构、扩展功能、改无关文件
证据规则哪些事实必须查证避免把猜测写成确定结论
停止规则什么时候不用继续查避免搜索和分析无限扩散
交付格式最后怎么汇报方便你验收和继续追问

可复制：让 Codex 做一个小功能

Section titled “可复制：让 Codex 做一个小功能”
目标：
我想完成 ______，用户最后应该能 ______。


成功标准：
1. 现有功能不受影响；
2. 只改和这个任务直接相关的文件；
3. 页面或命令能被实际验证；
4. 如果有不确定信息，请标出来，不要猜成事实。


边界：
不要重构无关代码，不要新增不必要依赖，不要改公开接口。


执行方式：
如果任务已经足够明确，请直接推进。
只有在缺少关键信息会改变实现方向，或可能造成破坏性后果时，才先问我。


交付：
完成后告诉我改了哪些文件、怎么验证、还有什么风险。

这张卡比“请一步一步分析”更适合 coding agent。你把结果和验收标准写清楚，Codex 才能自己选择合理路径。

可复制：让 Codex 只读审查一个 Skill

Section titled “可复制：让 Codex 只读审查一个 Skill”
请只读这个 Skill，不要安装、不要运行脚本、不要联网。


请告诉我：
1. 这个 Skill 的 name 和 description 是否清楚；
2. 它适合什么任务，不适合什么任务；
3. SKILL.md 里有没有明确输入、步骤、输出和停止条件；
4. scripts/、references/、assets/ 分别有什么用途；
5. 哪些文件可能带来权限、联网、写文件或账号风险；
6. 如果我要使用它，第一步应该怎么低风险验证。

这张卡适合放在安装前。新手不要一看到 scripts/ 就直接运行，先让 Codex 解释它会读什么、写什么、连什么服务。

Skill 文件树怎么读

Section titled “Skill 文件树怎么读”

常见 Skill 不是一个神秘插件，而是一个可复用工作文件夹：

skill-name/
├── SKILL.md
├── scripts/
├── references/
├── assets/
└── agents/

新手只需要先看四件事：

  • SKILL.md：入口说明是否清楚，是否说明什么时候使用。
  • scripts/：是否会执行命令、写文件、联网、读取本地隐私文件。
  • references/：是否是长文档、规则、领域资料，是否过时。
  • assets/：是否是模板、样例、图片、schema，是否有版权或隐私问题。

不要把“有很多目录”理解成“更可靠”。可靠性来自清楚的触发条件、可审查的步骤、低风险验证方式。

放回本站怎么用

Section titled “放回本站怎么用”

来源与日期

Section titled “来源与日期”

本站只引用其主题和结构启发，具体事实仍以 OpenAI 官方文档和本站复测为准。