⚡

claude-skillsSkill claude-skills

Claude Skills 元技能：将领域材料（文档/API/代码/规范）提取为可重用的技能（SKILL.md + 参考资料/脚本/资产），并重构现有技能以提高清晰度、激活可靠性和质量门控。

AI智能体 0 次安装 0 次浏览 更新于 2/28/2026

name: claude-skills description: “Claude Skills 元技能：将领域材料（文档/API/代码/规范）提取为可重用的技能（SKILL.md + 参考资料/脚本/资产），并重构现有技能以提高清晰度、激活可靠性和质量门控。”

Claude Skills 元技能

将零散的领域材料转化为可重用、可维护且可靠激活的技能：

  • SKILL.md 作为入口点（触发器、约束、模式、示例）
  • references/ 用于长篇证据和导航
  • 可选的 scripts/ 和 assets/ 用于脚手架和模板

何时使用此技能

当您需要时触发此元技能：

  • 从文档/规范/仓库从头创建新技能
  • 重构现有技能（太长、不清晰、不一致、误触发）
  • 设计可靠的激活机制（前置元数据 + 触发器 + 边界）
  • 从大型材料中提取干净的快速参考
  • 将长篇内容拆分为可导航的 references/
  • 添加质量门控和验证器

不适用于 / 边界

此元技能不是：

  • 一个领域技能本身（它构建领域技能）
  • 发明外部事实的许可证（如果材料未证明，请说明并添加验证路径）
  • 所需输入的替代品（如果输入缺失，请先提出1-3个问题再继续）

快速参考

交付物（必须生成的内容）

您的输出必须包括：

  1. 具体的目录布局（通常是 skills/<技能名称>/）
  2. 可操作的 SKILL.md，包含可判定的触发器、边界和可复现的示例
  3. 长篇文档移至 references/，并附带 references/index.md
  4. 交付前检查清单（质量门控）

推荐布局（最小化 -> 完整）

技能名称/
|-- SKILL.md              # 必需：带YAML前置元数据的入口点
|-- references/           # 可选：长篇文档/证据/索引
|   `-- index.md          # 推荐：导航索引
|-- scripts/              # 可选：助手/自动化
`-- assets/               # 可选：模板/配置/静态资产

真正的最小化版本只有 SKILL.md（您可以稍后添加 references/）。

YAML 前置元数据（必需）

---
name: 技能名称
description: "它做什么 + 何时使用（激活触发器）。"
---

前置元数据规则：

  • name 必须匹配 ^[a-z][a-z0-9-]*$ 并且应该匹配目录名称
  • description 必须是可判定的（不是“帮助处理X”），并包含具体的触发关键词

最小化 SKILL.md 骨架（复制/粘贴）

---
name: 我的技能
description: "[领域] 能力：包括 [能力1]、[能力2]。在 [可判定触发器] 时使用。"
---

# 我的技能

一句话说明边界和交付物。

## 何时使用此技能

当以下任一情况适用时触发：
- [触发器1：具体任务/关键词]
- [触发器2]
- [触发器3]

## 不适用于 / 边界

- 此技能不会做什么（防止误触发和过度承诺）
- 所需输入；如果缺失，请提出1-3个问题

## 快速参考

### 常见模式

