用途:以一个 Staff Engineer 的视角审查技能(SKILL.md 及其配套资源)的质量与有效性。核心前提是技能内容会占用 AI 智能体的工作记忆,每一行都消耗 token 并与实际任务竞争。
主要能力:按十二项标准逐项给出 PASS、WARN、FAIL 或 N/A 评级,并生成每技能评审表、结论(APPROVED 或 NEEDS WORK)、行动项列表和末尾汇总表。标准包括:体积预算(SKILL.md 行数与估算 token、总内容行数)、渐进披露(超限须拆分并给出何时阅读的指引,引用只允许一层)、frontmatter 质量(name 与目录名一致且为 kebab-case,description 说明何时触发与做什么,tags 必须为内联列表)、接口优于内部实现、示例效率、无重复、自由度、无多余文件(禁止 README、CHANGELOG 等,LICENSE/NOTICE 例外)、可操作性、编码判断、可检验标准、观点与署名。
使用方式:先运行机械检查并引用输出,包括 wc -l 与 wc -c 统计 SKILL.md、find 列出文件、python3 <plugin>/skills/future-skill-creator/scripts/quick_validate.py <skill> 校验 frontmatter,以及 ls <plugin>/skills//scripts/test_.py 检查测试文件基名冲突。quick_validate.py 依赖 PyYAML,可用 uv run --with pyyaml python3 … 运行;未安装 future-skill-creator 时手查四项 frontmatter 并在评审中说明。随后按清单逐项评分并输出格式。评审要求每项非 PASS 评级引用 file:line 并说明改什么,每项 PASS 说明检查了什么,防止无证据的盖章式通过表。
限制:对 vendored 技能只做建议性评审,标准 10-12 属于本插件约定,上游不共享,应评为 N/A,且修复会在下次同步时被覆盖,如需修复应 fork。评级判定:有任一 FAIL,或有 WARN 会改变智能体实际行为时判 NEEDS WORK,否则 APPROVED 并列出剩余 WARN。资料未提供实际技能目录、版本、许可与支持平台等具体信息。