SuperAPI AI 工具集

signed-audit-trails-recipe

通用与其它

查看项目

更新于 10-16 07:22

技能介绍

用途:这是一套 cookbook 式教学技能,演示如何为 Claude Code 的每次工具调用(Bash、Edit、Write、WebFetch 等)建立加密签名收据,适用于需要防篡改证据的受监管环境、CI/CD 策略门禁证明、多方协作验证,以及标准日志不足的合规场景(如 EU AI Act 第 12 条、SLSA 溯源)。运行时实现需安装 protect-mcp 插件。

主要能力:每次工具调用先按 Cedar 策略评估,被拒则不执行;执行后用 Ed25519 生成收据,采用 JCS(RFC 8785)规范化,持有公钥者均可离线验证,无需网络或信任运营方。protect-mcp 0.7.4 收据为签名 v2 信封并逐行追加到 ./receipts/receipts.jsonl。

必要用法:先用 /plugin install protect-mcp 安装插件,其钩子在调用前后运行 evaluate.sh 与 sign.sh,脚本从 stdin 读取钩子事件。0.7.4 不自动生成签名密钥,需一次性创建 ./protect-mcp.key: if [ ! -e ./protect-mcp.key ]; then d=$(mktemp -d) && npx protect-mcp@0.7.4 init --dir "$d" && mv "$d/keys/gateway.json" ./protect-mcp.key fi 将私钥与收据目录加入 .gitignore。随后编写 ./protect.cedar 策略(允许只读工具与少量 Bash 命令,拒绝链式与破坏性命令,写入限制在项目内并禁止 .. 段)。查看最新收据:tail -n 1 ./receipts/receipts.jsonl | python3 -m json.tool。验证:PUB=$(node -p 'JSON.parse(require("fs").readFileSync("./protect-mcp.key")).publicKey'),再执行 npx @veritasacta/verify@0.9.2 --replay-chain ./receipts/receipts.jsonl --key "$PUB";退出码 0 全部通过、1 验证失败、2 文件不可读。

限制与注意事项:0.7.4 收据不含前一条链接,删除收据无法被检测;私钥文件不可提交版本控制,泄露需立即轮换;钩子必须从 stdin 读取载荷,Claude Code 不提供 TOOL_NAME/TOOL_INPUT 变量;缺少 ./protect.cedar 时 evaluate.sh 仅警告并放行;CI 中需将收据作为工件上传,且密钥在默认分支环境安装、不在 PR 中运行。收据格式有 protect-mcp、protect-mcp-adk、sb-runtime、APS governance hook 四种独立实现,均可对 @veritasacta/verify 互操作。价格、收费等信息暂未提供。