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.md

Frontmatter 示例：

---
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 验证格式
实际使用测试功能
根据反馈迭代改进

skill-creator