SuperAPI AI 工具集

claude-permissions-optimizer

编程与开发

查看项目

更新于 10-16 07:29

技能介绍

用途

Claude Permissions Optimizer 用于优化 Claude Code 的权限设置。它会从用户的会话历史中找出经常触发权限提示但属于安全的 Bash 命令,并将这些命令自动加入 settings.json 的 allow 列表,从而减少重复的权限询问。该技能强调基于证据(实际使用记录)而非主观预设,不会将危险命令加入白名单。

主要能力

  • 分析会话历史:扫描最近的会话记录(默认最近 500 个会话或近 30 天,取更严格者),提取唯一 Bash 命令。
  • 过滤与分类:排除已被现有 allow 规则覆盖的命令,应用最少使用次数阈值(5 次以上),将命令标准化为 Bash(pattern) 规则,并预分类为安全、需审查或危险。
  • 生成建议:输出 green(可安全自动允许的模式)、redExamples(被排除的危险模式示例)以及 yellowFootnote(常用但不宜自动允许的命令摘要)。
  • 自动应用:在用户确认后,将新规则写入用户级 ~/.claude/settings.json 或项目级 .claude/settings.json,避免重复、按字母排序,并以 2 空格缩进写回。
  • 校验:写入后使用 node 命令校验 JSON 有效性,若失败则从读取内容恢复并报错。

使用方式

该技能可在任意编码智能体中运行,只要机器上存在 ~/.claude/(或 $CLAUDE_CONFIG_DIR)。流程如下:

  1. 预检查运行环境:若在 Claude Code 内则直接继续;若在其他编码智能体(Codex、Gemini CLI、Cursor 等)中,会先告知用户该技能将分析 Claude Code 会话历史并写入其 settings.json,结果在下次使用 Claude Code 时生效。
  2. 选择分析范围:通过平台的阻塞式提问工具(AskUserQuestion、request_user_input、ask_user)让用户选择所有项目(推荐)、仅当前项目或自定义约束;若无提问工具则展示编号选项等待回复。
  3. 运行提取脚本:
    • 所有项目:node <skill-dir>/scripts/extract-commands.mjs
    • 仅当前项目:node <skill-dir>/scripts/extract-commands.mjs --project-slug <slug>(slug 为绝对路径将所有非字母数字字符替换为 -,例如 /Users/tmchow/Code/my-project 变为 -Users-tmchow-Code-my-project)
    • 可选 --days <N> 限制最近 N 天。
  4. 展示结果:分三部分——分析摘要(用 stats 展示扫描的会话数、唯一命令数、已覆盖数、低于阈值过滤数、剩余触发提示的命令数)、推荐列表(以编号表格展示 green 模式及其证据;如有 redExamples 则显示最多 3 条被阻止的示例)、底部结论(一句话,基于 stats 计算覆盖率前后百分比,例如“Adding 22 rules would bring your allowlist coverage from 65% to 93%.”)。
  5. 获取用户确认:通过阻塞式提问工具让用户决定应用到用户设置、项目设置或跳过;用户也可用自由文本排除特定项(如“all except 3 and 7 to user settings”)。
  6. 应用并写入:读取目标文件(不存在则创建 { "permissions": { "allow": [] } }),追加新规则到 permissions.allow,去重、按字母排序、2 空格缩进写回;然后用 node -e "JSON.parse(require('fs').readFileSync('<path>','utf8'))" 校验,失败则立即从步骤 1 读取的内容恢复并报告错误,不再继续其他文件。成功后提示已应用的规则数量,并说明这些命令将不再触发权限提示;若修改的是项目级 .claude/settings.json 且被 git 跟踪,会提示提交可惠及团队成员。

适用场景

  • 频繁使用 Claude Code,希望减少重复权限弹窗的开发者。
  • 希望基于真实使用数据而非猜测来优化权限配置的团队或个人。
  • 需要管理跨多个项目的权限设置,或仅为当前项目定制权限的情况。

限制

  • 不处理对危险命令(如 rm -rf、git push --force)的放行请求;若用户要求允许破坏性命令,会说明本技能仅优化安全命令,并建议直接在 settings.json 中手动修改。
  • 若已存在 deny 规则阻止某命令,会发出警告而非添加 allow 规则(Claude Code 中 deny 优先)。
  • 需机器上存在 ~/.claude/ 或 $CLAUDE_CONFIG_DIR。
  • 若脚本返回空结果,表示 allow 列表已优化良好或会话历史不足,建议在多次工作会话后重试。
  • 若无项目上下文(在项目外运行),仅提供用户级设置作为写入目标。
  • 文档未提供具体收费、价格或平台支持信息。