国内用户如何快速筛选 Codex Skill

这份文档重点解决三个问题：

1. 看到一堆 skill，不知道该装哪个。
2. 国内网络环境下，有些服务访问不稳定，不知道怎么选。
3. 装完 skill 后，不知道怎么快速调用。

一句话建议：先按任务选 skill，不要按名字选。新手不需要一次装很多，先装 5-8 个高频的就够。

1. Skill 是什么

Skill 可以理解成 Codex 的“专项工作方法”。比如：

• 处理 PDF 时，用 pdf
• 检查网页时，用 playwright 或 screenshot
• 查 OpenAI 官方文档时，用 openai-docs
• 整理录音时，用 transcribe
• 修 GitHub PR 时，用 gh-fix-ci 或 gh-address-comments

它不是普通插件商店里的 App，更像是一套任务流程说明。Codex 使用 skill 后，会更清楚应该先看什么、怎么验证、最后怎么交付。

2. 国内用户筛选 skill 的原则

原则一：先选本地能力，再选联网能力

国内网络环境下，GitHub、Notion、Figma、部分部署平台可能不稳定。所以建议优先选择能在本地完成工作的 skill：

• pdf
• doc
• playwright
• screenshot
• jupyter-notebook
• transcribe
• security-best-practices

这些 skill 即使需要少量网络，也不会完全依赖某个海外 SaaS。

原则二：先解决高频问题

新手、学生最常见的问题通常是：

• 文件看不懂
• PDF / Word / 表格要整理
• 网页要截图检查
• 代码报错
• 课程录音要转文字
• 作业数据要分析
• 查资料怕过期

所以先装“文档、网页、数据、官方文档”类 skill，收益最高。

原则三：暂时不要装太多

skill 多了不是坏事，但新手会更容易混乱。建议先装一组常用的，用熟之后再补。

推荐第一批：

openai-docs
screenshot
jupyter-notebook
transcribe
security-best-practices

如果你已经有 pdf、doc、playwright，就不用重复装。

3. 当前 curated skill 分类

下面按用途分类，比按字母表更容易选。

4. 文档与资料类

适合学生、研究、写报告、整理资料。

Skill	推荐度	用途	国内使用建议
pdf	高	读 PDF、提取表格、检查 PDF	本地文件处理，推荐
doc	高	Word 文档排版、修改、检查	本地文件处理，推荐
openai-docs	高	查询 OpenAI / Codex 官方文档	需要联网，但很有用
notion-knowledge-capture	中	整理知识到 Notion	依赖 Notion，网络不稳时慎用
notion-research-documentation	中	研究资料整理	依赖 Notion
notion-meeting-intelligence	中	会议纪要整理	依赖 Notion

推荐安装：

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/openai-docs

使用方式：

请使用 openai-docs skill，帮我查 Codex 当前官方用法。
要求：
1. 优先官方资料
2. 给出链接
3. 用中文总结
4. 不要使用过期资料

请使用 pdf skill，帮我总结这个 PDF。
要求：
1. 先提取文章结构
2. 再总结核心观点
3. 如果有表格，单独整理
4. 不确定的地方不要编造

5. 网页、前端与截图类

适合做网页作业、作品集、前端项目、UI 检查。

Skill	推荐度	用途	国内使用建议
playwright	高	打开网页、自动化浏览器、截图检查	本地项目很适合
screenshot	高	快速截图和视觉检查	推荐
playwright-interactive	中	更交互式地操作网页	需要时再装
figma	中	Figma 相关操作	依赖 Figma 网络
figma-implement-design	中	根据 Figma 设计稿实现页面	有设计稿时再装
figma-generate-design	中	生成设计方案	依赖 Figma

推荐安装：

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/screenshot skills/.curated/playwright-interactive

如果你做 Figma 到前端：

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/figma skills/.curated/figma-implement-design

使用方式：

请使用 playwright skill，启动本地项目并检查首页。
要求：
1. 桌面端和手机端都要看
2. 检查是否有文字溢出、按钮重叠、页面空白
3. 如果有问题，直接修复
4. 修复后截图验证

请使用 screenshot skill，帮我截取这个网页的桌面端和手机端效果。
重点检查页面是否像正式产品，而不是临时 demo。

6. 数据分析与学习类

适合课程作业、实验报告、CSV / Excel 分析、图表制作。

Skill	推荐度	用途	国内使用建议
jupyter-notebook	高	生成 notebook、数据分析过程记录	推荐
transcribe	高	音频转文字、课堂录音整理	推荐
speech	中	语音相关能力	有语音需求再装

推荐安装：

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/jupyter-notebook skills/.curated/transcribe

使用方式：

请使用 jupyter-notebook skill，帮我分析这个 CSV。
要求：
1. 先检查字段和缺失值
2. 再做统计和图表
3. 每一步写清楚解释
4. 最后给出适合写进报告的结论

