我的 Codex 技能库清单：程序员 had 的实战版整理

大家好，我是 had。

这篇文章不是官方文档翻译，也不是概念科普。我主要是把自己这台机器里 Codex 能调用的 Skills 整理一遍，方便以后做项目、写文档、调试代码、生成图、审查架构的时候能快速知道：该让 Codex 用哪个技能、这个技能大概是干什么的、入口文件在哪里。

我平时用 Codex 和 Claude Code 比较多，所以这份清单会偏程序员视角：能落地、能排查、能写代码、能管项目，花里胡哨的会少讲一点。

说明：下面的链接是我本机的SKILL.md入口路径，主要用于自己复盘和定位。你如果是别的机器，路径肯定不一样，但技能名字和用途可以参考。

一、先说我最常用的几个

如果你不想看完整清单，我建议先记住这几个：

我的理解是：这些技能不是“插件越多越强”，而是给 Codex 加了一套工作纪律。尤其是调试、测试、验证这几个，能明显减少“看起来好了，其实没验证”的情况。

二、开发流程类 Skills

这一组是我最推荐程序员优先熟悉的。它们主要解决一个问题：让 Codex 不要上来就乱改，而是按一个比较工程化的流程做事。

我个人最喜欢的是systematic-debugging和verification-before-completion。前者防止“没搞清原因就改”，后者防止“改完没测就说好了”。

三、代码质量和架构审查类 Skills

这一组偏“老工程师视角”。不是只看代码能不能跑，而是看这个系统以后会不会越来越难改。

如果你是接手一个老项目，我建议顺序是：

1. 先用brooks-audit看结构。

2. 再用brooks-debt看技术债优先级。

3. 最后用brooks-review看具体改动。

四、Codex / Skill / 插件管理类 Skills

这一组是管理 Codex 自己的能力，比如查官方文档、安装 skill、创建 skill、创建插件。

这里我重点说下skill-creator：如果你想把自己常用工作流固化下来，比如“项目启动排查”“GitLab 登录排查”“目录整理规范”，就可以做成自己的 skill。

五、文档、PDF、表格、PPT 类 Skills

这一组非常适合日常办公自动化。不是简单读文件，而是能生成、编辑、渲染和验证。

我觉得这几个适合做：

• 会议纪要整理成 Word。

• Excel 数据分析和格式化。

• PDF 内容提取。

• 需求文档转开发交接文档。

• PPT 初稿生成。

六、设计、UI、图片类 Skills

这一组适合做前端页面、设计稿、品牌视觉和图片生成。

如果你做管理后台、SaaS、CRM 这类东西，我建议优先用ui-ux-pro-max和ckm:ui-styling。如果你做系统方案汇报，architecture-diagram很好用。

七、浏览器、项目管理、计划类 Skills

control-in-app-browser对前端验证很重要。很多时候页面“代码上看没问题”，但一打开就白屏、错位、按钮不可点。这个技能就是让 Codex 真的去看页面。

八、Slack 相关 Skills

这一组适合做 Slack app、Slack API、Block Kit 布局。

这几个国内用得可能没那么多，但如果公司协作平台是 Slack，就很实用。

九、我的使用习惯

我现在比较推荐这样用 Codex Skills：

1. 不要一上来就让 Codex 改代码

高风险任务先加一句：

先盘点，不要改文件。给我方案，等我说执行再动。

这样能避免它误删、误移动、误重构。

2. 调试问题先开systematic-debugging

比如：

按 systematic-debugging 流程处理这个报错，先复现和定位根因，不要先改代码。

3. 完成前一定要验证

我比较讨厌“应该好了”这种说法，所以verification-before-completion很关键。它要求 Codex 跑命令、看结果、再说完成。

4. 项目级规则写到AGENTS.md或CLAUDE.md

一次性约束写在聊天里，长期项目规则写到文件里。比如：

- 默认中文回复。 - 修改文件前先说明路径。 - 删除、移动、重命名必须确认。 - 不确定时先查本地，不要猜。

5. 自己常用流程可以做成 skill

比如我就很适合做这些个人 skill：

• GitLab 登录排查

• Java/Vue 项目启动排查

• 工作区目录整理

• AI Agent 接口联调

• CSDN 技术文章生成

这种东西做成 skill 后，比每次复制 prompt 更稳定。

十、总结

Codex 的 Skill 本质上不是“魔法插件”，更像是一套可复用的工作流。

对程序员来说，真正有价值的是这几类：

1. 流程纪律：先设计、先测试、先验证。

2. 调试纪律：先复现、再定位、最后修复。

3. 工程审查：看架构、看技术债、看测试质量。

4. 文档能力：Word、PDF、Excel、PPT 都能处理。

5. UI 和浏览器验证：不只写代码，还能看页面结果。

我的建议是：不要贪多，先把systematic-debugging、verification-before-completion、openai-docs、control-in-app-browser这几个用熟。等形成自己的固定工作流后，再考虑写自己的专属 skill。

这就是我目前这台机器上的 Codex Skills 清单。后面如果我把个人常用流程整理成自己的 skill，也会继续更新。