SuperAPI AI 工具集

new-skill

编程与开发

查看项目

更新于 10-15 22:15

技能介绍

用途:为 brooks-lint 仓库搭建一个新的分析技能(skill),使其结构符合仓库规范,并能首次通过 npm run validate 与 npm run evals。技能名取自 $ARGUMENTS,使用 kebab-case(如 brooks-security);若为空,需先询问名称和一句话用途。

主要能力与产出:

  1. 创建 skills/{name}/SKILL.md,含 frontmatter:name;description 必须以 Do NOT trigger for: 子句结尾(已发布技能会被 validate 强制校验,遗漏会导致误触发);Process 段落 3–6 条,内联引用指南步骤范围(例如 Scan risks (Steps 1–6 of the guide))。结构参照 skills/brooks-review/SKILL.md(Setup → Process → Mode line)。
  2. 创建 skills/{name}/{name}-guide.md,步骤连续编号,无跳号无重复,允许 Step 2a 这类子步骤;详细步骤归 guide,SKILL.md 的 Process 只是方向骨架。
  3. 接线框架:新 SKILL.md 的 Setup 段必须 Read 相关 _shared/ 文件(common.md 提供 Iron Law 与 Report Template,按需加 decay-risks.md / test-decay-risks.md);_shared/ 不会自动加载。
  4. 补充 eval:在 evals/evals.json 追加下一个连续 id,至少一个正常路径场景(expected_output 含相关风险码)和至少一个误报场景(no_risk_codes: true);每个场景需 id、name、prompt、expected_output、mode、files。
  5. 校验:npm run validate(结构、步骤连续性、Process 段存在)与 npm run evals(eval schema),修正至全部通过。
  6. 本地测试:cp -r skills/* ~/.claude/skills/brooks-lint/(若已将 ~/.claude/skills/brooks-lint 软链到仓库可跳过,编辑即时生效),在 Claude 会话中触发新技能,验证 Iron Law 输出,再恢复市场副本:/plugin marketplace update → /plugin install brooks-lint@brooks-lint-marketplace。

限制与注意:不要手动注册 slash command,短形式由 session-start hook 自动安装;最后报告创建的文件及 validate/evals 结果。其余平台、收费或效果信息暂未提供。