很多人使用 Codex 时，只让它完成“写代码”这一件事。

遇到需求就生成代码，出现报错再继续修改。这样的使用方式虽然方便，但 Codex 很难理解项目背景，也容易出现需求理解偏差、界面模板化、修改范围过大等问题。

更有效的方法，是通过 Agent Skills 为 Codex 增加固定的知识、规则和工作流程。

Skill 本质上是一组可重复使用的说明、脚本和资源。它可以让 Codex 在执行特定任务时，按照预先设定的流程工作，而不是每次都依赖临时提示词。OpenAI 的 Skills 项目也将其定义为帮助 Codex 扩展专业能力的模块化目录。¹

下面这 5 个 Skill，分别解决知识管理、方案审查、UI 设计、中文写作和代码质量问题。

一、obsidian-skills：把 Obsidian 变成 Codex 的知识库

在长期项目中，真正影响 AI 工作质量的往往不是模型能力，而是它不知道你之前做过什么。

例如：

• 项目已经确定了哪些技术方案
• 哪些错误曾经出现过
• 用户有哪些固定偏好
• 某项设计为什么被放弃
• 当前项目有哪些待办事项

obsidian-skills 可以让 Codex 读取和管理 Obsidian 知识库中的 Markdown 笔记、任务、属性、Bases 和 JSON Canvas。

该项目遵循 Agent Skills 规范，并明确支持 Codex CLI 等兼容 Skills 的 AI 编程工具。²

它能解决什么问题

使用这个 Skill 后，可以让 Codex：

• 搜索 Obsidian 中的历史笔记
• 创建和更新项目文档
• 整理零散的开发记录
• 查找与当前任务相关的内容
• 将解决方案沉淀为长期知识
• 根据历史记录继续未完成的工作

适合的使用场景

例如你可以告诉 Codex：

1
2
3

搜索 Obsidian 中与当前网站部署有关的笔记，
整理已经尝试过的方法、失败原因和最终解决方案，
然后根据这些信息继续排查问题。

这样可以减少重复解释项目背景，也能避免 AI 再次尝试已经失败的方法。

需要注意：它主要负责帮助 AI 操作和整理 Obsidian 知识库，并不等于自动拥有完整的长期记忆。最终效果仍取决于你的笔记结构和记录质量。

二、UI Skill：减少 AI 生成网页的模板感

AI 可以快速生成网页，但生成结果经常存在明显的“AI 模板感”。

常见问题包括：

• 不分场景地使用紫蓝渐变
• 所有内容都居中排列
• 页面由大量相似卡片组成
• 默认使用常见字体和圆角
• 只考虑桌面端，没有检查移动端
• 视觉效果不错，但真实上线后不好使用

UI Skill 的作用不是提供一个固定模板，而是给 Codex 增加一套设计判断标准。

目前 GitHub 上已经有多种面向 Codex 的 UI Skills。例如 ui-ux-pro-max-skill 提供了 UI 风格、配色、字体组合、产品类型、UX 规则和图表类型等设计知识，可用于网页和移动端界面的规划、生成、审查与优化。³

1. 建立设计黑名单

可以在 Skill 中明确禁止一些容易产生模板感的设计：

1
2
3
4
5
6
7
8

除非项目明确要求，否则不要默认使用：

- 紫色到蓝色的渐变背景
- 所有标题和内容居中对齐
- 大量相同尺寸的信息卡片
- 缺乏层级的圆角矩形
- 没有业务含义的装饰性光效
- 默认套用科技 SaaS 网站风格

设计黑名单并不是完全禁止这些元素，而是要求 Codex 在使用前说明理由。

2. 根据业务选择设计语言

品牌官网、个人博客和后台管理系统，不应该使用完全相同的设计方式。

Skill 可以要求 Codex先判断页面类型：

3. 增加上线前质检

页面完成后，要求 Codex 检查：

• 手机端图片是否变形
• 长英文和链接是否可以换行
• 按钮是否有明确反馈
• 文字对比度是否足够
• 页面加载是否依赖过大的图片
• 表单是否提供错误提示
• 页面是否存在横向溢出
• 键盘操作是否正常

这样可以让 Codex 从“生成一个好看的页面”，升级为“交付一个可以实际使用的页面”。

三、Humanizer-zh：减少中文内容的 AI 味

Codex 不只能写代码，也经常被用于生成：

• 产品介绍
• README 文档
• 博客文章
• 更新日志
• 网站文案
• 操作说明
• 社交媒体内容

但 AI 生成的中文常常存在表达生硬、结构重复和营销感过强的问题。

Humanizer-zh 是一个中文内容优化 Skill，主要用于识别并减少 AI 写作痕迹，让文字更自然、更接近真实中文表达。其项目说明中明确提到，它可以用于编辑或审阅 AI 生成的文本。⁴

常见的 AI 写作问题

它可以重点检查以下内容：

• 频繁使用“值得注意的是”
• 每段都使用相同句式
• 过度使用“赋能”“重塑”“开启新篇章”
• 没有事实支撑的夸张表达
• 大量使用“首先、其次、最后”
• 句子看似完整，但缺少具体信息
• 中文中出现明显的英文翻译腔

使用示例

完成网站文章后，可以让 Codex 执行：

1
2
3
4
5
6
7
8

使用 Humanizer-zh 检查这篇文章。

