想风技术文档🦁什么是skill ? 从最小 hello word skill 到写一个实用skill ！
简单说，Skill 就是给 AI Agent 准备的一份“能力说明书”。
它不只是提示词，而是一套可复用的工作方法：告诉 Agent 什么时候应该使用这个能 力、具体要遵循哪些步骤、需要读取哪些参考资料、是否可以调用脚本或素材。
这篇从最小的 Hello World Skill 开始，带你理解 Skill 的基本结构，再看 scripts、 references、assets 这些可选外挂资源，最后做一个真正能解决重复工作的实用 Skill。
第一步：认识skill，hello word skill
什么是skill?
Skill 也可以理解成：给 claude/Codex/Agent （下文以codex 为例）用的“可触发小手册”。
Skill不是插件，也不是代码包本身。通常是一个文件夹，里面至少有一个 SKILL.md。当用户请求匹配到这个 skill 的 description 时，Codex 会读取 SKILL.md，然后按里面的流程做事。
最小结构是：
hello-world/└── SKILL.md
简单的markdown 语法说明：
- .md 是markdown 语法文件
- --- 这个是分隔线
- name skill 名字
- description 描述会触发
- When this skill is used: 使用触发说明
更多可查询markdown 语法
最小 SKILL.md：
markdown
推荐放到：
~/.codex/skills/hello-world/SKILL.md
也就是：
mkdir -p ~/.codex/skills/hello-worldvim ~/.codex/skills/hello-world/SKILL.md
然后把上面的内容粘进去。之后开一个新 Codex 会话，试着说：
Use hello-world skill
或者：
runthehelloworldskill
一个 skill 最重要的是这三件事：
- name：小写、短横线命名，比如 hello-world
- description：触发条件，越清楚越好
- 正文：被触发后 Codex 应该怎么做
这是第一个 hello world skill非常精简, 不需要 scripts/、references/、assets/。较复杂的skill 才需要的。
使用效果测试：
第二步 scripts/、references/、assets/ 都是 skill 的“可选外挂资源”。
scripts/：可执行工具，放脚本，用来做稳定、重复、容易写错的操作。比如：
pdf-rotate/├── SKILL.md└── scripts/└── rotate_pdf.py
适合放：
scripts/
- 转 PDF 的 Python 脚本
- 批量改文件名脚本
- 调 API 的固定脚本
- 生成报告的脚本
- 校验格式的脚本
作用是：让 Codex 不用每次重新现场写一遍脆弱代码，而是调用已经准备好的工具。
references/：给 Codex 读的知识库放说明文档、规范、schema、流程、业务知识。它们不是直接输出给用户的，而是 Codex 在需要时读取。
比如：
company-report/├── SKILL.md└── references/├── tone.md├── metrics-schema.md└── report-structure.md
适合放：
references/
- 公司品牌语气
- 数据库表结构
- API 文档摘录
- 内部流程规范
- 某类文章的写作规则
作用是：让 SKILL.md 保持简洁，把大块背景知识按需读取。
assets/：输出时会用到的素材放模板、图片、字体、示例文件、项目骨架等“被拿来使用”的文件。
比如：
slide-maker/├── SKILL.md└── assets/├── template.pptx├── logo.png└── brand-font.ttf
适合放：
assets/
- PPT 模板
- Word 模板
- Logo、图片、图标
- 前端项目模板
- CSS 样式模板
- 示例 Excel 文件
作用是：Codex 可以复制、修改、嵌入这些素材，生成最终产物。
一个简单区分：
SKILL.md = 告诉 Codex 怎么做scripts/ = Codex 可以运行的工具references/ = Codex 可以阅读的知识assets/ = Codex 可以使用的素材
随手看三个真实可用的skill 目录
第三步：简单实践 做一个skill
skill 可以用来解决你的重复工作，比如我每次都要生成文章、标题、横幅、文章配图！ 直接和codex 说：根据目前的对话，生成一个skill，这个skill可以帮我生成横图和全文流程图就行,并教我一步一步添加到skill
- 确认你的智能体 skill 目录,codex 默认如下
ls ~/.codex/skills
- 创建skill 文件夹并进入
mkdir ~/.codex/skills/ai-tech-content-creator && cd~/.codex/skills/ai-tech-content-creator
- 创建 SKILL.md 和 vscode 打开skill.md
touch SKILL.md && code SKILL.md
- 写入内容
markdown
试用技能，先退出再进入！
codex
use ai-tech-content-creator 标题: 什么是skill ? 从最小 hello wordskill 到写一个实用skill ！ 流程:第一步，认识skill，hello word skilll 。第二步 ，scripts/、references/、assets/都是 skill 的“可选外挂资源”。第三步，简单实践 做一个skill。 根据标题和流程帮我生成图片
本文横幅和流程图就是 上文这个skill ai-tech-content-creator 生成的！
最后：
最后提醒一下，skill 是一个比较通用的工具 codex的skill, 放到claude、 cursor 也许也能用，但是还是有相关细微差别的，就是不完全通用，但理念和主体内容高度可迁移！这篇文章只是一个很简单的入门 ai skill,要写好专业的skill, 还是要多研究优秀实用的skill 源码！#skill#codex
上一篇
shopify主题编辑入门
下一篇
shopify入门教程最终章 多语言、多货币设置、订单处理、数据追踪
Loading...