本文定位： 如果你是 Java 全栈工程师，日常用 Codex CLI，这篇文章帮你从 0 搭建一套覆盖完整项目的 Skills 体系。

数据来源： 所有 GitHub⭐ 于 2026-05-15 通过 GitHub API 实时获取。

---

一、前言与准备

Codex CLI 内置了 29 个命令和 .system 层技能。以下基于 openai/skills 官方仓库。

两个冲突，各不同处理

• /review → 被 code-review-and-quality 替代。自带的是通用审查，addyosmani 走五轴审查 + ~100 行限制。装了之后不再手动调 /review。
• skill-creator（.system 层） → Codex 已自动安装。保留自带的，不装 anthropics 版本。 两者功能重叠，自带的是 OpenAI 官方维护、原生适配。

这两个能力 Codex 不支持，相关 Skill 不要装

Codex CLI 的第三方 Skill Hooks 机制不可用（Stop/PreToolUse/PostToolUse 对插件不生效，源码中仍为 TODO），所以 planning-with-files 和 ralph-loop 不可用。Codex CLI 不支持自定义 Slash 命令，所以 mattpocock/skills 系列（/diagnose、/grill-me 等）也不可用。

这些你已经有了，不用重复装

.system 层技能（skill-creator、plugin-creator、skill-installer）自动安装。Sub-agents（default、worker、explorer）原生支持。MCP 原生支持。$skill-name 显式调用和隐式调用控制（allow_implicit_invocation）原生可用。

其他自带命令（不冲突）

/plan（轻量模式开关，和 brainstorming/writing-plans 不冲突）、/skills、/mcp、/agent、/model、/permissions ——和本文推荐互不影响。

---

行为准则（首次必配）

在安装任何 Skill 之前，先配好这一步。以下四条行为准则由 Andrej Karpathy 对 LLM 编码缺陷的观察提炼而来，作用是约束 AI 的编码行为——减少过度设计、禁止臆测、优先最简单方案。

原则	解决的问题
Think Before Coding	沉默假设、隐藏困惑、缺失权衡
Simplicity First	过度设计、臃肿抽象、臆想需求
Surgical Changes	顺手改无关代码、格式化、重构未损坏的部分
Goal-Driven Execution	模糊成功标准、未经验证的改动

Skill 安装方式不会自动生效。 Codex CLI 通过 AGENTS.md 实现行为准则的自动加载，但不同于 Claude Code 的 rules/ 目录，Codex 没有独立的规则文件机制——所有指令都走 AGENTS.md。正确做法是两步：

# 1. 安装 Skill（下载最新规则内容到本地）
npx skills add forrestchang/andrej-karpathy-skills --skill karpathy-guidelines -g

# 2. 提取规则内容到独立文件（npx skills add 安装到 .agents/skills/ 通用目录）
sed '1,/^---$/d' ~/.agents/skills/karpathy-guidelines/SKILL.md | tail -n +2 > ~/.codex/karpathy-guidelines.md

# 3. 将内容加入 AGENTS.md
# 情况 A：~/.codex/AGENTS.md 不存在 → 直接重命名：
mv ~/.codex/karpathy-guidelines.md ~/.codex/AGENTS.md

# 情况 B：~/.codex/AGENTS.md 已有内容 → 手动将 karpathy-guidelines.md 的内容作为独立段落粘贴进去，避免覆盖原有规则。

为什么不能简单 >> 追加？ 反复执行会重复追加内容，且不应覆盖用户已有的 AGENTS.md 配置。提取到独立文件后，由用户根据自身情况选择合并方式。

更新规则： 重新执行第 1 步和第 2 步，然后将新内容替换到 AGENTS.md 中对应的 karpathy 段落即可。npx skills add 会覆盖本地 Skill 文件，始终拉取最新版本。

行为准则就位。下面进入 Skill 安装，由底向上逐层叠加。

---

二、极简核心

不要一口气装 30 个 Skill。先装这 3 个，AI 的行为方式就已经变了。剩下的按阶段需要再补。Codex CLI 不支持 Hooks，所以 planning-with-files 不可用——但这 3 个来自 superpowers，是经过 191K⭐ 验证的最强核心。

