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

📅 2026/7/3 9:09:01
我的 Codex 技能库清单:程序员 had 的实战版整理
大家好我是 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、PPTui-ux-pro-max做前端页面、UI、布局、配色时用architecture-diagram画系统架构图、网络拓扑图时用我的理解是这些技能不是“插件越多越强”而是给 Codex 加了一套工作纪律。尤其是调试、测试、验证这几个能明显减少“看起来好了其实没验证”的情况。二、开发流程类 Skills这一组是我最推荐程序员优先熟悉的。它们主要解决一个问题让 Codex 不要上来就乱改而是按一个比较工程化的流程做事。Skill作用入口using-superpowers每轮先检查有没有适用 Skill避免跳过流程SKILL.mdbrainstorming写功能、创建组件、修改行为前先做需求澄清和方案设计SKILL.mdwriting-plans有明确需求后先写可执行的实施计划SKILL.mdexecuting-plans已经有计划时按计划分步骤执行SKILL.mdtest-driven-development写功能或修 bug 前先写测试避免凭感觉改代码SKILL.mdsystematic-debugging遇到 bug、异常、测试失败时先复现和定位根因SKILL.mdverification-before-completion声称完成前必须跑验证命令看到证据再汇报SKILL.mdrequesting-code-review大功能完成后请求代码审查SKILL.mdreceiving-code-review收到审查意见后先判断意见是否成立再决定是否修改SKILL.mdusing-git-worktrees开始较大功能前创建隔离工作区避免污染当前目录SKILL.mddispatching-parallel-agents多个互不依赖任务可以并行处理时使用SKILL.mdsubagent-driven-development当前会话中把独立开发任务拆给子 agentSKILL.mdfinishing-a-development-branch功能完成、测试通过后决定合并、PR 或清理分支SKILL.md我个人最喜欢的是systematic-debugging和verification-before-completion。前者防止“没搞清原因就改”后者防止“改完没测就说好了”。三、代码质量和架构审查类 Skills这一组偏“老工程师视角”。不是只看代码能不能跑而是看这个系统以后会不会越来越难改。Skill作用入口brooks-reviewPR 级代码审查关注 bug、设计味道、维护性风险SKILL.mdbrooks-audit架构审计检查模块依赖、分层、循环依赖和结构腐化SKILL.mdbrooks-debt技术债评估判断哪里最值得优先重构SKILL.mdbrooks-health对项目做整体健康检查和评分SKILL.mdbrooks-sweep全库扫描并对安全的小问题直接修复SKILL.mdbrooks-test专门审查测试质量比如脆弱测试、mock 滥用、覆盖幻觉SKILL.mdcomplexity-optimizer找复杂度和性能热点比如嵌套循环、重复扫描、N1 查询SKILL.md如果你是接手一个老项目我建议顺序是先用brooks-audit看结构。再用brooks-debt看技术债优先级。最后用brooks-review看具体改动。四、Codex / Skill / 插件管理类 Skills这一组是管理 Codex 自己的能力比如查官方文档、安装 skill、创建 skill、创建插件。Skill作用入口openai-docs查 OpenAI / Codex 官方文档回答模型、API、Codex 行为问题SKILL.mdskill-installer安装 Codex skillsSKILL.mdskill-creator创建或更新 Codex skillSKILL.mdplugin-creator创建 Codex 插件目录和 manifestSKILL.mdfind-skills查找有没有现成 skill 可以安装SKILL.mdwriting-skills写、改、验证 superpowers 类型 skillSKILL.mdclaude-md-improver审计并改进项目里的CLAUDE.mdSKILL.md这里我重点说下skill-creator如果你想把自己常用工作流固化下来比如“项目启动排查”“GitLab 登录排查”“目录整理规范”就可以做成自己的 skill。五、文档、PDF、表格、PPT 类 Skills这一组非常适合日常办公自动化。不是简单读文件而是能生成、编辑、渲染和验证。Skill作用入口documents创建、编辑、批注、渲染验证 Word /.docx文档SKILL.mdpdf读取、创建、检查、渲染 PDFSKILL.mdspreadsheets处理 Excel、CSV、TSV、公式、图表和表格格式SKILL.mdpresentations创建或编辑 PowerPoint / Google Slides 风格幻灯片SKILL.mdtemplate-creator从 Word、PPT、Excel 生成可复用的模板 skillSKILL.md我觉得这几个适合做会议纪要整理成 Word。Excel 数据分析和格式化。PDF 内容提取。需求文档转开发交接文档。PPT 初稿生成。六、设计、UI、图片类 Skills这一组适合做前端页面、设计稿、品牌视觉和图片生成。Skill作用入口imagegen生成或编辑位图图片比如插画、贴图、素材、透明背景图SKILL.mdui-ux-pro-maxUI/UX 设计包含页面、组件、布局、配色、字体、图表SKILL.mdckm:ui-styling基于 shadcn/ui、Radix、Tailwind 做可访问 UI 样式SKILL.mdckm:design综合设计技能覆盖品牌、logo、CIP、banner、图标、社媒图SKILL.mdckm:brand品牌语气、视觉识别、风格规范、信息表达SKILL.mdckm:design-system设计 token、组件规范、系统化设计SKILL.mdckm:banner-design社媒、广告、网站 hero、印刷 banner 设计SKILL.mdckm:slides用 HTML、Chart.js、设计 token 创建策略型演示稿SKILL.mdarchitecture-diagram创建深色风格架构图、系统图、网络拓扑图SKILL.mdslack-gif-creator制作适合 Slack 的动态 GIF包含尺寸和压缩约束SKILL.md如果你做管理后台、SaaS、CRM 这类东西我建议优先用ui-ux-pro-max和ckm:ui-styling。如果你做系统方案汇报architecture-diagram很好用。七、浏览器、项目管理、计划类 SkillsSkill作用入口control-in-app-browser控制 Codex 内置浏览器打开、点击、截图、测试网页SKILL.mdplanning-with-files用task_plan.md、findings.md、progress.md管理复杂任务SKILL.mdlinear管理 Linear issue、项目和团队流程SKILL.mdcontrol-in-app-browser对前端验证很重要。很多时候页面“代码上看没问题”但一打开就白屏、错位、按钮不可点。这个技能就是让 Codex 真的去看页面。八、Slack 相关 Skills这一组适合做 Slack app、Slack API、Block Kit 布局。Skill作用入口slack-cli使用 Slack CLI 登录、创建、运行和管理 Slack appSKILL.mdslack-api查找和调用 Slack Web API比如发消息、查频道、分页、权限 scopeSKILL.mdblock-kit设计和验证 Slack Block Kit 消息、弹窗、Home tabSKILL.mdcreate-slack-app指导创建 Slack app 或 agentSKILL.mdslack-messaging写格式清晰的 Slack 消息SKILL.mdslack-search搜索 Slack 消息、文件、频道和人员SKILL.md这几个国内用得可能没那么多但如果公司协作平台是 Slack就很实用。九、我的使用习惯我现在比较推荐这样用 Codex Skills1. 不要一上来就让 Codex 改代码高风险任务先加一句先盘点不要改文件。给我方案等我说执行再动。这样能避免它误删、误移动、误重构。2. 调试问题先开systematic-debugging比如按 systematic-debugging 流程处理这个报错先复现和定位根因不要先改代码。3. 完成前一定要验证我比较讨厌“应该好了”这种说法所以verification-before-completion很关键。它要求 Codex 跑命令、看结果、再说完成。4. 项目级规则写到AGENTS.md或CLAUDE.md一次性约束写在聊天里长期项目规则写到文件里。比如- 默认中文回复。 - 修改文件前先说明路径。 - 删除、移动、重命名必须确认。 - 不确定时先查本地不要猜。5. 自己常用流程可以做成 skill比如我就很适合做这些个人 skillGitLab 登录排查Java/Vue 项目启动排查工作区目录整理AI Agent 接口联调CSDN 技术文章生成这种东西做成 skill 后比每次复制 prompt 更稳定。十、总结Codex 的 Skill 本质上不是“魔法插件”更像是一套可复用的工作流。对程序员来说真正有价值的是这几类流程纪律先设计、先测试、先验证。调试纪律先复现、再定位、最后修复。工程审查看架构、看技术债、看测试质量。文档能力Word、PDF、Excel、PPT 都能处理。UI 和浏览器验证不只写代码还能看页面结果。我的建议是不要贪多先把systematic-debugging、verification-before-completion、openai-docs、control-in-app-browser这几个用熟。等形成自己的固定工作流后再考虑写自己的专属 skill。这就是我目前这台机器上的 Codex Skills 清单。后面如果我把个人常用流程整理成自己的 skill也会继续更新。