SuperAPI AI 工具集

skill-spec-review

智能体与模型

查看项目

更新于 10-15 19:57

技能介绍

用途:在技能包合并或发布到 skills.sh 之前进行规范审查,也可用于回答“审查这个技能”“SKILL.md 是否有效”等问题,或在 PR 涉及 skills/*/SKILL.md、准备让仓库支持 npx skills add 时使用。

主要能力:按检查清单逐项核对。结构方面要求目录名为 kebab-case 且与 frontmatter 中 name 一致、文件名严格为 SKILL.md(区分大小写)、技能文件夹内不放 README.md(改用 references/)。Frontmatter 必填项包括 name(1–64 字符,仅 [a-z0-9-],首尾无连字符、无连续 --)和 description(1–1024 字符,需说明能力与激活时机);推荐项包括 license、metadata.version、metadata.author,以及技能依赖 git、网络、docker 或特定产品时的 compatibility。正文要求有清晰的编号工作流、约 500 行以内(超出则拆分到 references/)、相对文件链接仅一层深、references/sources.md 提供外部论断的 URL、记录安装命令 npx skills add arenukvern/skill_steward --skill <name>。脚本需有 shebang(bash 或 node)、bash 使用 set -euo pipefail、日志走 stderr、机器可读输出走 stdout。仓库层面要求 skills.sh.json 中有技能 id、根 README.md 表格中有对应行、pnpm run validate 通过;Tier 1 技能需 evals/cases/*.yaml 与 pnpm run eval,其他行为关键技能需 references/evals.md 或 plugin-eval 说明。

使用方式:按上述清单审查后,以固定格式输出报告,包含 Summary(pass 或 needs changes)、Errors(阻塞项)、Warnings、Suggestions 四部分。安装命令为 npx skills add arenukvern/skill_steward --skill skill-spec-review。

适用场景:技能发布前审核、PR 中技能文件变更检查、仓库适配 npx skills add 前的准备。

限制:资料未提供具体收费、价格、平台支持范围或效果保证;实际执行依赖仓库内 docs/STANDARDS.mdx 与 agentskills.io 开放规范,部分检查项需结合具体仓库配置。