#	Skill	来源	GitHub⭐	作用	触发
1	brainstorming	obra/superpowers	191K	需求澄清：硬关闸，不给代码先出设计文档，用户批准才继续	自动
2	writing-plans	obra/superpowers	191K	任务规划：拆成 2-5 分钟任务，精确文件路径，禁止 TODO / 占位符	自动
3	test-driven-development	obra/superpowers	191K	严格 TDD：先写测试 → 再写实现。先写实现代码会被删除	自动

npx skills add obra/superpowers --skill brainstorming --skill writing-plans --skill test-driven-development

去掉了 planning-with-files（依赖 Stop Hook，Codex CLI 不支持）。如果你需要跨会话持久化，Codex 原生的会话管理可以部分弥补。

核心底座就位，下面按项目阶段逐层补全。

---

三、项目全流程

1. 需求与规划

这个阶段解决什么： 想法 → PRD → 可执行的任务清单。

极简核心里的 brainstorming + writing-plans 已经完整覆盖。不需要额外加 Skill。

---

2. UI 与设计

这个阶段解决什么： 页面长什么样、风格怎么定、组件体系怎么搭。

角色	Skill	来源	GitHub⭐	作用	触发
主力 ★	taste-skill	leonxlnx/taste-skill	17.3K	出视觉方案，大胆破格、电影感、不对称动效	自动
互补	impeccable	pbakaus/impeccable	27.8K	对已有设计做审查、打磨、提升（@impeccable）	命令
互补	web-design-guidelines	vercel-labs/agent-skills	26.6K	Web UI 审查，覆盖布局、可用性、体验细节	自动
互补	accessibility-compliance	wshobson/agents	35.4K	WCAG 2.2、ARIA、键盘导航、对比度、移动端无障碍	自动

为什么这个组合？ 社区基准测试 86/100 的最优搭配：taste-skill 负责"做得好看"，impeccable 负责"别做烂"，web-design-guidelines 补 UX 细节，accessibility-compliance 补无障碍。

npx skills add https://github.com/leonxlnx/taste-skill
npx skills add pbakaus/impeccable
npx skills add vercel-labs/agent-skills --skill web-design-guidelines
npx skills add wshobson/agents --skill accessibility-compliance

❌ UI UX Pro Max 明确排除。 存在 CVE-2026-7596（XSS）和 CVE-2026-7595（代码注入），Mondoo 标记为潜在恶意。

---

3. 架构与接口

这个阶段解决什么： API 怎么设计、数据库怎么建、技术选型怎么记录。

角色	Skill	来源	GitHub⭐	作用	触发
主力 ★	api-design-principles	wshobson/agents	35.4K	REST/GraphQL API 设计、分页、错误响应、版本策略	自动
互补	openapi-spec-generation	wshobson/agents	35.4K	生成和维护 OpenAPI 3.1 契约	自动
互补	database-migration	wshobson/agents	35.4K	数据库迁移、回滚、零停机变更、数据转换	自动
互补	architecture-decision-records	wshobson/agents	35.4K	输出 ADR，记录技术选型、备选方案、取舍和后果	命令

npx skills add wshobson/agents --skill api-design-principles --skill openapi-spec-generation --skill database-migration --skill architecture-decision-records

---

4. 编码与开发

这个阶段解决什么： 按计划执行、写代码、保持代码干净。

角色	Skill	来源	GitHub⭐	作用	触发
主力 ★	executing-plans	obra/superpowers	191K	按 writing-plans 拆好的任务分步执行，每批验证	自动
主力 ★	code-simplification	addyosmani/agent-skills	41.6K	Chesterton’s Fence + Rule of 500，防止 AI 过度重构	自动

executing-plans 和极简核心里的 brainstorming、writing-plans 组成 superpowers 三件套闭环：想清楚 → 拆任务 → 执行。

code-simplification 内建 Chesterton’s Fence 原则（不懂为什么这样写的代码，不要动它）和 Rule of 500（控制改动范围），防止 AI 过度重构。

npx skills add obra/superpowers --skill executing-plans
npx skills add addyosmani/agent-skills --skill code-simplification

