SuperAPI AI 工具集

ai-coding-agents-permissions

编程与开发

查看项目

更新于 10-16 04:53

技能介绍

用途:为编码智能体 CLI 或运行时设计、审查审批与权限体系,包括工具权限模式、计划模式进出、沙箱升级、后台智能体自动拒绝行为,以及 leader-worker 权限路由。该技能负责审批架构;通用钩子或回调自动化应改用 ../agents-hooks/SKILL.md。

主要能力:把权限建模为运行时状态而非分散布尔值,维护单一宿主权限上下文(模式、规则来源、特殊标志);区分始终允许、始终拒绝、始终询问、组织策略与会话本地覆盖;定义可提示性,后台 worker、无头会话或远程查看者需自动拒绝或委托审批;将计划模式视为可逆的权限转换并保留先前模式;按执行拓扑路由审批(本地 REPL、远程会话、swarm worker 语义共享但传输不同);待审批作为一等运行时对象,跟踪提示 ID、工具调用 ID、取消状态与结果;远程请求桥接为本地可渲染对象;持久化规则需做可达性与危险广度 lint;测试拒绝、取消、未知工具、worker 超时、绕过模式限制与过宽 shell 规则等敌对路径;授权范围绑定具体动作、目标、执行者与会话/策略范围。

使用方式:按构建顺序先定义单一规范权限上下文,显式建模权限模式与规则来源,实现请求 ID、审批结果与取消语义,按拓扑路由审批,加入持久化或会话本地记忆,再做规则净化与遮蔽检测,最后处理共享与个人策略层的来源差异。

适用场景:设计编码智能体权限模型、添加工具审批提示与 ask/allow/deny 规则、建模计划模式进出、将 worker 审批路由至 lead 或远程桥、决定后台智能体应自动拒绝的内容。

限制与陷阱:宿主拥有 allow/deny/ask 与持久化策略,工具只描述请求;非交互执行者不得挂起等待无法回答的提示;每个提示必须恰好有一个终态(批准、拒绝、取消、过期);持久化规则激活前须 lint;常见失败包括提示 ID 无法匹配取消、远程审批引用未知工具、持久化 shell 规则悄然变宽、worker 永久阻塞、计划模式退出未恢复原状态、低优先级 allow 规则被遮蔽。资料还包含 Claude Code 权限模式快速参考(default/Manual、acceptEdits、plan、auto、dontAsk、bypassPermissions)及受保护路径、分类器审批、继承规则与规则语法评估顺序等细节。