*看到任务类型，就知道该叫哪个技能。越具体地描述目标、输入和交付物，Codex 越容易自动匹配合适的 skill。*
一句话总结
Codex skill 可以理解为一套“任务专用说明书 + 工作流约束 + 工具使用习惯”。它不是普通提示词，也不只是模板，而是让 Codex 在遇到特定任务时自动切换到更专业的做事方式。
比如：
- 你说“把这篇文章整理进 Obsidian”，Codex 会优先使用
obsidian-markdown。 - 你说“给文章配图，用暖纸高信息手绘笔记风格”，Codex 会组合使用
imagegen和imagegen-style-presets。 - 你说“修 GitHub PR 里的 review comments”，Codex 会使用
gh-address-comments。 - 你说“打开浏览器跑一下 UI 流程”，Codex 会使用
playwright或 Browser Use 插件。
最自然的用法不是先想“我要调用哪个 skill”，而是直接说任务。Codex 会根据任务自动匹配；当你有明确偏好时，也可以点名 skill。
Skill 是什么
Skill 通常是一个带有 SKILL.md 的目录，里面写着：
- 这个 skill 适合什么任务。
- 什么时候必须使用它。
- 应该优先用哪些工具。
- 文件应该怎么创建、验证、保存。
- 哪些做法要避免。
本机主要目录：
C:\Users\micke\.codex\skills系统内置 skill 在：
C:\Users\micke\.codex\skills\.system你后续安装的新 skill 通常会出现在：
C:\Users\micke\.codex\skills\<skill-name>\SKILL.md怎么使用
1. 直接描述任务
这是最推荐的方式。
把下面文章整理成 Obsidian 笔记，保留原文结构，并加上 frontmatter。给这篇文章配图，用暖纸高信息手绘笔记风格。帮我检查这个 PR 的 review comments，并修掉能修的。2. 点名 skill
当你知道自己想用哪个 skill，可以直接说：
用 obsidian-markdown 写一篇关于 AI Agent 的笔记。用 defuddle 把这个网页提取成 Markdown。用 playwright 跑一下登录流程并截图。3. 组合多个 skill
有些任务天然需要多个 skill 串起来：
用 defuddle 抓取网页正文，再用 obsidian-markdown 整理进 Obsidian，并用暖纸高信息手绘笔记风格配图。这类任务通常会形成链路：
网页提取 -> Markdown 整理 -> Obsidian 保存 -> imagegen 配图 -> 插入图片引用
4. 安装新 skill 后重启
新安装 skill 后，一般需要重启 Codex 才能稳定识别。
当前文章里的清单来自本机目录扫描，时间为 2026-05-11。
本机 Skills 总览
Obsidian 与知识库
| Skill | 是什么 | 适合做什么 | 用法示例 |
|---|---|---|---|
obsidian-markdown | Obsidian Flavored Markdown 写作技能 | 创建和编辑 .md，处理 wikilinks、embeds、callouts、properties | “用 obsidian-markdown 把这篇文章整理进 Obsidian” |
obsidian-bases | Obsidian Bases .base 文件技能 | 创建表格视图、卡片视图、过滤器、公式和摘要 | “给我的技术笔记做一个按 status/tag 筛选的 base” |
json-canvas | JSON Canvas 文件技能 | 创建 .canvas 思维导图、流程图、节点关系图 | “把这篇文章做成 Obsidian Canvas” |
obsidian-cli | Obsidian CLI 操作技能 | 搜索 vault、创建笔记、管理属性、调试插件和主题 | “搜索 vault 里所有包含 RAG 的笔记并整理索引” |
defuddle | 网页正文提取技能 | 从网页提取干净 Markdown，减少广告和导航干扰 | “用 defuddle 把这个网页转成 Markdown” |
图像、文章配图与文档
| Skill | 是什么 | 适合做什么 | 用法示例 |
|---|---|---|---|
imagegen | Codex 图像生成/编辑技能 | 生成文章配图、封面、插图、纹理、产品图、透明图等位图资产 | “给这篇文章生成一张配图” |
imagegen-style-presets | 本机图像风格预设 | 复用 暖纸手绘笔记 和 暖纸高信息手绘笔记 两种风格 | “用暖纸高信息手绘笔记风格画一张参数图” |
doc | .docx 文档处理技能 | 读取、创建、编辑 Word 文档，重视排版和渲染检查 | “把这份内容整理成 Word 报告” |
pdf | PDF 处理技能 | 读取、生成、审阅 PDF，适合需要页面渲染和版面检查的任务 | “检查这个 PDF 的页码和排版” |
GitHub 与工程协作
| Skill | 是什么 | 适合做什么 | 用法示例 |
|---|---|---|---|
gh-address-comments | GitHub review/issue comment 处理技能 | 查看当前分支 PR 评论，逐条修复可操作反馈 | “处理这个 PR 上未解决的 review comments” |
gh-fix-ci | GitHub Actions CI 修复技能 | 查看失败 checks 和日志，定位 CI 问题，制定修复方案 | “帮我看这个 PR 为什么 CI 挂了” |
浏览器、UI 与自动化测试
| Skill | 是什么 | 适合做什么 | 用法示例 |
|---|---|---|---|
playwright | 真实浏览器自动化技能 | 打开页面、点击、填写表单、截图、跑 UI 流程 | “用 playwright 打开 localhost:3000 检查页面” |
playwright-interactive | 持久浏览器/Electron 调试技能 | 长时间迭代 UI、保留浏览器状态、快速调试交互 | “保持浏览器会话，边改边看这个 Electron 页面” |
OpenAI、应用开发与桌面端
| Skill | 是什么 | 适合做什么 | 用法示例 |
|---|---|---|---|
openai-docs | OpenAI 官方文档技能 | 查询 OpenAI API、模型选择、迁移和 prompt 升级建议 | “查官方文档，告诉我 Responses API 怎么用” |
winui-app | WinUI 3 桌面应用开发技能 | 创建、设计、排查 Windows App SDK / WinUI 3 应用 | “帮我做一个 WinUI 3 桌面工具原型” |
Skill 与插件管理
| Skill | 是什么 | 适合做什么 | 用法示例 |
|---|---|---|---|
skill-installer | skill 安装技能 | 从官方 curated skills 或 GitHub repo 安装 skill | “安装 kepano/obsidian-skills 的所有 skill” |
skill-creator | skill 创建技能 | 设计或改造一个新的 Codex skill | “帮我创建一个专门整理会议纪要的 skill” |
plugin-creator | Codex plugin 创建技能 | 脚手架 .codex-plugin/plugin.json 和插件目录结构 | “帮我创建一个本地 Codex 插件” |
个人训练与工作流
| Skill | 是什么 | 适合做什么 | 用法示例 |
|---|---|---|---|
boundary-training | 边界感和情绪回弹训练技能 | 工作压力场景演练、回复分析、责任归属拆分、稳定表达训练 | “开始一次职场压力边界训练” |
本机图像风格预设
当前你已经保存了两个 imagegen 风格名：
暖纸手绘笔记
适合：
- 文章封面
- 低到中等信息密度的概念图
- 一张图讲 2-4 个核心观点
- 类似《索菲亚阶段不是更会共情，而是终于不再在共情中丢失自己》的配图风格
可直接这样说：
用暖纸手绘笔记风格给这篇文章画一张封面图。暖纸高信息手绘笔记
适合：
- 参数对比图
- 技术路线图
- 购买指南
- 工作流地图
- 多方案决策图
可直接这样说：
用暖纸高信息手绘笔记风格，把这篇文章的核心框架画成一张图。高信息图不要塞太多长句。更好的写法是“4-6 个模块，每个模块 2-4 个短标签”，这样中文字更容易清晰。
常见任务怎么选 Skill
| 任务 | 推荐 skill |
|---|---|
| 整理文章到 Obsidian | obsidian-markdown |
| 网页提取成 Markdown | defuddle |
| 做 Obsidian Canvas | json-canvas |
| 做 Obsidian 数据视图 | obsidian-bases |
| 搜索或操作 vault | obsidian-cli |
| 给文章配图 | imagegen + imagegen-style-presets |
| 生成或编辑 Word | doc |
| 处理 PDF | pdf |
| 跑浏览器 UI 测试 | playwright |
| 长时间交互式调试页面 | playwright-interactive |
| 查 OpenAI 官方文档 | openai-docs |
| 做 WinUI 桌面应用 | winui-app |
| 修 GitHub review comments | gh-address-comments |
| 查 GitHub Actions 失败 | gh-fix-ci |
| 安装新 skill | skill-installer |
| 创建新 skill | skill-creator |
| 创建 Codex plugin | plugin-creator |
| 做边界感训练 | boundary-training |
一些高效提示词模板
写入 Obsidian
把下面内容整理成一篇 Obsidian 笔记，保留原文结构，补充 frontmatter、tags、aliases，并放到技术目录。文章配图
给这篇 Obsidian 文章配 3 张图：封面图、框架图、决策图。统一使用暖纸高信息手绘笔记风格，图片保存到文章同级 imgs 目录，并插入  引用。网页剪藏
用 defuddle 提取这个网页正文，整理成 Obsidian 笔记，保留来源链接和关键引用。GitHub 协作
检查当前分支对应 PR 的 review comments，列出问题，能修的直接修，修完跑相关测试。UI 检查
用 playwright 打开本地页面，检查核心交互，截图并指出明显 UI 问题。OpenAI 文档
查 OpenAI 官方文档，告诉我这个功能最新推荐写法，并给出最小可运行示例。插件提供的额外能力
除了 C:\Users\micke\.codex\skills 里的本地 skills，当前 Codex Desktop 还启用了几个插件能力。它们有些不直接出现在主 skills 目录里，但在会话中可用：
| 插件 | 作用 |
|---|---|
| Browser Use | 操作 Codex in-app browser，适合打开 localhost、截图、检查页面 |
| GitHub | 查看 repo、PR、issue、CI，发布和协作 |
| Documents | 创建、编辑、渲染验证 .docx |
| Presentations | 创建、编辑、渲染验证 PPT/PPTX |
| Spreadsheets | 创建、分析、渲染验证 XLSX/CSV/TSV |
简单说：
- 本地
skills更像“任务说明书”。 - 插件更像“额外工具箱”。
- Codex 会根据任务把两者组合起来用。
使用建议
- 先说清楚目标、输入、输出位置。
- 如果要保存到 Obsidian，直接说明 vault 目录或分类。
- 如果要配图，说明风格、数量、插入位置。
- 如果你知道 skill 名，直接点名。
- 如果你不知道该用哪个 skill，只描述任务，让 Codex 自动选。
最后记住
Skills 的价值不是让你背工具名，而是让 Codex 在不同任务里少走弯路。你只要把任务说具体：要读什么、产出什么、放在哪里、用什么风格，剩下的 skill 匹配和执行流程可以交给 Codex。