要求：
1. 删除空泛和夸张的营销表达；
2. 保留技术事实、命令和项目名称；
3. 调整重复句式；
4. 使用自然、简洁的中文；
5. 不要为了口语化而降低专业性。

它适合作为内容发布前的最后一道编辑流程，而不是简单地把所有内容改成口语。

四、grill-me：在开发之前先把方案问清楚

AI 编程最常见的问题之一，是需求还没有明确，AI 就已经开始写代码。

结果通常是：

• 技术路线选择错误
• 功能边界不断扩大
• 忽略重要异常情况
• 修改大量无关文件
• 做完以后才发现需求理解错了

grill-me 的作用，就是在动手开发前扮演一个严格的方案审查者。

该 Skill 会围绕计划、设计或技术方案持续追问，直到关键决策、假设和分支得到明确。⁵

它会重点追问什么

例如开发一个用户登录功能时，grill-me 不会立刻生成代码，而是先检查：

• 使用邮箱、手机号还是第三方账号登录
• 是否需要注册、找回密码和邮箱验证
• 登录状态保存多久
• 是否允许多设备同时登录
• 失败次数是否需要限制
• 用户数据存储在哪里
• 哪些页面需要登录后访问
• 是否存在管理员和普通用户权限

推荐使用阶段

grill-me 最适合在以下阶段使用：

• 新功能开发之前
• 数据库结构确定之前
• API 接口设计之前
• 大规模重构之前
• 技术方案评审之前
• 项目需求仍然比较模糊时

使用示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

使用 grill-me 审查下面的开发方案。

在需求和边界没有明确之前，不要编写代码。
请重点检查：

- 隐含假设
- 异常流程
- 数据安全
- 权限设计
- 技术复杂度
- 后期维护成本

这个 Skill 看起来会让前期讨论变慢，但通常能减少后期返工。

五、编码原则 Skill：限制 Codex 的修改范围

前面四个 Skill 解决了知识、方案、设计和内容问题，最后还需要一套编码原则来限制 Codex 的执行行为。

这部分不一定需要安装现成项目，也可以根据自己的开发习惯创建一个自定义 SKILL.md。

推荐的核心原则

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

# 编码原则

## 1. 不猜测需求

需求不明确时，先检查现有代码、文档和配置。

如果仍然无法确定，应明确说明假设，不要把猜测当成事实。

## 2. 只做最小必要修改

只修改完成当前任务必需的文件。

不要顺便重构无关代码，不要更改没有问题的目录结构。

## 3. 不擅自增加抽象

没有明确复用需求时，不新增：

- 通用工具层
- 复杂设计模式
- 多余的配置系统
- 不必要的第三方依赖

优先使用项目现有结构和原生能力。

## 4. 保持原有代码风格

修改前先检查：

- 命名规则
- 目录结构
- 格式化配置
- 错误处理方式
- 测试写法
- 已使用的组件和依赖

新增代码应与现有项目保持一致。

## 5. 修改后必须验证

完成修改后至少执行：

- 类型检查
- 语法检查
- 相关测试
- 构建检查
- 修改内容复核

如果无法执行某项验证，需要明确说明原因。

## 6. 不隐藏问题

不要通过删除测试、关闭类型检查、忽略错误或使用空异常处理来让任务表面通过。

发现现有问题时，应区分：

- 本次修改引入的问题
- 项目原本存在的问题

这套规则的重点不是让 Codex 少写代码，而是让每次修改都更可预测、更容易审查。

五个 Skill 如何组成完整工作流

这五个 Skill 并不是相互独立的工具，可以按照开发流程组合使用。

第一步：读取历史知识

使用 obsidian-skills 搜索项目笔记、历史方案和踩坑记录。

第二步：审查需求

使用 grill-me 挑战需求和技术方案，找出缺失信息与边界情况。

第三步：设计并实现界面

使用 UI Skill 确定设计语言、页面结构、响应式规则和质检标准。

第四步：优化文字内容

使用 Humanizer-zh 调整页面文案、README 和博客内容，减少机械化表达。

第五步：完成最小修改并验证

使用编码原则 Skill 限制修改范围，并执行测试、构建和代码检查。

完整流程可以概括为：

1
2
3
4
5
6
7
8
9

历史知识检索
    ↓
需求追问与方案审查
    ↓
UI 设计与代码实现
    ↓
中文内容优化
    ↓
测试、验证与交付

实际使用时，不需要每次启用全部 Skill

五个 Skill 不一定每次都要同时使用。

可以根据任务类型进行组合：

Skill 数量并不是越多越好。真正重要的是每个 Skill 都有明确职责，并且不会互相冲突。

总结

Codex 的价值不只是生成代码。

通过 Skills，可以将知识、规范和工作流程固定下来，让 Codex逐渐具备以下能力：

• 读取并整理项目知识
• 在开发前审查需求
• 根据业务选择设计语言
• 优化中文内容表达
• 控制代码修改范围
• 在交付前完成自我验证

最终目标不是让 Codex 一次生成更多代码，而是减少沟通成本、降低返工概率，让每次修改都更加稳定和可控。

GitHub 项目地址

• OpenAI Skills：Codex Skills 官方目录
• obsidian-skills
• Humanizer-zh
• grill-me 所在 Skills 项目
• UI UX Pro Max Skill
• Codex Frontend Design Skill

“编码原则”部分属于可自行创建的自定义 Skill，并非本文确认的单一 GitHub 项目。