去掉了 diagnose（mattpocock/skills 依赖 Slash 命令，Codex CLI 不支持）和 ralph-loop（依赖 Stop Hook，Codex CLI 不支持）。

---

5. 测试与验收

这个阶段解决什么： 写得对不对、浏览器里长什么样、验证闭环。

角色	Skill	来源	GitHub⭐	作用	触发
主力 ★	webapp-testing	anthropics/skills	134K	Playwright 驱动浏览器测试、截图、DOM 检查	自动
互补	e2e-testing-patterns	wshobson/agents	35.4K	E2E 测试结构设计、关键路径、反脆弱测试	自动
互补	verification-loop	affaan-m/everything-claude-code	182K	build → typecheck → lint → test → security → diff review 总验证	自动

webapp-testing 是 Playwright 执行引擎，e2e-testing-patterns 是测试设计方法论，verification-loop 是完成前的全量门禁。一个执行、一个设计、一个总闸。

npx skills add anthropics/skills --skill webapp-testing
npx skills add wshobson/agents --skill e2e-testing-patterns
npx skills add affaan-m/everything-claude-code --skill verification-loop

---

6. 审查与安全

这个阶段解决什么： 代码有没有 bug、有没有安全漏洞。

角色	Skill	来源	GitHub⭐	作用	触发
主力 ★	code-review-and-quality	addyosmani/agent-skills	41.6K	五轴审查（正确性/安全性/性能/可维护性/一致性），~100 行	自动
互补	security-and-hardening	addyosmani/agent-skills	41.6K	OWASP Top 10 + 三级边界加固，关注整体项目安全水平	自动
互补	differential-review	trailofbits/skills	5.2K	针对 git diff 做安全审查，分析每次变更的爆炸半径	命令

code-review-and-quality 走五轴审查限制每次 ~100 行，security-and-hardening 走 OWASP Top 10 加固整体项目，differential-review（Trail of Bits 出品）专门审查每次变更的爆炸半径。三个角度互补。

npx skills add addyosmani/agent-skills --skill code-review-and-quality --skill security-and-hardening
npx skills add trailofbits/skills --skill differential-review

---

7. 部署与上线

这个阶段解决什么： 提交规范、CI/CD、Docker、性能、SEO、上线后监测。

角色	Skill	来源	GitHub⭐	作用	触发
主力 ★	git-commit	github/awesome-copilot	33K	分析 diff 生成 Conventional Commits 规范提交	命令
互补	git-workflow-and-versioning	addyosmani/agent-skills	41.6K	Trunk-based 分支策略、atomic commits	自动
互补	git-advanced-workflows	wshobson/agents	35.4K	rebase、cherry-pick、bisect、worktree	自动
互补	deployment-pipeline-design	wshobson/agents	35.4K	CI/CD 流水线设计、审批门禁、回滚策略	自动
互补	docker-expert	sickn33/antigravity-awesome-skills	37.5K	Dockerfile、Compose、多阶段构建、安全加固	自动
互补	gh-cli	github/awesome-copilot	33K	GitHub CLI、PR、Issue、Actions、release 操作	自动
互补	performance	addyosmani/web-quality-skills	1.9K	Lighthouse、Core Web Vitals、加载性能优化	自动
互补	seo	addyosmani/web-quality-skills	1.9K	meta、结构化数据、sitemap、搜索可见性	自动
互补	canary-watch	affaan-m/everything-claude-code	182K	上线后观察回归信号、发布后检查	命令

九个 Skill，九个不同关注点——git-commit 管提交信息、git-workflow 管分支策略、git-advanced 管复杂操作、deployment 管 CI/CD、docker 管容器化、gh-cli 管 GitHub 操作、performance 和 seo 管线上质量、canary-watch 管回归监测。不重叠，不冲突。

npx skills add github/awesome-copilot --skill git-commit
npx skills add addyosmani/agent-skills --skill git-workflow-and-versioning
npx skills add wshobson/agents --skill git-advanced-workflows --skill deployment-pipeline-design
npx skills add sickn33/antigravity-awesome-skills --skill docker-expert
npx skills add github/awesome-copilot --skill gh-cli
npx skills add addyosmani/web-quality-skills --skill performance --skill seo
npx skills add affaan-m/everything-claude-code --skill canary-watch

