SuperAPI AI 工具集

policy-engine-builder

安全与审计

查看项目

更新于 10-16 00:23

技能介绍

该技能用于指导配置 Gemini CLI 的 Policy Engine(策略引擎),通过 TOML 规则以 allow(允许)、deny(拒绝)、ask_user(询问用户)三种决策控制工具执行权限。技能强调必须先调用 gemini-cli-docs 技能查询官方文档,并仅基于官方文档作答。

主要能力:编写基本规则(toolName、decision、priority 字段);使用 toolName 匹配单个、多个或全部工具;使用 commandPrefix、commandRegex 匹配 Shell 命令;使用 argsPattern 按 JSON 参数正则匹配;配置 MCP 服务器级与工具级规则及通配符(如 my-server__*);通过 modes 限定规则仅在 yolo 或 autoEdit 模式下生效。

优先级系统:分 Default、User、Admin 三个层级,计算方式为 tier_base + toml_priority/1000,层级更高者优先,同层内优先级更高者优先;优先级 0-99 为默认,100-499 普通规则,500-799 重要限制,800-999 关键安全规则。

策略文件位置:用户级 ~/.gemini/policies/,项目级 .gemini/policies/,系统级 /etc/gemini-cli/policies/(Linux)等。

使用方式:编写 TOML 规则文件,可用 gemini --policy-file ./test-policy.toml 测试,用 gemini --debug-policy 调试匹配。校验语法可运行 python -c "import tomllib; tomllib.load(open('policy.toml', 'rb'))"。

适用场景:限制工具使用、企业安全策略、控制 MCP 权限、审批工作流、审计规则;提供安全开发、只读模式、NPM 安全、MCP 限制、企业锁定等模板。

限制:具体安装步骤、收费与版本细节暂未提供。