SuperAPI AI 工具集

skill-installer

安全与审计

查看项目

更新于 10-15 12:25

技能介绍

用途

skill-installer 用于从受监视的注册表(watched registry)获取社区技能并在本地安全运行。其核心目标是让用户在安装前看到原始 SKILL.md 全文、了解该技能能触碰哪些资源,并且在用户明确同意之前不向磁盘写入任何内容。

主要能力

  • 白名单门禁:先读取 ~/.claude/plugins/config/claude-for-legal/legal-builder-hub/allowlist.yaml。限制模式(restrictive)下,来源不在白名单则拒绝;宽松模式(permissive)下则警告并继续。
  • 许可证门禁:从注册表元数据、LICENSE 文件或 SKILL.md frontmatter 中按固定 SPDX 列表严格模式匹配提取许可证标识,并与白名单的 licenses 列表比对。无法识别、缺失或不匹配均作为发现项上报,交由人工审批。
  • 抓取候选技能:克隆或下载技能目录,收集 SKILL.md、commands/、agents/、hooks/hooks.json、.mcp.json、references/、templates/、scripts/* 等。
  • 展示原始 SKILL.md:向用户显示完整原始内容,并标注注入模式(忽略/覆盖/系统提示/权威声明、外部 URL、隐藏 unicode、越界文件写入等)。
  • 结构性信任检查:检查 hooks、MCP 服务器、工具权限、文件写入目标、网络调用,并将 MCP 连接器与白名单交叉核对。
  • 运行 skills-qa:对候选技能运行提示注入启发式扫描,并按 Legal Skill Design Framework 评分,输出裁决与发现。
  • 明确审批:提示 "Proceed? (yes / no / show full)",只有用户重新输入 yes 才安装。
  • 安装:复制目录,更新 CLAUDE.md 并追加到 install-log.yaml。

使用方式

以 /skill-installer 调用,随后按工作流逐步执行:读取白名单、抓取、展示原始 SKILL.md、结构信任检查、运行 skills-qa、角色感知路由、获取明确批准、安装。限制模式下,抓取、原始源码展示与结构信任检查必须在只读子代理(仅 Read + WebFetch + Glob,无 Write、无 Bash、无 MCP)中运行;若无法启动只读子代理则停止。

适用场景

适用于需要从社区注册表引入技能、且希望安装前进行安全审查与人工审批的场景,尤其是法律相关部署环境(个人、律所内部、产品嵌入)。

限制

该技能本身是一系列给 Claude 的指令,第三方 SKILL.md 中的提示注入可能试图让 Claude 跳过原始源码展示、报告干净扫描或在审批前写入文件。白名单门禁、原始 SKILL.md 展示与人工审批可降低风险但无法完全消除。限制模式下若无法启动只读子代理则不得继续。skills-qa 返回 REFUSE 时不提供任何覆盖或强制安装路径。非律师角色在裁决为 SOME CONCERN 或更高时不展示安装提示,而是转交律师联系人。