前言¶
从社区装一个 Skill,往往只能先看 SKILL.md 和目录结构,很难在几分钟内判断有没有提示注入、外传通道或供应链风险。自己翻脚本、对 CVE、记红线,成本高,也容易漏项。
下面介绍 SkillHub 上的 钟馗.skill(安装标识 @indiv-ebandao/zhongkui-skill)。它把审查流程写进通用 SKILL.md,用三层思路(静态审计、行为模拟、供应链溯源)覆盖 12 类风险,并输出带总分的结构化裁定。任务线索里给出的 API 路径为 user_741dc82b/private-equity,名称写作「股权投资.SKILL」;在 SkillHub 可核对页面中,同一发布者展示名为 user_741dc82b,当前可安装条目为「钟馗.skill」,正文以下述官方页面与包内 SKILL.md 为准。
这是什么¶
钟馗.Skill 是面向 Agent Skill 的安全审查技能:维护可更新的模式库(patterns.json),对目标 Skill 目录做清单化审计,按规则打分并给出「干净 / 可疑 / 恶意」裁定。
- 出品:SKILL.md 元数据作者为「智慧半岛」;SkillHub 页面展示命名空间为
@indiv-ebandao/zhongkui-skill,发布者 handle 为indiv-ebandao。 - 分类:SkillHub 页面 JSON 中
category为it-ops-security(IT 运维安全)。 - 版本:SkillHub 详情页标注 v1.0.13(通过
api.skillhub.cn下载的包内 frontmatter 曾为1.0.12,以你安装时页面/包内版本为准)。 - 解决什么问题:在用户说「审查这个 Skill」「安全检查」「钟馗看下」「审一下」「查一下这个 skill」、安装前评估,或需要审计 SKILL.md 中可疑载荷时,按固定指令与报告模板执行审查,减少口头闲聊式结论。
官方介绍页(可核对简介与安装提示):
https://www.skillhub.cn/skills/indiv-ebandao/zhongkui-skill
任务给出的 API 地址 https://api.skillhub.cn/user_741dc82b/private-equity 对 GET 请求返回 HTTP 405且无正文,无法从该 URL 直接读取详情;安装与说明以 SkillHub 页面及 skillhub.cn/install/skillhub.md 为准。
核心功能¶
以下能力来自 SkillHub 页面简介,以及从 api.skillhub.cn 下载的 zhongkui-skill 包内 SKILL.md(与页面描述一致部分)。
三层审查架构¶
- Layer 1 静态清单审计:按
references/static-audit.md的 54 项检查 SKILL.md、scripts、依赖与权限声明;命中项扣分并标注风险类型 R1–R12 与行号。检出 R1/R3/R5/R8/R11/R12 时,文档规定应进入 Layer 2。 - Layer 2 行为模拟评估:按
references/behavioral-emulation.md的场景做 ToolEmu 范式推理。包内 SKILL.md 标明「规划中,尚未实现」。 - Layer 3 供应链溯源:按
references/supply-chain.md做多维追溯。包内 SKILL.md 同样标明「规划中,尚未实现」。
因此,当前可依赖的主要是 Layer 1 静态审计 与配套评分、红线、漏洞库更新;对话中仍可发起「审行为」「审依赖」等指令,但 Layer 2/3 的完整自动化能力以文档实现状态为准。
12 类风险与裁定¶
风险编号 R1–R12 覆盖提示注入、恶意执行、凭证窃取、依赖投毒、数据外传、权限提升、持久化后门、隐蔽指令、隐私与合规、外部信息源投毒、智能体行为级漏洞等(详见包内「风险速查」表)。
裁定与页面简介一致,输出结构化结论(文档中使用干净 / 可疑分级 / 恶意等档位,对应简介中的三档语义):
| 裁定 | 条件(包内 scoring 说明) | 处理建议 |
|---|---|---|
| 干净 | 总分 ≥ 85 | 可安全安装 |
| 可疑(低) | 70–84 | 附带主要风险点供判断 |
| 可疑(高) | 60–69 | 建议拒绝并附报告 |
| 恶意 | < 60 | 禁止安装 |
命中「一票否决」项或「即时拒绝红线」任一条时,文档规定直接裁定为恶意,不再走总分计算。
漏洞库更新¶
patterns.json 分 manual 基础库 与 auto 增量库。可通过 zhongkui.py 从 NVD API、Seebug RSS 等拉取候选签名,预览后注入增量库;--update 不修改 manual 条目,注入前会备份为 patterns.json.bak。包内写明基础库含 137 条手工签名。
快速指令与脚本¶
对话侧示例指令(包内 SKILL.md):
| 指令 | 作用 |
|---|---|
审 <skill路径> |
完整三层审查流程(Layer 2/3 见上文实现状态) |
快审 <skill路径> |
仅 Layer 1,秒级 |
审依赖 <skill路径> |
仅供应链溯源 |
审行为 <skill路径> |
仅行为模拟 |
脱离对话时可用:
python zhongkui.py <目标Skill绝对路径> --quick
python zhongkui.py <目标Skill绝对路径> --update --apply
python zhongkui.py --update --dry-run
安装与启用¶
SkillHub 页面给出的安装提示如下(让 Agent 读取安装说明后安装指定标识):
请根据 https://skillhub.cn/install/skillhub.md,安装 `@indiv-ebandao/zhongkui-skill`。
若本机已安装 skillhub CLI,可按 skillhub.cn/install/skillhub.md 操作:安装技能时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 且可能不被识别。文档列出的常见路径包括:
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下.agents/skills/
示例:
command -v skillhub && skillhub --version
skillhub install @indiv-ebandao/zhongkui-skill --dir ~/.cursor/skills/
未安装 CLI 时,安装脚本见官方 skillhub.cn/install/skillhub.md(curl -fsSL 拉取 install.sh)。Cursor / Codex / Claude Code 的差异仅在于 skills 目录路径 不同,安装命令中的包名一致。
SkillHub 页面还提供直链下载(示例:api.skillhub.cn/api/v1/download?slug=zhongkui-skill&namespace=indiv-ebandao,随版本可能 302 到对象存储),解压后将目录放入上述 skills 路径即可。
典型用法¶
1. 安装某个社区 Skill 之前¶
在对话中指向待审目录,例如:
审 /path/to/community-skill
Agent 应按包内「输出格式(强制)」生成报告,包含总分、一句话结论、扣分项表,以及高危项 PASS 摘要。
2. 仓库里多个 Skill 批量初筛¶
对每个目录只做 Layer 1:
快审 /path/to/skill-a
快审 /path/to/skill-b
3. CI 或本地脚本快审¶
python zhongkui.py /absolute/path/to/skill --quick
路径需为绝对路径;相对路径在脚本模式下不可靠(包内「路径提示」)。
4. 审查前更新模式库¶
python zhongkui.py /absolute/path/to/skill --update --apply
先 --dry-run 或交互式 --update 预览增量,再决定是否注入。
适用场景与注意¶
适合谁
- 经常从 SkillHub、Git 或同事处安装 Skill 的开发者与运维,需要在装前做一致化检查。
- 编写自有 Skill、发布前想对照 54 项清单与 17 条「即时拒绝红线」自审的团队。
限制与坑
- Layer 2 / Layer 3:文档明确尚未实现完整自动化;不要默认「三层都已跑完」。
- 能力边界:包内说明行为层为静态推理而非真实沙箱;混淆载荷、零日、跨 Skill 组合攻击等存在盲区,审查结果不是安全担保。
- 结构假设:默认标准目录(SKILL.md、scripts、references);非标准布局覆盖率下降。
- 统计数字:SkillHub 页面内嵌数据曾展示 downloads: 319628、stars: 15(随时间变化);任务线索中的「评分 99167」「下载 456 次」未在已打开的页面 JSON 中找到对应字段,正文不采用。
- 官方 API 路径:
https://api.skillhub.cn/user_741dc82b/private-equity无法通过 GET 获取说明,排错或溯源时请使用 SkillHub 技能详情页与@indiv-ebandao/zhongkui-skill标识。
结尾¶
钟馗.Skill 把 Agent Skill 安全审查收成可复现的指令、清单与报告模板,并支持模式库更新与 zhongkui.py 脚本接入流水线。当前落地价值主要集中在 Layer 1 静态审计与红线/评分裁定;装 Skill 前走一遍「审」或「快审」,比纯人工翻文件更省时间,但仍需结合场景做人工复核。
- SkillHub 详情与安装提示:https://www.skillhub.cn/skills/indiv-ebandao/zhongkui-skill
- SkillHub 安装说明:https://skillhub.cn/install/skillhub.md
- 任务给出的 API 入口:https://api.skillhub.cn/user_741dc82b/private-equity