Claude Skills 是目前最强大的方式，让 Claude “记住”你的特定工作流、风格、专业知识，一次教、长期用。
构建得好，能把 Claude 从“通用助手”变成“专属员工”。
---
1、Skill 到底是什么？（一句话定义）
Skill = 一个文件夹，里面主要放一个叫 **SKILL.md** 的文件，用来教 Claude：
**“遇到这类需求就按这个固定方式做”。**
---
2、最核心的设计原则（记这三条就够了）
* 渐进式披露（最重要），Claude 分三级加载内容，防止 token 爆炸：
-YAML 前置（永远加载）
→ 只写“什么时候用”
-SKILL.md 正文（相关时加载）
→ 写完整步骤
-references/ 里的文件（需要时再读）
→ 放 API 文档、长模板
---
* 可组合 ：多个 Skill 可以同时开着，互不干扰。
---
* 可移植：同一个文件夹在Claude.ai、Claude Code、API里都能用。
---
3、文件夹结构（就这四样，别的先别管）
project-planner/ ← 文件夹名必须 kebab-case（短横-分隔）
├── SKILL.md ← 必须！名字固定，大小写敏感
├── scripts/ ← 可选，放 python / bash 小工具
├── references/ ← 可选，放长文档、例子
└── assets/ ← 可选，放模板文件
铁律：
* 文件夹名和 name 字段必须完全一样（kebab-case，无空格、无大写、无下划线）
* 一定叫 “SKILL.md”，别写：skill.md 、Readme.md
---
4、YAML 前置元数据（复制模板就行）
```yaml
---
name: linear-sprint-planner ← 必须，和文件夹名一样
description: > ←必须！这行决定触发率
帮我规划 Linear 冲刺、创建任务、估点。当我说“规划冲刺”“下个 sprint”“创建任务列表”或提到 sprint 相关时使用。
---
```
写 description 的生死三招：
* 一定要写 “做什么 + 什么时候用”
* 列出用户最可能说的具体短语（3–8 个）
* 别写太泛（“帮我管理项目” → 必死）
也别写太技术（“调用 Linear API” → 没人这么问）
---
5、SKILL.md 主体怎么写（推荐极简结构）
「markdown」
Linear 冲刺规划器
核心指令：
1. 先确认项目和时间范围（问用户如果不清楚）
2. 通过 MCP / Linear 工具拉取当前 backlog 和 velocity
3. 按优先级 + 容量建议任务拆分和排序
4. 生成任务列表，每项包含：标题、描述、估点、标签
5. 询问用户确认 → 批量创建到 Linear
永远不要：
* 跳过确认步骤
* 自己编造 velocity
* 一次创建超过 20 个任务
快速示例：
用户：规划下两周 sprint
→ 你：好的，先告诉我项目 key 是？（PLM-123？）
→ 拉数据 → 给出建议 → 确认后创建
常见问题处理：
Q：Linear 连不上？
A：检查 MCP 服务器状态，重新连接后再试。
---
写指令铁律：
* 用编号步骤，越具体越好
* 写清楚边界（不要做什么）
* 必须有： 错误处理 和 用户确认环节
---
6、 三大刚需技能类型（先从前两种入手）
① 纯文档 / 输出类（最简单上手）
→ 生成报告、代码、PPT、设计稿，靠 Claude 内置能力，无需 MCP
---
② 工作流自动化类（性价比最高）
→ 多步流程 + 校验 + 迭代（如项目规划、代码审查）
---
③ MCP 增强类（高级）
→ 配合外部工具（Notion、Linear、Sentry 等）
新手建议：先做第 1 类或第 2 类，成功率最高。
---
7、怎么测好坏？（只测这三件事）
* 触发准不准（90% 以上命中）
→ 问 Claude：“你什么时候会用这个 skill？” 看回答是否准确
---
* 输出稳不稳（0 次崩溃，少改动）
→ 跑 5–10 次相同需求，看结果是否一致
---
* 比不用 skill 快多少（token / 轮次明显减少）
---
8、最高频的失败原因 & 解法（避坑清单）
* 不触发 → description 没写对 → 加更多用户真实会说的短语
* 乱触发 → description 太泛 → 加否定句（如“不要用于简单查询”）
* 指令不听 → 写得太模糊/没强调 → 用“必须”“永远不要”“先做 X 再做 Y”
* 上传失败 → 文件名不对 → ls 检查是否真的是 SKILL.md
* 太慢/贵 → SKILL.md 写太长 → 把细节挪到 references/
---
掌握以上，你就能在30 分钟内做出第一个真正好用的 Skill。
#