# Meta Skill Creator

> 创建高效技能的指南.当用户想要创建新技能(或更新现有技能)以通过专业知识、工作流或工具集成来扩展代理能力时,应使用此技能.

- Skill: `majiayu000/meta-skill-creator-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/meta-skill-creator-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/meta-skill-creator-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: 完整条款见 LICENSE.txt
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/meta-skill-creator-2

---


# 技能创建者 (Skill Creator - Chinese Version)

此技能为创建高效技能提供指导.

## 关于技能 (About Skills)

技能是模块化、自包含的包,通过提供专业知识、工作流和工具来扩展代理的能力.可以将其视为针对特定领域或任务的 "入职指南" ——它们将通用代理转变为具备流程性知识的专业代理.

### 技能提供的功能

1. 专业工作流 - 针对特定领域的多个步骤流程.
2. 工具集成 - 指导如何使用特定文件格式或 API.
3. 领域专业知识 - 公司特定的知识、模式、业务逻辑.
4. 捆绑资源 - 用于复杂和重复任务的脚本、参考资料和资源.

## 核心原则 (Core Principles)

### 简洁是关键 (Concise is Key)

上下文窗口 (Context Window) 是公共资源.技能需要与系统提示词、对话历史、其他技能元数据以及实际用户请求共享上下文.

**默认假设:代理已经非常聪明.** 只添加代理尚未掌握的上下文.挑战每条信息: "代理真的需要这个解释吗?" 以及 "这段文字对得起它的 Token 成本吗?"

优先使用简洁的示例,而不是冗长的解释.

### 设置适当的自由度 (Set Appropriate Degrees of Freedom)

根据任务的脆弱性和变异性匹配特异性级别:

**高自由度 (文本指令)**: 当多个方法都有效、决策依赖于上下文或启发式方法指导过程时使用.

**中等自由度 (伪代码或带参数的脚本)**: 当存在首选模式、允许某种程度的变化或配置会影响行为时使用.

**低自由度 (特定脚本,极少参数)**: 当操作脆弱且易出错、一致性至关重要或必须遵循特定顺序时使用.

## 技能的结构 (Anatomy of a Skill)

每个技能都包含一个必需的 `SKILL.md` 文件和可选的捆绑资源:

```
skill-name/
├── SKILL.md (必填)
│   ├── YAML 元数据 (必填)
│   │   ├── name: (必填)
│   │   ├── description: (必填)
│   │   └── compatibility: (可选)
│   └── Markdown 指令 (必填)
└── 捆绑资源 (可选)
    ├── scripts/          - 可执行代码 (Python/Bash 等)
    ├── references/       - 旨在根据需要加载到上下文中的文档
    └── assets/           - 输出中使用的文件 (模板、图标、字体等)
```

### 渐进式披露设计原则 (Progressive Disclosure)

技能使用三层加载系统来高效管理上下文:

1. **元数据 (名称 + 描述)** - 始终在上下文中 (~100 词).
2. **SKILL.md 正文** - 技能触发时加载 (<5k 词).
3. **捆绑资源** - 根据需要加载 (脚本无需读入上下文窗口即可执行,因此几乎无限制).

**关键原则:** 当技能支持多种变体、框架或选项时,仅在 `SKILL.md` 中保留核心工作流和选择指南.将变体特定的细节(模式、示例、配置)移动到单独的参考文件中.

## 技能创建流程 (Skill Creation Process)

1. **了解技能背景**: 通过具体示例了解技能用途.
2. **规划资源**: 规划脚本、参考资料和资产.
3. **初始化技能**: 运行 `scripts/init_skill.py <skill-name>`.
4. **编辑技能**: 编写 `SKILL.md` 并实现资源.
5. **打包技能**: 运行 `scripts/package_skill.py <path/to/skill-folder>`.
6. **迭代优化**: 根据实际使用情况进行改进.

### 步骤 4: 编辑技能 (Edit the Skill)

编写 `SKILL.md` 时,请记住这是为另一个代理实例使用的.包含有益且非显而易见的信息.

#### 编写指南

- 使用祈使句/不定式形式.
- **YAML Frontmatter**: `description` 是主要触发机制,应涵盖技能的作用及触发上下文.
- **正文**: 编写关于如何使用该技能及其捆绑资源的指令.

### 步骤 5: 打包技能 (Packaging a Skill)

开发完成后,必须将其打包为可分发的 `.skill` 文件.打包过程会自动验证技能是否符合要求:

```bash
python3 scripts/package_skill.py <path/to/skill-folder>
```

验证内容包括:

- YAML 格式及必填字段.
- 命名规范与目录结构.
- 描述的完整性与质量.
- 资源引用的正确性.

---

_注: 此技能本身即为使用提示词工程和结构化文档的最佳实践示例._