---

8. 文档与复盘

这个阶段解决什么： 项目文档、架构决策记录、交付复盘。

角色	Skill	来源	GitHub⭐	作用	触发
主力 ★	documentation-writer	github/awesome-copilot	33K	按 Diátaxis 框架生成 README、使用说明、交付文档	命令
互补	documentation-and-adrs	addyosmani/agent-skills	41.6K	记录架构决策（ADR）、注释、变更说明——文档的 WHY	命令

documentation-writer 负责对外文档，documentation-and-adrs 负责对内记录。一个给使用者看，一个给维护者看。

npx skills add github/awesome-copilot --skill documentation-writer
npx skills add addyosmani/agent-skills --skill documentation-and-adrs

---

9. ECC 运维

这个阶段解决什么： Skill 发现、创建、上下文管理、终端行为约束。

角色	Skill	来源	GitHub⭐	作用	触发
主力 ★	find-skills	vercel-labs/skills	18.5K	搜索发现社区 Skill，交互式检索	命令
互补	agent-sort	affaan-m/everything-claude-code	182K	按项目把 Skills 分成 DAILY / LIBRARY，精简上下文	自动
互补	context-budget	affaan-m/everything-claude-code	182K	审计上下文窗口消耗，输出 token 削减建议	自动
互补	terminal-ops	affaan-m/everything-claude-code	182K	终端执行行为约束，先检查再操作	自动

Codex CLI 自带 .system 层的 skill-creator，不需要额外安装 anthropics 版本。

npx skills add vercel-labs/skills --skill find-skills
npx skills add affaan-m/everything-claude-code --skill agent-sort --skill context-budget --skill terminal-ops

以上九步覆盖完整项目生命周期。

---

四、Codex CLI 专属增强

以下 Skill 来自 Codex 生态，是 Codex CLI 用户专属的优质工具。建议全部安装。

Skill	来源	GitHub⭐	作用
awesome-codex-skills	ComposioHQ/awesome-codex-skills	9.1K	Codex 技能兵器库，分开发代码、生产力、写作、数据分析、实用工具五大板块，按需挑着装
repomix	yamadashy/repomix	24.7K	把整个代码库打包成一个对 AI 极度友好的文件，上下文连贯性拉满。获 JSNation 开源奖"AI 驱动"类提名
follow-builders	zarazhangrui/follow-builders	4.2K	自动追踪 AI 领域顶尖大佬最新动态，极简摘要推送，打破信息差
codex-plusplus	b-nnett/codex-plusplus	1.5K	Codex 桌面端可视化补丁系统，边让 AI 改代码边看效果变化，不用来回切屏幕
keep-codex-fast	vibeforge1111/keep-codex-fast	963	Codex 底层性能优化，保持刚安装时的极速响应，不丢历史聊天和关键数据

npx skills add ComposioHQ/awesome-codex-skills
npx skills add yamadashy/repomix --skill repomix
npx skills add zarazhangrui/follow-builders --skill follow-builders
npx skills add b-nnett/codex-plusplus --skill codex-plusplus
npx skills add vibeforge1111/keep-codex-fast --skill keep-codex-fast

---

五、技术栈增强

通用核心层装完后，按你的项目技术栈追加。不做项目的不用装。

1. Java / Spring Boot

Skill	来源	GitHub⭐	作用	触发
java-springboot	github/awesome-copilot	33K	Spring Boot 主位最佳实践	自动
spring-boot-engineer	jeffallan/claude-skills	9.1K	Spring Boot 3、Java 17+、微服务、测试、可观测性	自动
java-coding-standards	affaan-m/everything-claude-code	182K	Java 命名、异常、Optional、泛型、项目结构	自动
springboot-patterns	affaan-m/everything-claude-code	182K	分层架构、Controller/Service/Repository、生产默认项	自动
springboot-security	affaan-m/everything-claude-code	182K	Spring Security、JWT、CSRF、密钥、输入校验	自动
java-junit	github/awesome-copilot	33K	JUnit 5 单元测试最佳实践	自动
springboot-tdd	affaan-m/everything-claude-code	182K	Spring Boot TDD、MockMvc、Testcontainers、JaCoCo	自动
springboot-verification	affaan-m/everything-claude-code	182K	build → 测试覆盖 → 安全扫描 → 发布前验证	自动
jpa-patterns	affaan-m/everything-claude-code	182K	JPA/Hibernate 实体、关系、事务、N+1、分页	自动
mysql	planetscale/database-skills	426	MySQL/InnoDB 表结构、索引、事务、锁、慢查询	自动
redis-development	redis/agent-skills	55	Redis 数据结构、缓存策略、性能优化	自动

