Skill 怎么用：从触发到调整的实战示例

Skill 实战：怎么触发、怎么调整、怎么组合

6 个场景，从自动触发到手动指定到调试修改

场景一：自动触发 — 你说话，Agent 自己匹配技能
大多数情况下你不需要主动提 Skill，Agent 自己会认出来
Agent 启动时会扫描所有 Skill 的名称和描述（只看元数据，不读全文）。当你说的话跟某个 Skill 的描述匹配时，Agent 自动加载并使用它。
帮我写本周周报
匹配到技能：write-weekly-report → 加载完整 SKILL.md
好的，按照周报技能的流程来：
读取 reference/上周周报 了解格式
读取 data/CSV 计算各平台汇总
读取 notes/ 获取上下文
按模板格式生成周报
检查：老板要求是否全部覆盖 ✓
你什么都没提，Agent 自动匹配到了"写周报"技能，按照技能里定义的 5 个步骤执行。如果没有这个 Skill，它会用通用能力"自由发挥"——可能漏步骤、格式不对。
场景二：手动指定 — 直接告诉 Agent 用哪个技能
当自动匹配不准、或者你想指定某个技能时
用 data-analysis 技能分析这份 CSV，然后用 make-pptx 技能把结果做成 PPT
加载技能：data-analysis + make-pptx
第一步，按 data-analysis 技能：
用 pandas 读取 CSV，生成汇总统计
金额用柱状图，趋势用折线图
数字加千分位，百分比保留一位小数
第二步，按 make-pptx 技能：
使用公司模板，配色 #003366 + #F5A623
已保存到 output/Q1-analysis.pptx
你在一句话里串联了两个 Skill，Agent 按顺序执行。这就是技能组合——每个 Skill 只负责一件事，像积木一样拼起来完成复杂任务。
场景三：查看 Agent 有哪些技能
"你会什么？让我看看"
# Claude Code
> 你现在有哪些 skills？列出来看看

# 或者用命令查看
$ ls ~/.claude/skills/
$ npx skills list # skills.sh 安装的

# OpenClaw
$ openclaw skills list

# Hermes
$ hermes skills list
你现在有哪些技能？
当前已加载的技能：

📊 data-analysis — 分析 CSV/Excel 数据并生成图表
📄 make-pptx — 按公司模板生成 PPT
📝 write-weekly-report — 生成运营周报
🔍 web-search — 搜索网页并整理信息
📧 email-draft — 按公司格式起草邮件
共 5 个技能。说"用 xxx 技能"可以手动指定。
场景四：技能的输出不太对，临时调整
Skill 是默认方案，你可以在对话中覆盖
帮我做一份 PPT
使用技能：make-pptx
已按公司模板生成 PPT，配色 #003366 + #F5A623，保存到 output/report.pptx
这次不用公司模板，用黑底白字的极简风格，字体用 Helvetica
好的，这次覆盖技能的默认配置：
背景改为纯黑 #000000
文字改为白色 Helvetica
其余流程（页码、检查等）仍按技能执行
已保存到 output/report-minimal.pptx
你在对话中说的话优先级高于 Skill。Skill 提供的是"默认方案"——当你不做特别说明时按它来。但你随时可以在对话里覆盖任何一条规则，Agent 会以你说的为准。
场景五：永久修改技能 — 让 Agent 帮你改 SKILL.md
如果每次都要覆盖同一条规则，不如直接改技能文件
以后 PPT 默认就用极简黑底风格，帮我把 make-pptx 技能更新一下
好的，更新 skills/make-pptx/SKILL.md：
配色从 #003366 改为 #000000 + #FFFFFF
字体从思源黑体改为 Helvetica
其余步骤保持不变
技能已更新，以后做 PPT 默认就是极简风格了。
你也可以直接打开 SKILL.md 文件自己编辑——它就是一个普通文本文件。或者让 Agent 帮你改，它会直接修改文件内容。
# 手动编辑也行
$ vim ~/.claude/skills/make-pptx/SKILL.md

# 或者让 Agent 改
> 帮我把 make-pptx 技能的默认配色改成深色主题
场景六：技能没生效？怎么排查
装了技能但 Agent 好像没用——常见原因和解决方法
帮我做 PPT
好的，我来帮你做一份 PPT……（用了默认样式，完全没按你的技能来）
你怎么没用 make-pptx 技能？
常见原因和排查方法：
# ① 文件放错位置了
$ ls ~/.claude/skills/ # 确认文件在 skills 目录下
$ cat ~/.claude/skills/make-pptx/SKILL.md # 确认文件存在且有内容

# ② 技能名称/描述没写好，Agent 没匹配上
# → 检查 SKILL.md 开头的 name 和 description 是否清晰
# → description 要包含用户可能说的关键词（"PPT""演示""幻灯片"）

# ③ 确认 Agent 看到了哪些技能
> 列出你当前加载的所有技能

# ④ Codex 专用验证
$ codex --ask-for-approval never "Summarize the current instructions and skills"

# ⑤ Claude Code 专用验证
> /skills # 查看已加载技能列表
最常见的问题是 description 写得太笼统。比如你写了 description: 做文档，但你说的是"帮我做 PPT"——Agent 不一定能匹配上。改成 description: 制作 PPT、演示文稿、幻灯片 就能命中了。