SuperAPI AI 工具集

plugin-creator

编程与开发

查看项目

更新于 10-16 05:07

技能介绍

用途:当用户要求创建插件、搭建插件结构、新建插件、编辑插件清单时使用。它封装内置的 plugin-dev:create-plugin,并叠加 superpowers 框架的 enforcement 审计层;内置版本缺少此审计。

主要能力与流程:

  1. 对插件分类:完整插件、新增技能、新增钩子、组件编辑,判定各自强制约束需求。
  2. 判断可机械检查的约束:可用 ${CLAUDE_SKILL_DIR}、!command 注入、作用域钩子 Pre/PostToolUse、SessionStart hook(once:true)。原则是:可机械检查的用钩子强制,需要判断的保留为提示文本。
  3. 运行 checker-shape 探针:bun ${CLAUDE_SKILL_DIR}/scripts/pc-probe.ts --target <plugin-dir>。退出码 0 干净、1 有发现、2 参数错误、3 探针崩溃;2 和 3 不同,也都不算通过。在 Step 3 之后与最终校验前重跑。
  4. 调用内置创建器:Skill(skill="plugin-dev:create-plugin"),遵循其完整流程,不重新实现。
  5. 执行强制约束审计,按 enforcement-checklist 的 12 个模式评分,重点检查 Iron Laws、Fact Rows、Red Flags + STOP、Trigger-Only Descriptions、Gate Functions。可用 bun ${CLAUDE_PLUGIN_ROOT}/skills/work/scripts/rule-check.ts --project-dir <repo> --rules ${CLAUDE_PLUGIN_ROOT}/constraints/jev/authoring 运行作者判断规则(exit 2 命名每条 p>=0.85 的规则;exit 1 表示 Jev 不可用,绝不视为通过)。同时校验钩子的匹配器覆盖、路径有效性、错误处理与作用域,以及 plugin.json、marketplace.json 版本一致、目录布局与路径可移植性。

其他要点:hooks/guards/skill-paths.ts 在每次 Edit/Write 后运行,报告指向缺失文件的 ${CLAUDE_SKILL_DIR}/${CLAUDE_PLUGIN_ROOT} 引用;hooks/plugin-validate.ts 未注册,需手动运行 claude plugin validate <plugin-dir>。

限制:本技能依赖 plugin-utils 的 skill-toc 与 Jev 约束,缺失时相关引用与脚本索引不可用;探针退出码 2、3 均非通过;未注册的校验钩子不会自动运行。