说明：写 Java 代码时 AI 自动应用规范。springboot-tdd 和极简核心里的 superpowers TDD 互补——springboot-tdd 负责 Java 专属的 MockMvc/Testcontainers，superpowers TDD 负责严格的 RED-GREEN-REFACTOR 流程。

npx skills add github/awesome-copilot --skill java-springboot --skill java-junit
npx skills add jeffallan/claude-skills --skill spring-boot-engineer
npx skills add affaan-m/everything-claude-code --skill java-coding-standards --skill springboot-patterns --skill springboot-security --skill springboot-tdd --skill springboot-verification --skill jpa-patterns
npx skills add planetscale/database-skills --skill mysql
npx skills add redis/agent-skills --skill redis-development

2. Vue / Vite / Pinia

Skill	来源	GitHub⭐	作用	触发
vue-best-practices	hyf0/vue-skills	2.4K	Vue 3 Composition API、组件边界、响应式、测试	自动
vue-router-best-practices	antfu/skills	5K	Vue Router 4、导航守卫、路由参数、生命周期	自动
pinia	antfu/skills	5K	Pinia store、SSR、类型安全、测试	自动
vue-testing-best-practices	antfu/skills	5K	Vue Test Utils、Vitest、组件测试	自动
vite	antfu/skills	5K	Vite 配置、插件、构建、SSR	自动

npx skills add hyf0/vue-skills --skill vue-best-practices
npx skills add antfu/skills --skill vue-router-best-practices --skill pinia --skill vue-testing-best-practices --skill vite

3. React / Next.js / TypeScript

Skill	来源	GitHub⭐	作用	触发
vercel-react-best-practices	vercel-labs/agent-skills	26.6K	React/Next 性能、数据流、渲染、bundle 优化	自动
next-best-practices	vercel-labs/next-skills	871	Next.js App Router、RSC、metadata、route handlers	自动
next-cache-components	vercel-labs/next-skills	871	Next.js Cache Components、PPR、cacheTag、updateTag	自动
typescript-advanced-types	wshobson/agents	35.4K	TypeScript 高级类型、泛型、条件类型、类型安全	自动
tailwind-design-system	wshobson/agents	35.4K	Tailwind v4 token、主题、组件系统	自动
shadcn	shadcn/ui	114K	shadcn/ui 组件、CLI、registry、组件组合	自动

npx skills add vercel-labs/agent-skills --skill vercel-react-best-practices
npx skills add vercel-labs/next-skills --skill next-best-practices --skill next-cache-components
npx skills add wshobson/agents --skill typescript-advanced-types --skill tailwind-design-system
npx skills add shadcn/ui --skill shadcn

4. uni-app / 微信小程序

Skill	来源	GitHub⭐	作用	触发
uni-app	uni-helper/skills	65	uni-app 跨端开发、组件、API、条件编译、平台差异	自动
uniapp-project	teachingai/full-stack-skills	388	uni-app 组件/API 示例、官方文档链接、平台兼容性	自动
miniprogram-development	tencentcloudbase/skills	58	微信小程序项目结构、页面、组件、tabBar、预览、上传	自动
auth-wechat-miniprogram	tencentcloudbase/skills	58	微信小程序原生身份、OPENID/UNIONID、wx.cloud 鉴权	自动

npx skills add uni-helper/skills --skill uni-app
npx skills add teachingai/full-stack-skills --skill uniapp-project
npx skills add tencentcloudbase/skills --skill miniprogram-development --skill auth-wechat-miniprogram

六、场景工具

以下 Skill 按解决什么问题分成五组。按需选装，用完可以移除。

A1. 信息获取

Agent-Reach — 全网搜索（Panniantong/Agent-Reach，19.5K⭐）

