skill-development

技能开发

用于创建、审计和维护 Claude Code 技能的工具。对于任何构建技能或分叉此仓库的人来说都不可或缺。

---

斜杠命令

/create-skill <name>

根据模板搭建新技能的脚手架。

功能：

1. 验证技能名称（小写连字符格式，最多 40 个字符）
2. 询问技能类型（Cloudflare/AI/Frontend/Auth/Database/Tooling/Generic）
3. 将 templates/skill-skeleton/ 复制到 skills/<name>/
4. 在 SKILL.md 中自动填充名称和日期
5. 创建包含自动触发关键词的 README.md
6. 运行元数据检查
7. 安装技能以供测试

用法：/create-skill my-new-skill

---

/review-skill <name>

对现有技能进行质量审查和审计。

功能：

1. 检查 SKILL.md 的结构和元数据
2. 根据最新版本验证软件包版本
3. 审查错误文档
4. 检查模板是否完整
5. 提出改进建议

用法：/review-skill cloudflare-worker-base

---

/audit [name]

用于并行验证技能的多 Agent 审计集群。

功能：

1. 启动并行 Agent，审计多个技能
2. 检查版本、元数据和内容质量
3. 生成汇总报告

用法：

• /audit - 审计所有技能
• /audit cloudflare-* - 审计匹配的技能

---

/audit-skill-deep <name>

根据官方文档进行深入内容验证。

功能：

1. 获取该技能所用技术的官方文档
2. 比较模式和版本
3. 找出知识缺口或过时内容
4. 提出更正和更新建议

用法：/audit-skill-deep tailwind-v4-shadcn

---

/deep-audit <name>

通过全面抓取文档进行扩展深度审计。

功能：

1. 抓取多个文档来源
2. 将抓取的内容缓存到 archive/audit-cache/
3. 与技能内容进行交叉比对
4. 生成详细的准确性报告

用法：/deep-audit openai-api

---

/scrape-api <docs-url> [skill-name]

根据 API 文档 URL 生成技能。

功能：

1. 验证文档 URL 是否可访问且包含 API 文档
2. 对静态文档优先尝试使用 WebFetch
3. 对 JavaScript 内容较多的网站（readme.io、GitBook）回退到 Playwright
4. 提取端点、身份验证和请求/响应架构
5. 生成完整的技能结构，包括 SKILL.md、references/、templates/
6. 运行插件清单生成

用法：

• /scrape-api https://api.example.com/docs my-api
• /scrape-api https://rocketdotnet.readme.io/（自动检测名称：rocket-net-api）

支持的平台：

• readme.io 文档站点
• Swagger/OpenAPI 规范
• GitBook 文档
• 标准 HTML API 文档

---

模板

此技能包含用于创建新技能的模板：

模板	用途
templates/skill-skeleton/	可复制的完整技能目录
templates/SKILL-TEMPLATE.md	包含待填写 TODO 的 SKILL.md
templates/README-TEMPLATE.md	包含关键词部分的 README.md
templates/skill-metadata-v2.yaml	YAML frontmatter 参考
templates/RESEARCH_FINDINGS_TEMPLATE.md	研究结果格式
templates/CONTENT_AUDIT_TEMPLATE.md	审计清单

使用模板

# Option 1: Use /create-skill (recommended)
/create-skill my-new-skill

# Option 2: Manual copy
cp -r skills/skill-development/templates/skill-skeleton/ skills/my-new-skill/
# Then fill in the TODOs

---

质量标准

技能发布前应满足以下标准：

必需项

• 包含 name 和 description 的 YAML frontmatter
• 描述中包含“适用场景”
• 使用第三人称描述风格
• 软件包版本为最新版本
• 模板经过测试且可以正常使用

建议项

• README.md 包含自动触发关键词
• 已测量 Token 效率（目标：节省 50% 以上）
• 记录已知问题并附上来源
• 示例包含错误预防措施

完整清单：参见仓库根目录中的 ONE_PAGE_CHECKLIST.md。

---

Agent

此技能提供用于自动维护技能的 Agent：

Agent	用途
skill-creator	按照规范结构搭建新技能
api-doc-scraper	根据 API 文档 URL 生成技能
version-checker	验证软件包版本是否为最新
content-accuracy-auditor	对比技能内容与官方文档
code-example-validator	验证代码示例的语法是否正确
api-method-checker	验证文档中记录的 API 方法是否存在
doc-validator	检查文档质量
bulk-updater	批量应用更改到多个技能

这些 Agent 位于 .claude/agents/（仓库级）和 agents/（技能内置）中，并由命令调用。

---

工作流

创建新技能

1. /create-skill my-skill
2. Fill in TODOs in SKILL.md
3. Add templates, references, scripts as needed
4. /review-skill my-skill
5. Fix any issues
6. Test: /plugin install ./skills/my-skill
7. Commit and push

审核技能

1. /audit                          # Quick check all skills
2. /audit-skill-deep my-skill      # Deep check specific skill
3. Review findings
4. Fix issues or document as known limitations
5. Update metadata.last_verified date

季度维护

1. Run: ./scripts/check-all-versions.sh
2. Review VERSIONS_REPORT.md
3. /audit for all skills needing updates
4. Update package versions
5. Test affected skills
6. Commit: "chore: quarterly version updates"

---

对于 Fork 仓库的用户

如果你 Fork 了此仓库来维护自己的技能：

1. 安装此技能：/plugin install ./skills/skill-development
2. 使用 /create-skill：按照规范结构创建技能
3. 使用 /review-skill：在发布前进行验证
4. 自定义 Agent：根据需要修改 .claude/agents/
5. 拉取上游更新：git fetch upstream && git merge upstream/main

此工具设计为可独立运行——使用这些命令无需完整仓库。