影子智能体缺口核验

适用场景

比较实际观察到的智能体与现有登记表，找出未登记或长期未见的影子资产。

输入与输出

输入：观察清单 JSON 与 registry 清单 JSON，只接受脱敏的 agent_ref。

输出：agent-shadow-gap-report.json，列出 shadowcandidates、staleregistrycandidates 和 gaphash。

安装与执行

1. 1. 使用 Python 3.10 或更高版本，不需要第三方依赖。
2. 将脱敏 JSON 放入工作目录，执行 scripts/auditshadowagents.py 并传入 --input/--output 或文档中列出的参数。
3. 检查 status、findings 和哈希，再交给下一步。

执行规则

只做集合差异与可追溯报告，不连接云端、不注册资产、不修改登记表。

错误恢复

JSON 无法解析、字段缺失或状态异常时，保留输入并修正后重跑；不要删除未知资产、把 REVIEW 改成 PASS 或绕过人工决定。

权限与隐私边界

本技能只读脱敏 JSON 并生成报告，不连接云平台、注册表、IAM、数据库或网络，不保存密码、Cookie、Token 或真实客户记录。任何 registrymutationexecuted、decommissionexecuted 或 externaldiscovery_executed 默认 false。

验收方式

使用 examples/input.json 运行最小样例，检查输出存在 schema、status、哈希和人工边界标志；观察清单多于登记清单时必须生成 shadow_candidates。