请使用 transcribe skill，把这段课堂录音转成文字。
要求：
1. 按主题分段
2. 去掉明显口头禅
3. 提炼重点知识点
4. 最后列出待复习问题

7. 代码开发类

适合写工具、做小项目、迁移到 Codex、Windows 应用。

Skill	推荐度	用途	国内使用建议
cli-creator	高	创建命令行工具	本地可用，推荐
chatgpt-apps	中	开发 ChatGPT Apps	需要相关平台能力
aspnet-core	中	ASP.NET Core 项目	做 .NET 时再装
winui-app	中	Windows 桌面应用	做 Windows 应用时再装
migrate-to-codex	中	把已有流程迁移到 Codex	有迁移需求再装

推荐安装：

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/cli-creator

如果你要做 ChatGPT App：

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/chatgpt-apps

使用方式：

请使用 cli-creator skill，帮我做一个命令行小工具。
功能：批量把文件名里的空格替换成下划线
要求：
1. 先预览，不要直接改
2. 支持确认后执行
3. 给出使用示例
4. 代码适合新手理解

8. GitHub 协作类

适合开源项目、团队项目、PR、CI、提交代码。

Skill	推荐度	用途	国内使用建议
gh-address-comments	高	处理 PR review comments	依赖 GitHub
gh-fix-ci	高	修 GitHub Actions 失败	依赖 GitHub
yeet	中	提交代码并开 PR	依赖 GitHub
linear	低-中	Linear 任务管理	国内普通用户不高频

推荐安装：

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/gh-address-comments skills/.curated/gh-fix-ci

使用方式：

请使用 gh-fix-ci skill，帮我检查这个 PR 的 CI 为什么失败。
要求：
1. 先读失败日志
2. 只修和失败相关的问题
3. 不要顺手重构
4. 修完说明验证结果

请使用 gh-address-comments skill，处理这个 PR 里的 review comments。
要求：
1. 先列出未解决评论
2. 判断哪些需要改
3. 逐条处理
4. 最后总结改动

9. 部署类

适合作品集、课程网页、小工具上线。

Skill	推荐度	用途	国内使用建议
vercel-deploy	高	部署到 Vercel	国内访问可能不稳定，但前端常用
netlify-deploy	中	部署到 Netlify	类似 Vercel
cloudflare-deploy	中	部署到 Cloudflare	需要账号和配置
render-deploy	中	部署后端或全栈应用	需要账号和配置

推荐安装：

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/vercel-deploy

使用方式：

请使用 vercel-deploy skill，帮我检查这个前端项目能不能部署到 Vercel。
要求：
1. 先本地 build
2. build 通过后再部署
3. 不要提交无关文件
4. 最后给出部署地址和注意事项

国内用户提醒：如果只是给老师或同学看，优先保证本地能运行。线上部署可以作为加分项，不要把全部时间耗在部署平台登录和网络问题上。

10. 安全类

适合登录、权限、后端接口、上传文件、数据库。

Skill	推荐度	用途	国内使用建议
security-best-practices	高	基础安全检查	推荐
security-threat-model	中	威胁建模	中大型项目再用
security-ownership-map	中	安全责任边界	团队项目更适合
sentry	中	错误监控	依赖 Sentry 服务

推荐安装：

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/security-best-practices

使用方式：

请使用 security-best-practices skill，检查这个登录接口。
重点看：
1. 密码是否安全处理
2. 是否有权限绕过
3. 输入是否校验
4. 错误信息是否泄露敏感内容
5. 给出能落地的修改建议

11. 设计与产品类

适合 UI 设计、产品原型、Figma 工作流。

Skill	推荐度	用途	国内使用建议
figma-generate-design	中	生成设计稿	依赖 Figma
figma-create-new-file	中	新建 Figma 文件	依赖 Figma
figma-generate-library	低-中	生成组件库	适合团队
figma-create-design-system-rules	低-中	设计系统规则	适合团队
figma-code-connect-components	低-中	代码组件连接	适合成熟项目
figma-use	中	使用 Figma 文件	有 Figma 需求时装

普通学生不建议一开始装全套 Figma skill。你真的有设计稿，先装：

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/figma skills/.curated/figma-implement-design

12. 多媒体类

适合视频、语音、素材处理。

Skill	推荐度	用途	国内使用建议
sora	中	生成或处理 Sora 视频	需要账号和权限
transcribe	高	音频转文字	推荐
speech	中	语音生成或处理	有需求再装

推荐安装：

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/transcribe

使用方式：

请使用 transcribe skill，把这个录音整理成课堂笔记。
要求：
1. 转写文字
2. 按知识点分段
3. 总结重点
4. 列出我需要复习的问题

13. 快速安装组合

组合 A：国内新手通用

适合大多数人。

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/openai-docs skills/.curated/screenshot skills/.curated/jupyter-notebook skills/.curated/transcribe skills/.curated/security-best-practices

