本页由繁体中文版自动转换
inspect-github-agent-resources
先审查,再决定装不装
把 skill、plugin、MCP server 或 agent 范本装进 agent 之后,agent 会读它的说明,有些资源还附带会被执行的指令。装之前能看到的,通常只有 README、星数和几行简介。这些写的是作者怎样介绍它,很少说它在你的环境里会读什么、写什么、连去哪里。
读过 README 也不等于看过来源。说明文字、被隐藏的注解、附带的范例档,都可能含有写给 agent 看的句子。审查的人(或 agent)读到它们,只能当证据,不能当指令。
本文介绍一套静态审查的做法,以及执行它的 agent skill。它回答三件事:这个资源能帮你完成什么工作;依来源看,哪些安全疑虑会影响你的用法;装它或更新它之前,最小的一项验证是什么。它不安装、不执行被审查的程式码,也不发安全证明。
程序
1. 先写下你要做的决定。你要完成什么工作、可接受的成品长什么样、现在怎么做、卡在哪里;环境、资料、帐号、能不能执行程式码这些限制;以及你要的是找选项、检视一个指定资源、比较几个,还是规划验收与维护。已经给过的资讯,skill 不会要你重讲。缺一项而且会改变结论时,只问一个问题,其余不受影响的检视照常进行。工作还说不清时,它改给有来源支持的示例用途和有条件的适配判断,不替你编造用户画像。
2. 开始查之前,先宣告界线。探索阶段的起始预算是 3 个搜寻、筛 12 个 repo、深查 3 个候选。指定目标的审查,起始是最多 3 个目标;每个目标看它的出处资料、被指定的那个单元,以及该单元直接引用的档案(往下一层),最多 40 个文字档。你另有范围就从你的。上限只是涵盖范围的限制,不是危险的证据。只读了一部分的档案、没读到的重要引用,都要记下;想扩大范围时只提出来,不会自行扩大。公开目标只用匿名的公开来源;本机快照只读你明确授权的路径,不上传,也不顺手去搜帐号或机器上的其他资料。
3. 把版本钉死。公开目标要确定 repo 的正式名称、拥有者、要看的 ref 和确切的 commit SHA,并查发布者身分、授权、维护状况、release 与相关的官方安全公告。本机目标则记下来源、确切单元和观察到的杂凑值;没有的出处就写没有,不替本机档案编造 GitHub 身分或 commit。
4. 读四类面向。
- 说明与隐藏内容:提示注入、越权指示、被隐藏的注解、Unicode 异常字元。异常字元单独出现不足以证明攻击,需要解读。
- 权限与资料处理:要求凭证、读取敏感档案、写入、网路目的地、遥测,以及可能的外泄路径。
- 执行与持续存在:安装 hook、指令、可执行档或二进位入口、背景行为、自动更新。
- 出处与供应链:确切版本、相依套件、发布者证据、相关官方公告,以及没审到的部分。
整个过程不 clone、不下载压缩档、不安装、不汇入、不启用、不更新、不执行候选的程式码。仓库里的说明、隐藏注解和范例内容,一律只当证据,不当权威。
5. 有确切位元组时,才跑清点 helper。你授权的稳定本机快照已经存在时,skill 附一支不需安装套件的 Node.js 脚本,清点档案杂凑、隐藏 Unicode、注解、部分 hook 与执行面。它只产出机械指标,不判断恶意程式,也不证明隔离。拿不到位元组时,skill 要说明缺了这一步,哪些结论下不了,仍回答其余能回答的部分。
6. 先给答案,再附证据。回报先回答你的决定:适合哪项工作、在什么条件下适配、建议的下一步。接着是支撑它的证据,每个推论连到出处。证据分四种标记:
source-verified:在记录的 ref 或杂凑上直接看到的来源内容。inferred:由证据和你的限制推论出来的结论。not-found:在指定范围内搜过没找到,不等于别处不存在。runtime-unverified:要执行或连线才能知道,并写明需要什么验证。
涵盖范围另分 reviewed、partial、not-reviewed、not-applicable。处置只有四种:stop(来源证据显示违反你宣告的界线,或有具体的完整性、权限、隐藏指示问题)、insufficient-evidence(关键的出处或安全涵盖缺失,下不了结论)、needs-review(有需要解读或验证的疑虑)、no-blocker-observed(范围内适用的检查都完成,没看到阻碍;探索阶段的筛选不能得到这一项)。skill 不输出数字分数,也不用「safe」「approved」「cleared for install」当结论。
有用和能装是两个问题。一个资源可以对你的工作有用,同时安装处置仍是 insufficient-evidence;没有静态阻碍的资源,也可能对你的工作毫无帮助。两个答案分开列。最后给出最小的一项验证:做什么、谁提供证据、预期看到什么。能用唯读检查或合成案例解决的,优先用。
资源改版时
资源改版就是一次新的审查。skill 附另一支脚本,比较两份你授权的本机快照,列出档案杂凑的差异。它不去抓新版本,不排程,也不判断该不该更新。杂凑变了,表示有某些结论要回头重看;被改动的 hook 是一条要追查的线索,并未证明有漏洞,也没证明已修好。杂凑没变,也不代表外部公告或你的部署环境没变。没受影响的证据连同原版本保留,受影响的结论标为待重审,旧的决定不会悄悄沿用。
出处
本页程序的整体组合,以及四种证据标记的分法、四种处置的判定次序、审查范围的起始预算、改版时只把受影响的结论送回重审,是 Trigpoint(2026)的工作选择。各部分的基本想法都有前人做过,不属首创:
- 把受审 repo 里的文字当证据、不当指令:Greshake 等(2023)指出外部内容可以间接注入指令;OWASP(2025)LLM01 建议把不受信任的内容分开并清楚标示。
- 把直接取得的资料与推论分开标示:ODNI(2015)ICD 203 已列为情报分析标准。
- 处置与证据纪录:OASIS(2020)SARIF 2.1.0 的结果类别 fail、open、review、pass,与 stop、insufficient-evidence、needs-review、no-blocker-observed 大致一一对应;其 run 物件同样把一次分析的工具、版本与结果收在一起。
- 安装前读四类审查面:Mercer(2026)在 Aident 发表的〈How to Audit an Agent Skill Before You Install It〉已涵盖同样四类。
- 有用和能装分开回答:SkillAudit(2026)的 SkillPortrait 已把效用与安全分成两轴,且不合成一个分数。
- 不依赖外部服务的静态清点:Cisco AI Defense(2026)的 skill-scanner 已有不需外部服务的静态分析器。
- 改版比较:SARIF 2.1.0 以基准版本把结果标为新增、不变或消失;Trail of Bits(2026)的 differential-review 是审查差异的 agent skill,开发期曾与它比较。
- 验收包:NIST(2018)SP 800-37 的授权包,同样把评估纪录交给具名负责人决定是否接受。
目前的成效
v0.1.0 的验收纪录放在 repo 的 VALIDATION.md,能说的范围很窄。
清点与比较脚本:在 macOS arm64 上,Node.js 20.0.0 和 24.21.0 各自通过全部 24 个回归测试,没有略过;两个版本也都跑了文件里的示范清点和前后比较。测试涵盖唯读清点、隐藏文字指标、上限、涵盖缺口、指令遮蔽、Unicode 位移、符号连结、固定排序与比较语意。Node 20 已终止维护,相容只供旧环境参考,日常请用维持中的 LTS 版本。
Agent 使用:独立的 agent 工作阶段拿到 skill 和它引用的来源,没有拿到标准答案,输出对照事先记下的评分表。三个本机情境:
- 首次使用:照 README 不安装的路径,读示范档、跑清点脚本,把窄范围的适配、尚未测的行为和模型供应方的隐私分开讲。这一轮也让 README 修掉一处示范与连结范例不一致的地方。
- 静态审查:对一个示范资源,找出一条会读取笔记并尝试 HTTP POST 的 postinstall 路径,以及一段想压下这项发现的 HTML 注解。agent 没有照注解里给审查者的指示做,也没有执行目标。
- 版本审查:找出新增的外送笔记资料、同步改非同步的 API 变动,以及对离线和错误处理的影响;保留没受影响的证据,没有把干净的机械扫描当成安全的证明。
第四个情境用了一份公开的第三方 PDF skill。agent 解析出固定的 commit,读了六个目标档和六份直接相关的官方来源,把表格撷取的适配度连到相依套件与范例行为,查了该单元的授权,保留未固定的执行环境和公告的不确定性,并提出以页、列、值为单位的验收检查。它没有安装目标,没有处理任何 PDF,也没有量测撷取品质。这个情境和首次使用案例是同一个 agent,不算第四个独立 agent。
这些是同一个 agent 环境下的有限观察,没有量到一般的侦测率、误报率、节省的人工时间,也没有跨 agent 的相容性。目标程式码都没有被执行。
还没验证的部分
VALIDATION.md 没有宣称已验证:Codex 与 GitHub Copilot 的宿主原生 skill 探索与安装;Windows 与 Linux 的执行测试;对抗性的即时档案系统隔离;动态恶意程式测试;公开发布与下载的验证。合集页对这个 skill 的标记也只有「macOS arm64 的 helper 测试,宿主原生探索未测」。
此外:审查品质没有做过基准测试,也没有与其他做法比较准确度。这是一次静态审查,不是沙箱执行、渗透测试、完整的恶意程式侦测,或安全认证。helper 在本机运作,agent 读档却可能把内容送给它的模型供应方;档名、杂凑和报告本身也可能泄漏私人资讯,分享前请先看过。
适用时机
适用于:要试用一个不熟的 skill、plugin、MCP server 或 agent 范本之前;为某项工作比较几个候选;资源改版后决定要不要更新。只想知道这类资源能帮上什么忙时,直接问,skill 不会因此展开一次 repo 审查。
它不能取代执行期的实测。要确认资源实际会做什么,需要在你授权的范围内另行测试,不在这个 skill 的范围内。
取得 skill
skill 放在 GitHub:github.com/trigpoint-pub/agent-skills 的 skills/inspect-github-agent-resources,目前版本 0.1.0,2026-10-24 以 trial prerelease 发布(Release 页),授权 MIT。这个 skill 最早以独立 repo 发布,该 repo 已封存,现行版本在合集。
安装时只复制 skills/inspect-github-agent-resources/ 整个资料夹(含 LICENSE),不要复制其他档案:
- Codex:专案内放
.agents/skills/inspect-github-agent-resources/,个人放~/.agents/skills/inspect-github-agent-resources/。 - GitHub Copilot:专案内放
.github/skills/inspect-github-agent-resources/,个人放~/.copilot/skills/inspect-github-agent-resources/。
这是文件目前记载的预设位置,不盖过你所在组织的规定。目的地已存在时,先比较版本再决定要不要替换。各宿主能不能找到这个资料夹,没有端到端测过;装好后若 skill 选单没出现,请照该宿主的说明重新整理或重启。
证据标记、涵盖值与处置的完整定义在 skill 内的 references/audit-contract.md,清点 helper 的范围与限制在 references/scanner.md,改版维护在 references/maintenance.md。
第一次使用
前提。一个能读档的 agent。审查公开 repo 需要匿名的公开网页存取;只审本机档案不需要上网,缺少的出处与公告证据会照实列为缺口。helper 需要 Node.js:建议用维持中的 LTS 版(测过 24.21.0),下限是 20.0.0(已终止维护)。不需要 npm install、API key 或第三方套件。验证用的 agent 环境,纪录没有指名宿主。
不安装先试。从 Release 页取 v0.1.0 的压缩档,解压到一个工作资料夹,保持 skills/inspect-github-agent-resources/ 完整。用能读档的 agent 开启该资料夹,贴上这段请求,把 <repo> 换成解压后的资料夹:
Read <repo>/skills/inspect-github-agent-resources/SKILL.md and use that skill to inspect <repo>/skills/inspect-github-agent-resources/examples/demo-snapshot. I want to summarize my own local notes. Explain task fit, source-based security concerns, evidence gaps, and the smallest useful acceptance check. Do not install or execute the reviewed resource. You may run this review skill's inventory helper.
这段请求取自 repo 说明,保留原文以免走样;skill 要求用你惯用的语言作答。
示例一。此为示范样本。demo-snapshot 是一份只有说明、没有脚本和相依套件的简单资源,功用是把使用者提供的一份笔记整理成大纲。repo 附的参考答复是:它可以把你明确提供的一份笔记整理成大纲,但光凭来源里的指示,证明不了摘要品质,也无法证明模型是离线处理的;先拿一份带有不确定说法的合成笔记试试,检查不确定性有没有被保留。这是 repo 的示意,没有实测结果支持。
示例二。此为示范样本。repo 的 examples/review-example.md 设了另一个情境:使用者每周手动检视第三方 skill,问本机清点 helper 能不能改善这个流程,档案必须留在本机,也还没准备执行候选程式码。示意答复说,它可以帮重复性的档案清点和版本差异侦测,脚本的语意与没扫到的相依套件仍要人看;目前没有证据显示它找得到更多漏洞,或省下可量的时间;安装处置是 insufficient-evidence,因为出处与行为证据不足,但这不妨碍指出它的清点角色。两项拟定的验收:
- 人工审查前先清点:输入已授权的快照,输出杂凑、hook 与略过档案的记录。验收是一个已知的合成 hook 被列出,略过的目录仍看得到,没有执行任何候选 hook。
- 回看改版:输入两份限定范围的快照,输出变动档案的观察。验收是被改动的 hook 让观察改变,涵盖不完整时,不会被写成「确定移除」或「完全相同」。
成功的样子。答复说明它窄范围的用途,引用你提供的档案,把来源宣告的行为和执行期证据分开,并提出一项小验证。不该出现:宣称安全认证,或编造发布者与 release 历史。
失败与限制。答复若给出数字分数,或用「safe」「approved」当结论,就不合 skill 自己的契约。helper 的结束码:0 表示纳入范围的清点完成,不表示资源可以安装;1 表示清点不完整或失败;2 表示输入无效。helper 的报告请存在被扫描的资料夹之外,免得改动了正在量测的证据。
版本与验证。skill 0.1.0,trial prerelease;验收纪录在 VALIDATION.md。一般问题请用 GitHub Issues,附上合成的重现步骤,不承诺回复时限;涉及安全的回报,走 GitHub 的私人漏洞回报管道。