Skill Creator
帮助创建符合 Testany 规范的 Claude Code Skills。
Testany Skill 规范（强制）
命名与结构约定
| 约定项 | 规范 |
|---|---|
| 命名语言 | 英文，kebab-case（如 prd-writer） |
| 目录结构 | 扁平结构 skills/xxx/ |
| 必须文件 | 只需 SKILL.md |
| references 命名 | 英文 |
审核标准
| 审核项 | 要求 |
|---|---|
| Frontmatter | 必须包含触发词 |
| 行数限制 | SKILL.md < 500 行 |
| 边界检查 | 必须通过 quick_validate.py + 人工审核 |
| 语言 | 必须中文（技术术语可保留英文） |
| 示例 | 必须有使用示例 |
目录结构
skill-name/
├── SKILL.md (必需)
└── references/ (可选，按需加载的参考文档)不要创建 README.md、CHANGELOG.md 等额外文件。
核心原则
简洁优先
Context window 是公共资源。只添加 Claude 不知道的信息。
默认假设：Claude 已经很聪明。 用简洁示例代替冗长解释。
渐进式加载
- Metadata（name + description）- 始终在 context 中
- SKILL.md body - 触发后加载
- references/ - 按需加载
Skill 创建流程
步骤 1：理解需求
通过具体示例理解 skill 的使用场景：
- 这个 skill 要支持什么功能？
- 用户会怎么使用它？
- 什么话会触发这个 skill？
步骤 2：规划内容
分析每个示例，确定需要的资源：
| 资源类型 | 用途 | 示例 |
|---|---|---|
| references/ | 参考文档，按需加载 | 模板、规范、API 文档 |
| scripts/ | 可执行脚本 | 验证、初始化工具 |
| assets/ | 输出资源 | 图片、模板文件 |
步骤 3：初始化 Skill
scripts/init_skill.py <skill-name>脚本默认输出到 skills/ 目录，会创建：
- SKILL.md 模板
- 示例目录结构（scripts/、references/、assets/）
步骤 4：编写 SKILL.md
Frontmatter（必需）
---
name: skill-name
description: 触发词1、触发词2。功能描述，说明什么时候使用这个 skill。
---重要：description 必须包含触发词，这是 skill 被激活的关键。
Body
- 使用中文撰写
- 简洁明了，< 500 行
- 包含使用示例
- 引用 references 时说明何时读取
步骤 5：验证
scripts/quick_validate.py skills/<skill-name>检查项：
- Frontmatter 格式
- 行数限制
- 触发词存在
步骤 6：人工审核
验证通过后，提交人工审核：
- 功能完整性
- 文档清晰度
- 示例有效性
参考示例：prd-writer
prd-writer 是一个符合 Testany 规范的 skill 示例：
prd-writer/
├── SKILL.md (233 行)
└── references/
├── new-feature-ui.md
├── new-feature-backend.md
├── integration.md
├── refactoring.md
└── optimization.mdFrontmatter 示例：
---
name: prd-writer
description: 写 PRD、写产品需求文档、PRD 模板、新功能需求。帮助撰写高质量的产品需求文档，支持多种类型：新功能（有UI/无UI）、第三方集成、功能重构、性能/安全优化。
---注意 description 开头的触发词：写 PRD、写产品需求文档、PRD 模板、新功能需求
常见问题
Q: references 和 assets 的区别？
- references/：供 Claude 参考的文档，会加载到 context
- assets/：输出资源（图片、模板），不加载到 context
Q: SKILL.md 太长怎么办？
拆分到 references/，在 SKILL.md 中引用并说明何时读取。
Q: 如何测试 skill？
- 运行
quick_validate.py验证格式 - 实际使用测试功能
- 根据反馈迭代改进