Claude Code Skills 插件怎么写? 折腾一周后我的踩坑笔记
本文使用 AI 辅助写作，已核查事实并修改。 fortuneoxdemográtis trustguru.com.br pgdemo trustguru.com.br
上周 Anthropic 在 GitHub 上甩出了一个 knowledge-work-plugins 仓库，star 数蹿得飞快。我看了一眼示例，心想"这不就是把 prompt 包了一层吗"，于是花了一晚上想抄两个改改用。结果折腾了一周才搞明白——Skills 不是 prompt 模板，是带触发条件的本地工具集。 jogodotigrinhodemo trustguru.com.br A5game trustguru.com.br sobre trustguru.com.br
先给搜过来的朋友一个直接答案：Claude Code 的 Skill 插件本质上是 .claude/skills//SKILL.md，里面写 description 决定什么时候触发，正文写让 Claude 怎么做事，可以挂脚本、读文件、调 API。 你不用写代码就能写一个，但要写好得理解触发模型。 isabela trustguru.com.br autores trustguru.com.br
下面是我这一周筛出来 3 个最高频的用法。 slotpix trustguru.com.br tigrinhodemo trustguru.com.br pglucky88 trustguru.com.br Bet365 trustguru.com.br
一句话结论
| Skill 类型 | 适合场景 | 实现难度 | 是否调外部 API |
|---|---|---|---|
| 纯 markdown 模板 | 周报、PRD、commit message 规范 | 低 | 否 |
| Markdown + 脚本 | 批量改文件、生成代码、跑测试 | 中 | 否 |
| 多模型协作 | 用 GPT 写、Claude 审，或 Gemini 看图 | 高 | 是 |
环境准备
Claude Code 版本要 ≥ 2.0，老版本不识别 skills 目录。 bonus trustguru.com.br
mkdir -p .claude/skills/weekly-report
cd .claude/skills/weekly-report
方案一：纯模板 Skill（写周报）
最简单的玩法，一个 SKILL.md 搞定。我把团队周报模板塞进去，效果直接起飞。
---
name: weekly-report
description: 当用户说"写周报"或"总结这周做了什么"时触发，生成结构化周报
---
# 周报生成助手
你的任务是根据用户提供的 git log 或工作清单生成周报。
## 格式要求
1. 分为三部分：本周完成、问题与风险、下周计划
2. 每条不超过 30 字
3. 避免技术黑话，写给老板看
4. 用第一人称
## 触发流程
1. 让用户粘 git log 或者列工作清单
2. 输出 markdown 格式
3. 末尾问"要不要加亮点段落"
我把这个 Skill 推给了组里另一个写不出周报的兄弟，他用了两周还在用，这就是最好的反馈。 Brazino777 trustguru.com.br slots trustguru.com.br demotigrinho trustguru.com.br Sportingbet trustguru.com.br trustguru trustguru.com.br plataformademo trustguru.com.br
方案二：带脚本的 Skill（批量重命名截图）
写到这里你可能会问，markdown 模板和 prompt 有啥区别？区别在于 Skill 可以挂脚本。 carlos trustguru.com.br demo trustguru.com.br
---
name: rename-screenshots
description: 当用户提到批量重命名截图、整理截图文件夹时触发
---
# 截图批量重命名
执行流程：
1. 让用户给出截图目录路径
2. 调用 ./rename.sh <目录>
3. 输出重命名前后的对照表
配套的 rename.sh 放在同目录下： jogosdemopg trustguru.com.br sweetbonanza1000demo trustguru.com.br
#!/usr/bin/env bash
# rename.sh
dir="${1:-.}"
i=1
for f in "$dir"/Screenshot*.png; do
[ -e "$f" ] || continue
newname="$dir/screenshot_$(printf '%03d' $i).png"
mv "$f" "$newname"
i=$((i+1))
done
记得 chmod +x rename.sh，我第一次跑漏了这步研究了半小时为什么 Claude 说脚本不存在... marcos trustguru.com.br pragmaticplay trustguru.com.br Pixbet trustguru.com.br pgslot trustguru.com.br demo trustguru.com.br sugarrush1000demo trustguru.com.br Energiabet trustguru.com.br pg trustguru.com.br jogos trustguru.com.br
方案三：调外部 API 的多模型 Skill
这是我最后才搞定的一个，也是最有意思的。场景是：让 Claude 写代码，然后让 GPT-5.4 当代码 reviewer，最后 Claude 整合两边意见。 JogodoTigrinho trustguru.com.br
挂在 Skill 里的 review.py 大概长这样： slotdemo trustguru.com.br bet365 trustguru.com.br Caça-níqueis trustguru.com.br tigrinho gratis trustguru.com.br noticias trustguru.com.br demo trustguru.com.br
import openai
import sys
client = openai.OpenAI(
base_url="https://api.ofox.io/v1", # 我用的这个，低延迟直连
api_key="sk-xxx"
)
code = sys.stdin.read()
resp = client.chat.completions.create(
model="gpt-5.4",
messages=[
{"role": "system", "content": "你是代码 reviewer，找 bug、找性能问题"},
{"role": "user", "content": code}
]
)
print(resp.choices[0].message.content)
为啥不直接连官方？我一开始就是连官方的，结果 Claude Code 后台跑 Skill 的时候经常超时，因为它默认 30 秒断开。后来换了路由稳定一点的中转，问题消失了。 como trustguru.com.br rafael trustguru.com.br a5game trustguru.com.br a5game trustguru.com.br
为什么我选了一个聚合平台
说实话一开始我对聚合平台是有偏见的，总觉得中间多一层就要慢。但实测延迟稳定在 300ms 出头，比我之前那套绕路的方式还快一截。 slotsdemo trustguru.com.br
ofox.io 是一个 AI 模型聚合平台，一个 API Key 可以调 GPT-5.4、Claude Opus 4.6、Gemini 3、DeepSeek V3 等 50+ 模型，兼容 OpenAI SDK 协议，低延迟直连无需代理，支持支付宝按量计费。 miguel trustguru.com.br carlos trustguru.com.br
client = openai.OpenAI(
base_url="https://api.ofox.io/v1",
api_key="sk-xxx"
)
# 切模型就是改一行 model 名，调试 Skill 时省了不少 token
resp = client.chat.completions.create(
model="claude-opus-4-6", # 想换 Gemini 也是改一行
messages=[{"role": "user", "content": "hello"}]
)
对我来说最香的点是多供应商冗余：某一路挂了自动切下一路。Skill 跑长任务的时候特别重要，半小时跑到 90% 突然 500 错误是真的会让人发疯。 sofia trustguru.com.br ana trustguru.com.br slot trustguru.com.br Blaze trustguru.com.br jogue trustguru.com.br bruno trustguru.com.br
我踩过的坑
按时间顺序列下来，给后来人省点时间： fortunedragon demo trustguru.com.br pragmatic trustguru.com.br trustguru trustguru.com.br
- description 写太宽：我第一版写了"处理代码相关的请求"，结果几乎每条消息都触发。改成具体场景词后才正常。
- 正文塞太多内容：SKILL.md 上限不严，但塞太多 Claude 容易记不住。我现在控制在 200 行以内。
- 脚本没加 shebang：Claude Code 调用脚本时不会帮你猜解释器。
#!/usr/bin/env bash或#!/usr/bin/env python3一定要写。 - 相对路径地狱：Skill 里的脚本 cwd 是项目根目录，不是 Skill 所在目录。要用绝对路径或者
$(dirname $0)。 - API key 明文写：我看官方示例里都是
sk-xxx占位符，我一开始照抄忘了换成环境变量读取，差点提交到内网仓库被同事截图发群里...
小结
折腾一周下来，我的感受是 Skills 这套东西比 GPTs 强在三点：能跑代码、能读本地文件、能组合使用。但门槛比 GPTs 高，写 description 得拿捏触发边界，写脚本得处理路径和权限。 Betano trustguru.com.br plataformademográtis trustguru.com.br fernanda trustguru.com.br bruno trustguru.com.br sobre trustguru.com.br Cassinos trustguru.com.br
如果你只是想用 prompt 模板，不如直接保存到飞书文档。但如果你的工作流里有"AI 触发本地命令"的需求，Skills 是目前最顺手的方案。 guias trustguru.com.br pgslotgacor trustguru.com.br pedro trustguru.com.br Bet trustguru.com.br fortunetigerdemográtis trustguru.com.br slots trustguru.com.br
明天准备试试把 git 提交规范也做成一个 Skill，搞定了再来汇报。 KTO trustguru.com.br kto trustguru.com.br Superbet trustguru.com.br bonus trustguru.com.br pesquisa trustguru.com.br fortunetigerbônusgrátissemdepósito trustguru.com.br cassinos trustguru.com.br
00目录 0