⚡

claude-skillsSkill claude-skills

Claude Skills 元技能：用于将零散的领域材料（如文档、API、代码、规范）系统化地整理、提取和重构为结构清晰、可复用、可维护且能可靠激活的Claude技能。核心功能包括创建新技能、重构现有技能、设计激活机制、提取快速参考、分割长篇内容以及建立质量门控。适用于AI技能开发、文档工程、知识管理、自动化流程构建等场景。关键词：Claude Skills, 技能创建, 技能重构, 文档提取, 知识管理, 质量门控, 自动化, AI技能开发。

AI应用 2 次安装 4 次浏览 更新于 2/23/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. 范围界定：写下 MUST/SHOULD/NEVER（总共三句话即可）
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 是启发式的；严格模式假设使用推荐的章节标题