SuperAPI AI 工具集

fewer-permission-prompts

编程与开发

查看项目

更新于 10-24 16:19

技能介绍

用途:该技能用于在用户要求“优化 CLI 的 settings.json、减少权限提示时的干扰”这一场景下,分析 Claude Code 的历史会话记录,找出高频且只读的工具调用,并把这些需要反复确认的调用整理成权限白名单建议。

主要能力:

  1. 定位并扫描会话记录:会话文件位于 ~/.claude/projects/<sanitized-cwd>/*.jsonl,每行是一个 JSON 对象;工具调用以 assistant 消息中 type 为 "tool_use" 的条目出现,name 字段标识工具(如 Bash 或 mcp__slack__slack_read_thread),Bash 的命令在 input.command 中。扫描范围覆盖用户所有项目目录,不限于当前项目,并限制在最近约 50 个修改过的 JSONL 文件以内,以保持速度。
  2. 统计调用频率:Bash 调用解析 input.command,处理 sudo、timeout、管道、&&、环境变量前缀后取首个命令 token,记录“命令+首个子命令”组合(如 git status、gh pr view、ls、cat);MCP 调用记录完整工具名;统计出现次数。
  3. 过滤只读命令:仅保留不改动状态的命令,如 ls、cat、git status/log/diff/show/branch、rg、grep、find、head、tail、gh pr view/list/diff、docker ps/logs、kubectl get/describe,以及名称含 read/get/list/search/view 的 MCP 工具;写、删、改名、推送、合并、安装或有副作用的构建和测试一律排除,存疑即不加入。
  4. 安全约束:禁止加入可能授予任意代码执行的模式,例如解释器(python3、node、bun、deno、ruby 等)、shell(bash、sh、ssh、eval 等)、包运行器(npx、bunx、uvx 等)、任务运行器通配(npm run *、bun run *、make * 等)、gh api *、docker run/exec、kubectl exec、sudo 等;精确形式如 Bash(bun run typecheck) 可以,通配形式不行。
  5. 剔除已自动放行的命令:资料列出了 Claude Code 已自动允许的命令清单(如 cat、head、ls、find、grep、git 只读子命令、gh 只读子命令、docker ps 等),这些无需白名单,应跳过。
  6. 选择模式形式:使用能覆盖实际用法的尽量窄的模式;多种变体用 Bash(git log *)(注意 * 前有空格),单一精确调用用 Bash(foo),MCP 用完整工具名。
  7. 排序与展示:按次数降序,丢弃出现少于约 3 次的项,最多保留约 20 条,以 Markdown 表格(排名、模式、次数、说明)呈现。
  8. 写入配置:合并到当前项目的 .claude/settings.json(不是 ~/.claude/settings.json 或 settings.local.json),文件不存在则创建;保留已有键和 permissions.allow 条目,去重,不删除、不打乱无关字段;不修改 permissions.deny、permissions.ask 及其他设置字段。
  9. 结果汇报:说明新增了什么(数量与示例)、哪些已存在、哪些被跳过及原因。

使用方式:在 Claude Code 中触发该技能并提出减少权限提示的需求;技能按上述步骤扫描、统计、过滤、排序、展示,并在用户确认的流程中写入项目配置文件。资料未说明具体的安装命令或调用语法。

适用场景:希望减少 Claude Code 频繁权限弹窗、基于真实使用记录构建项目级只读命令白名单的开发者。

限制:只处理只读命令;不授予任意代码执行;不改动 deny/ask 及其他设置;扫描范围与条数有限制;资料中的自动放行清单以源码文件为准,遇到不确定命令需查源码而非猜测。