大家好，我是 had。

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

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

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

---

一、先说我最常用的几个

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

技能	什么时候用
using-superpowers	每次开始任务前先检查是否有适用技能
brainstorming	做功能、改行为、设计方案前先梳理需求
systematic-debugging	遇到 bug、报错、测试失败时先定位根因
test-driven-development	写功能或修 bug 前先补测试
verification-before-completion	说“完成”之前必须验证
openai-docs	问 Codex / OpenAI API / 模型 / 官方文档时用
control-in-app-browser	要 Codex 操作内置浏览器、验证页面时用
documents / pdf / spreadsheets / presentations	处理 Word、PDF、Excel、PPT
ui-ux-pro-max	做前端页面、UI、布局、配色时用
architecture-diagram	画系统架构图、网络拓扑图时用

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

---

二、开发流程类 Skills

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

Skill	作用	入口
using-superpowers	每轮先检查有没有适用 Skill，避免跳过流程	SKILL.md
brainstorming	写功能、创建组件、修改行为前先做需求澄清和方案设计	SKILL.md
writing-plans	有明确需求后，先写可执行的实施计划	SKILL.md
executing-plans	已经有计划时，按计划分步骤执行	SKILL.md
test-driven-development	写功能或修 bug 前先写测试，避免凭感觉改代码	SKILL.md
systematic-debugging	遇到 bug、异常、测试失败时，先复现和定位根因	SKILL.md
verification-before-completion	声称完成前必须跑验证命令，看到证据再汇报	SKILL.md
requesting-code-review	大功能完成后，请求代码审查	SKILL.md
receiving-code-review	收到审查意见后，先判断意见是否成立，再决定是否修改	SKILL.md
using-git-worktrees	开始较大功能前创建隔离工作区，避免污染当前目录	SKILL.md
dispatching-parallel-agents	多个互不依赖任务可以并行处理时使用	SKILL.md
subagent-driven-development	当前会话中把独立开发任务拆给子 agent	SKILL.md
finishing-a-development-branch	功能完成、测试通过后，决定合并、PR 或清理分支	SKILL.md

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

---

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

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

Skill	作用	入口
brooks-review	PR 级代码审查，关注 bug、设计味道、维护性风险	SKILL.md
brooks-audit	架构审计，检查模块依赖、分层、循环依赖和结构腐化	SKILL.md
brooks-debt	技术债评估，判断哪里最值得优先重构	SKILL.md
brooks-health	对项目做整体健康检查和评分	SKILL.md
brooks-sweep	全库扫描，并对安全的小问题直接修复	SKILL.md
brooks-test	专门审查测试质量，比如脆弱测试、mock 滥用、覆盖幻觉	SKILL.md
complexity-optimizer	找复杂度和性能热点，比如嵌套循环、重复扫描、N+1 查询	SKILL.md

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

1. 先用 brooks-audit 看结构。

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

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

---

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

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

Skill	作用	入口
openai-docs	查 OpenAI / Codex 官方文档，回答模型、API、Codex 行为问题	SKILL.md
skill-installer	安装 Codex skills	SKILL.md
skill-creator	创建或更新 Codex skill	SKILL.md
plugin-creator	创建 Codex 插件目录和 manifest	SKILL.md
find-skills	查找有没有现成 skill 可以安装	SKILL.md
writing-skills	写、改、验证 superpowers 类型 skill	SKILL.md
claude-md-improver	审计并改进项目里的 CLAUDE.md	SKILL.md

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

---

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

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

Skill	作用	入口
documents	创建、编辑、批注、渲染验证 Word / .docx 文档	SKILL.md
pdf	读取、创建、检查、渲染 PDF	SKILL.md
spreadsheets	处理 Excel、CSV、TSV、公式、图表和表格格式	SKILL.md
presentations	创建或编辑 PowerPoint / Google Slides 风格幻灯片	SKILL.md
template-creator	从 Word、PPT、Excel 生成可复用的模板 skill	SKILL.md

我觉得这几个适合做：

• 会议纪要整理成 Word。

• Excel 数据分析和格式化。

• PDF 内容提取。

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

• PPT 初稿生成。

---

六、设计、UI、图片类 Skills

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

Skill	作用	入口
imagegen	生成或编辑位图图片，比如插画、贴图、素材、透明背景图	SKILL.md
ui-ux-pro-max	UI/UX 设计，包含页面、组件、布局、配色、字体、图表	SKILL.md
ckm:ui-styling	基于 shadcn/ui、Radix、Tailwind 做可访问 UI 样式	SKILL.md
ckm:design	综合设计技能，覆盖品牌、logo、CIP、banner、图标、社媒图	SKILL.md
ckm:brand	品牌语气、视觉识别、风格规范、信息表达	SKILL.md
ckm:design-system	设计 token、组件规范、系统化设计	SKILL.md
ckm:banner-design	社媒、广告、网站 hero、印刷 banner 设计	SKILL.md
ckm:slides	用 HTML、Chart.js、设计 token 创建策略型演示稿	SKILL.md
architecture-diagram	创建深色风格架构图、系统图、网络拓扑图	SKILL.md
slack-gif-creator	制作适合 Slack 的动态 GIF，包含尺寸和压缩约束	SKILL.md

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

---

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

Skill	作用	入口
control-in-app-browser	控制 Codex 内置浏览器，打开、点击、截图、测试网页	SKILL.md
planning-with-files	用 task_plan.md、findings.md、progress.md 管理复杂任务	SKILL.md
linear	管理 Linear issue、项目和团队流程	SKILL.md

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

---

八、Slack 相关 Skills

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

Skill	作用	入口
slack-cli	使用 Slack CLI 登录、创建、运行和管理 Slack app	SKILL.md
slack-api	查找和调用 Slack Web API，比如发消息、查频道、分页、权限 scope	SKILL.md
block-kit	设计和验证 Slack Block Kit 消息、弹窗、Home tab	SKILL.md
create-slack-app	指导创建 Slack app 或 agent	SKILL.md
slack-messaging	写格式清晰的 Slack 消息	SKILL.md
slack-search	搜索 Slack 消息、文件、频道和人员	SKILL.md

这几个国内用得可能没那么多，但如果公司协作平台是 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，也会继续更新。