搜索 Twitter、Reddit、YouTube、GitHub、Bilibili、小红书、抖音、微信公众号、微博等 13 个平台，零 API 费用。

curl -s https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md | codex -p

装完后运行 agent-reach doctor 查看各平台连接状态。

summarize — 长文总结（社区 skill）

快速提炼长网页、博客、万字长文、PDF 的核心观点。

npx skills add https://github.com/steipete/clawdis --skill summarize

---

A2. 浏览器操作

agent-browser — 浏览器自动化（vercel-labs/agent-browser，33K⭐）

让 Codex 像真实用户一样操作浏览器：登录网站、点击按钮、填写表单、截取页面、批量抓取数据。和第五段的 webapp-testing 分工不同——webapp-testing 跑测试脚本，agent-browser 做交互式操作。

Skill + CLI 两件套，缺一不可：

npx skills add vercel-labs/agent-browser --skill agent-browser
npm install -g agent-browser
agent-browser install
agent-browser doctor

---

A3. 工程治理

codebase-onboarding — 老项目接手（affaan-m/everything-claude-code，182K⭐）

接手陌生仓库时自动分析代码结构、梳理模块依赖、生成架构概览，快速理解项目全貌。

npx skills add affaan-m/everything-claude-code --skill codebase-onboarding

neat-freak — 文档同步（kkkkhazix/khazix-skills，10.7K⭐）

干完活一键同步：检查 CLAUDE.md 是否过时、更新项目文档、同步记忆系统。适合阶段性收尾。

npx skills add kkkkhazix/khazix-skills --skill neat-freak

---

A4. 特殊产出

clone-website — 网站克隆（julianromli/ai-skills，162⭐）

像素级克隆目标网站，多代理并行提取 CSS、资源、内容。SKILL.md 约 475 行，上下文较重，用完建议移除。

npx skills add julianromli/ai-skills --skill clone-website

pptx — PPT 生成（社区 skill）

一键生成带母版、图表的 PPT 初稿，省去从零排版。

npx skills add https://github.com/anthropics/skills --skill pptx

---

七、MCP 配套

Skills 负责"怎么做"，MCP 负责"接上工具"。两者互补，不冲突。

强烈建议

MCP	解决的问题	配置要点
Context7	AI 训练数据可能过时，查库/框架用法时自动拉最新官方文档	安装后自动触发
GitHub MCP	PR、Issue、Actions、仓库操作	需要 GitHub Token
Playwright / Browser MCP	浏览器测试、UI 验收、截图检查	需安装 Playwright 依赖

建议

MCP	解决的问题	配置要点
Database MCP（MySQL/PostgreSQL）	数据库检查、迁移验证、查询排障	需配置数据库连接信息
Sentry MCP	上线后异常定位、错误堆栈追踪	需 Sentry 项目的 DSN

---

八、冲突速查

以下为第一节所列冲突的速查表，快速查阅即可。

自带能力	本文推荐的 Skill	处理方式
/review	code-review-and-quality（第六段）	让 addyosmani 五轴审查接管，不再手动调 /review
skill-creator（.system 层）	保留自带	不装 anthropics 版本，自带的是 OpenAI 官方维护

---

九、维护

npx skills ls -g            # 查看已安装
npx skills update -g -y     # 更新所有
npx skills search <关键词>   # 查找新 Skill

每月检查一次：

• 半年没触发过的 → 移除
• 多个 Skill 讲同一件事 → 保留来源更强的
• 主栈变了 → 调整技术栈增强层

---

十、速查卡片

首次必配：行为准则（AGENTS.md，每次会话自动生效）

极简核心（3 个底座）：
  brainstorming + writing-plans + TDD

九段流程（按需补全）：
  需求 → UI → 架构 → 编码 → 测试 → 审查 → 部署 → 文档 → 运维

Codex 专属增强（5 个）：
  awesome-codex-skills + repomix + follow-builders + codex-plusplus + keep-codex-fast

注意：
  Codex 自带 skill-creator，不用再装
  Codex 自带 /review，让 addyosmani 接管
  不支持 Hooks 和自定义 Slash 命令，planning-with-files、ralph-loop、mattpocock 系列不可用