**模式1：** 一行解释
```text
[可以粘贴并运行的命令/代码片段]

示例

示例1

  • 输入：
  • 步骤：
  • 预期输出 / 验收标准：

示例2

示例3

参考资料

  • references/index.md：导航
  • references/...：按主题拆分的长篇文档

维护

  • 来源：文档/仓库/规范（不发明）
  • 最后更新：YYYY-MM-DD
  • 已知限制：明确超出范围的内容

### 编写规则（不可协商）

1. 快速参考用于简短、可直接使用的模式
   - 尽可能保持不超过20个模式。
   - 任何需要段落解释的内容都应放入 `references/`。
2. 激活必须是可判定的
   - 前置元数据 `description` 应说明“什么 + 何时”并包含具体关键词。
   - “何时使用此技能”必须列出具体任务/输入/目标，而不是模糊的帮助文本。
   - “不适用于 / 边界”对于可靠性是必需的。
3. 不虚张声势外部细节
   - 如果材料未证明，请说明并包含验证路径。

### 工作流程（材料 -> 技能）

不要跳过步骤：
1. 范围：编写必须/应该/绝不（总共三句话即可）
2. 提取模式：选择10-20个高频模式（命令/代码片段/流程）
3. 添加示例：≥3个端到端示例（输入 -> 步骤 -> 验收）
4. 定义边界：超出范围的内容 + 所需输入
5. 拆分参考资料：将长文本移至 `references/` + 编写 `references/index.md`
6. 应用门控：运行检查清单和验证器

### 质量门控（交付前检查清单）

最低检查（完整版本见 `references/quality-checklist.md`）：
1. `name` 匹配 `^[a-z][a-z0-9-]*$` 并匹配目录名称
2. `description` 说明“什么 + 何时”并包含具体触发关键词
3. 有“何时使用此技能”并包含可判定触发器
4. 有“不适用于 / 边界”以减少误触发
5. 快速参考不超过20个模式，每个模式可直接使用
6. 有≥3个可复现示例
7. 长篇内容在 `references/` 中，且 `references/index.md` 可导航
8. 不确定的声明包含验证路径（不虚张声势）
9. 读起来像操作手册，而不是文档转储

本地验证：

```bash
# 从仓库根目录（基本验证）
./skills/claude-skills/scripts/validate-skill.sh skills/<技能名称>

# 从仓库根目录（严格验证）
./skills/claude-skills/scripts/validate-skill.sh skills/<技能名称> --strict

# 从 skills/claude-skills/（基本验证）
./scripts/validate-skill.sh ../<技能名称>

# 从 skills/claude-skills/（严格验证）
./scripts/validate-skill.sh ../<技能名称> --strict

工具与模板

生成新技能骨架：

# 从仓库根目录（生成到 ./skills/）
./skills/claude-skills/scripts/create-skill.sh 我的技能 --full --output skills

# 从 skills/claude-skills/（生成到 ../ 即 ./skills/）
./scripts/create-skill.sh 我的技能 --full --output ..

# 最小化骨架
./skills/claude-skills/scripts/create-skill.sh 我的技能 --minimal --output skills

模板：

  • assets/template-minimal.md
  • assets/template-complete.md

示例

示例1：从文档创建技能

  • 输入：官方文档/规范 + 2-3个真实代码示例 + 常见失败模式
  • 步骤：
    1. 运行 create-skill.sh 搭建 skills/<技能名称>/ 脚手架
    2. 将前置元数据 description 写为“什么 + 何时”
    3. 提取10-20个高频模式到快速参考
    4. 添加≥3个端到端示例，包含验收标准
    5. 将长篇内容放入 references/ 并连接 references/index.md
    6. 运行 validate-skill.sh --strict 并迭代

示例2：重构“文档转储”技能

  • 输入：现有的 SKILL.md，包含粘贴的长篇文档
  • 步骤：
    1. 识别哪些部分是模式，哪些是长篇解释
    2. 将长篇文本移至 references/（按主题拆分）
    3. 将快速参考重写为简短的可复制/粘贴模式
    4. 添加或修复示例，直到它们可复现
    5. 添加“不适用于 / 边界”以减少误触发

示例3：验证和门控技能

  • 输入：skills/<技能名称>/
  • 步骤：
    1. 运行 validate-skill.sh（非严格）获取警告
    2. 修复前置元数据/名称不匹配和缺失部分
    3. 运行 validate-skill.sh --strict 强制执行规范
    4. 在发布前运行 references/quality-checklist.md 中的评分标准

参考资料

本地文档：

  • references/index.md
  • references/skill-spec.md
  • references/quality-checklist.md
  • references/anti-patterns.md
  • references/README.md（上游官方参考）

外部（官方）：

维护

  • 来源：skills/claude-skills/references/ 中的本地规范文件 + references/README.md 中的上游官方文档
  • 最后更新：2025-12-14
  • 已知限制：validate-skill.sh 是启发式的；严格模式假设使用推荐的章节标题