SuperAPI AI 工具集

skill-reviewer

编程与开发

查看项目

更新于 11-01 17:21

技能介绍

用途

Skill Reviewer 用于对已存在的 Claude Code 技能进行审查、验证、泛化和发布,使其符合公开分发的最佳实践。若要从零创建全新技能,应使用配套的 skill-builder 技能。

主要能力

  • 结构校验:定义技能目录应包含 SKILL.md(核心指令)、README.md(人类可读文档与安装说明)、CHANGELOG.md(Keep a Changelog 格式的版本历史),以及可选的 references/、scripts/、hooks/、examples/。
  • 行为分类:每个技能必须声明行为类型:Autonomous Execution(EXECUTE, DON'T ASK)、Guided Decision(ASK, THEN EXECUTE)、Interactive Exploration(ASK THROUGHOUT)、Configurable Enforcement(USER-CONFIGURED),并给出决策树与适用示例。
  • 泛化检查:公开发布的技能不得包含硬编码项目名、UUID/ID、个人 API 端点、公司特定逻辑、内部团队引用;应改为环境变量、可配置 URL、通用模式与通用示例。文档、案例、模板均须使用占位符(如 [ISSUE-ID]、<your-uuid>)。
  • 敏感信息管理:涉及密钥的技能应使用 Varlock,提供 .env.schema、.env.example,并避免 echo $API_KEY、cat .env 等会暴露密钥的命令。
  • 更新工作流:审计项目特定内容 → 提取为环境变量 → 重命名项目特定函数 → 更新文档 → 运行校验脚本 → 按 semver 升级版本并更新 CHANGELOG。
  • 发布流程:确认 README 与 CHANGELOG 齐全,提交并推送,创建 GitHub Release 与标签;技能包可使用 <skill-name>/v<version> 标签约定避免冲突。
  • 版本漂移审计:发布技能包前核对各技能版本与来源是否一致。
  • 批量查找替换:重命名术语时先大小写不敏感 grep,注意多种大小写变体;含尖括号的替换应使用 sed。

使用方式

资料提供了校验脚本命令 npx tsx scripts/validate-skill.ts path/to/skill,以及一系列 grep、sed、git、gh release 检查与发布命令。安装方式提及 Claude Code 插件市场流程与 skillsmith install 备选流程。具体操作步骤见正文清单。

适用场景

  • 准备公开发布技能前的质量与合规检查
  • 将内部项目专用技能泛化为通用技能
  • 技能版本升级、CHANGELOG 与 GitHub Release 发布
  • 技能包版本一致性与标签管理

限制

资料未说明该技能的运行环境、依赖版本、支持的平台范围、收费或许可信息,暂未提供。