组合 B：大学生作业和论文

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/openai-docs skills/.curated/jupyter-notebook skills/.curated/transcribe

再配合你本地已有的：

pdf
doc
academic-research
Data Analysis

组合 C：前端作品集

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/screenshot skills/.curated/vercel-deploy

如果你用 Figma：

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/figma skills/.curated/figma-implement-design

组合 D：GitHub 项目协作

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/gh-address-comments skills/.curated/gh-fix-ci skills/.curated/yeet

组合 E：后端和安全

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/security-best-practices skills/.curated/security-threat-model

14. 快速使用方式

最简单的格式：

请使用 [skill 名称] skill，帮我完成 [任务]。
要求：
1. 先检查相关文件
2. 不确定的地方不要编造
3. 给出可复制命令
4. 完成后总结改动和验证结果

例子：

请使用 screenshot skill，检查我的网页首页。
要求：
1. 看桌面端和手机端
2. 找出页面错位、文字溢出、按钮重叠
3. 如果能修，请直接修
4. 修完截图验证

请使用 jupyter-notebook skill，把这个数据分析过程整理成 notebook。
要求：
1. 代码能从上到下运行
2. 每一步有中文解释
3. 图表清楚
4. 最后写出结论

请使用 security-best-practices skill，检查我这个后端接口。
要求：
1. 找明显安全风险
2. 按严重程度排序
3. 给出具体修改建议
4. 不要泛泛而谈

15. 推荐的优秀 skill

下面是更适合国内普通用户、新手和学生的优先推荐。

openai-docs

推荐理由：查 OpenAI / Codex 相关内容时，网上教程很容易过期。这个 skill 可以优先看官方文档。

适合：

• 查 Codex 当前功能
• 查 GPT-5.5 / API 用法
• 写 OpenAI 项目
• 避免看旧教程踩坑

playwright

推荐理由：网页项目最怕“我以为好了，其实页面没打开”。playwright 可以真实打开浏览器检查。

适合：

• 前端作业
• 个人主页
• 管理后台
• 移动端适配

screenshot

推荐理由：比口头描述更直观。做网页、PPT、报告封面时，截图检查很有用。

适合：

• 检查 UI
• 做项目展示图
• 验证页面是否空白

pdf

推荐理由：学生和研究场景高频。读论文、提表格、总结资料都很实用。

适合：

• 论文阅读
• 教材资料总结
• PDF 报告检查

doc

推荐理由：Word 排版是很多人浪费时间的地方。这个 skill 适合改报告、简历、课程文档。

适合：

• 课程报告
• 实习文档
• 简历初稿
• 正式文档排版

jupyter-notebook

推荐理由：数据分析作业需要过程，不只是结果。notebook 能把代码、图表、解释放在一起。

适合：

• 数据分析课程
• Python 实验
• 机器学习入门
• 可视化作业

transcribe

推荐理由：课堂录音、访谈、会议纪要都很常用。比手动听写省时间。

适合：

• 课堂笔记
• 访谈整理
• 会议纪要

security-best-practices

推荐理由：新手写登录、上传、数据库接口时，很容易忽略安全。这个 skill 可以做基础检查。

适合：

• 登录注册
• 后端接口
• 管理员功能
• 文件上传

gh-fix-ci

推荐理由：GitHub Actions 报错对新手很不友好。这个 skill 适合定位 CI 失败原因。

适合：

• 开源项目
• 团队作业
• PR 检查

16. 不建议新手一开始安装的 skill

不是不好，而是使用门槛或依赖条件更高。

Skill	原因
figma-generate-library	更适合设计系统或团队组件库
figma-code-connect-components	适合成熟前端工程
security-ownership-map	更适合团队安全责任划分
linear	依赖 Linear 工作流，国内学生不高频
render-deploy	部署配置可能卡住新手
sentry	需要接入监控服务，适合上线项目

17. 安装失败时怎么处理

先看是否已经安装：

Get-ChildItem "$env:USERPROFILE\.codex\skills" -Directory | Select-Object -ExpandProperty Name

再看官方列表：

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\list-skills.py"

如果 GitHub 下载慢或失败，建议：

1. 换一个网络环境后重试。
2. 少量多次安装，不要一次装太多。
3. 优先装本地高频 skill，比如 screenshot、jupyter-notebook、transcribe。
4. 已经安装成功的不要重复装。

安装完成后，重启 Codex。

18. 最小推荐方案

如果你完全不知道选什么，就用这个组合：

python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo openai/skills --path skills/.curated/openai-docs skills/.curated/screenshot skills/.curated/jupyter-notebook skills/.curated/transcribe skills/.curated/security-best-practices

然后日常这样调用：

请使用合适的 skill 帮我完成这个任务。
如果有多个 skill 可选，请先说明你会用哪个，以及为什么。
任务：[写你的任务]

这比一次装几十个更稳，也更适合新手建立使用习惯。