SuperAPI AI 工具集

agt-policy-authoring

安全与审计

查看项目

更新于 10-16 00:31

技能介绍

用途:当需要为正在检查的仓库创建、审查或定制 AGT 策略时使用本技能,产出仓库本地策略源文件 .agt/policy.json。它面向 @microsoft/agent-governance-copilot-cli 支持的 schema,但不会让宿主代理强制执行策略,除非宿主具备兼容的 AGT 集成。

主要能力与用法:从 AGT 严格配置起步,仅根据仓库发现结果做最小增量修改,保留 fail-closed、密钥读取保护、元数据端点阻断、下载脚本阻断、提示注入防御与输出扫描等基线。发现阶段只读取最少仓库元数据,如代理说明、贡献指南、现有 AGT 策略、依赖清单、构建测试脚本、CI 与部署配置,并识别文件写入、shell 执行、网络访问、包安装、部署、基础设施变更、生成产物与敏感路径等能力面。设计时按证据决定:只读检查加入 allowedTools;构建、测试、安装、网络抓取或普通写入保留在 reviewTools;凭据访问、元数据端点、下载脚本执行、破坏性命令或持久化变更保留或新增窄范围 deny/review 规则;抓取内容、shell 输出、浏览器输出或 MCP 响应加入 scanOutputTools。禁止在 allowedTools 中使用 *,未知工具保持 defaultEffect: "review"。

交付物:完整的 .agt/policy.json、每条新增或变更规则与仓库能力或风险的对应理由、至少含 allow/review/deny 的测试矩阵,以及 schema 校验结果。校验命令为 agt-copilot policy validate --file .agt/policy.json。校验只确认文档受支持并保留必需基线约束,不加载策略、不授予权限、不执行决策。

限制:不得检查凭据或含密路径(如非示例 .env、私钥、云凭据目录、令牌缓存、环境转储);不得用仓库扫描收集密钥值;不得在未获明确批准时启用策略、覆盖用户策略或更改代理配置;仓库本地策略加载为可选,需用户明确批准后通过 AGT_COPILOT_POLICY_PATH 指向已校验文件并用 /clear 或 /agt reload 重载,放置 .agt/policy.json 不会自动启用强制执行。字段定义与运行时行为以 Copilot CLI 治理包文档为准。