Claude code settings auditor

何时使用

适用于为一个仓库初始化、审计或重写 Claude Code 的 .claude/settings.json 权限：基于技术栈、构建工具、包管理器与 monorepo 结构，推断出一份仅含只读命令的 permissions.allow 白名单，并按需给出 .mcp.json 建议。目标是让 Agent 在尽量少弹权限确认的前提下，仍只能执行无副作用的探查命令。

不该用：需要授权会改变状态的命令（install / build / run / 写 / 删 / 部署）；要给自定义项目脚本（如 ./scripts/deploy.sh）或用户态绝对路径开口子；做完整的代码安全审计或漏洞扫描（那是安全卷的事，见互见）。本技能只产出推荐，不替代环境特定的验证与人工复核。

步骤

1. 探测技术栈：列目录并扫关键配置文件（见下方指令的 find 命令），用指示文件判定语言/构建/monorepo。
2. 探测服务集成与框架：读依赖清单（package.json 的 dependencies/devDependencies、pyproject.toml 的依赖表、Gemfile、Cargo.toml）识别 Web 框架与第三方服务。
3. 读现有设置：cat .claude/settings.json，决定是新建还是与现有基线合并。
4. 生成 allow 清单：基线只读命令 + 仅已检测到工具对应的栈命令；多锁文件并存时各自只取对应包管理器命令。
5. 按需给出 .mcp.json：注意 MCP 配在 .mcp.json 而非 settings.json；永远不要建议 GitHub MCP，GitHub 一律走 gh CLI。
6. 输出：检测摘要表 + 可直接复制的 settings.json + （如适用）MCP 建议 + 合并说明。

指令

探测命令：

ls -la
find . -maxdepth 2 \( -name "*.toml" -o -name "*.json" -o -name "*.lock" -o -name "*.yaml" -o -name "*.yml" -o -name "Makefile" -o -name "Dockerfile" -o -name "*.tf" \) 2>/dev/null | head -50
cat .claude/settings.json 2>/dev/null || echo "No existing settings"
cat .mcp.json 2>/dev/null || echo "No existing .mcp.json"

指示文件 → 判定：

类别	指示文件
Python	pyproject.toml setup.py requirements.txt Pipfile poetry.lock uv.lock
Node.js	package.json package-lock.json yarn.lock pnpm-lock.yaml
Go / Rust	go.mod go.sum / Cargo.toml Cargo.lock
Ruby / Java	Gemfile Gemfile.lock / pom.xml build.gradle
构建 / 基建	Makefile Dockerfile docker-compose.yml / *.tf kubernetes/ helm/
monorepo	lerna.json nx.json turbo.json pnpm-workspace.yaml

栈命令（仅检测到才加，全部带 :* 后缀放行任意参数）：

检测到	加入的只读命令
Python	python --version；poetry.lock→poetry show/poetry env info；uv.lock→uv pip list/uv tree；Pipfile.lock→pipenv graph；仅 requirements.txt→pip list/pip show/pip freeze
Node.js	node --version；pnpm-lock.yaml→pnpm list/pnpm why；yarn.lock→yarn list/yarn why；package-lock.json→npm list/npm view/npm outdated；tsconfig.json→tsc --version
Go / Rust	go version/go list/go mod graph/go env；rustc --version/cargo tree/cargo metadata
Ruby / Java	bundle list/bundle show；mvn dependency:tree 或 gradle dependencies
构建	docker --version/docker ps/docker images；docker-compose config；terraform providers/terraform state list；make -n

框架 → WebFetch 域名（检测到才加）：Django→docs.djangoproject.com；FastAPI→fastapi.tiangolo.com；React→react.dev；Next.js→nextjs.org；Vue→vuejs.org；Rails→guides.rubyonrails.org；Go→pkg.go.dev；Rust→docs.rs/doc.rust-lang.org；Docker→docs.docker.com；K8s→kubernetes.io；Terraform→registry.terraform.io。

示例

始终纳入的基线只读命令（系统探查 + git/gh 只读）：

[
  "Bash(ls:*)", "Bash(pwd:*)", "Bash(find:*)", "Bash(file:*)", "Bash(stat:*)",
  "Bash(wc:*)", "Bash(head:*)", "Bash(tail:*)", "Bash(cat:*)", "Bash(tree:*)",
  "Bash(git status:*)", "Bash(git log:*)", "Bash(git diff:*)", "Bash(git show:*)",
  "Bash(git branch:*)", "Bash(git remote:*)", "Bash(git tag:*)",
  "Bash(git stash list:*)", "Bash(git rev-parse:*)",
  "Bash(gh pr view:*)", "Bash(gh pr list:*)", "Bash(gh pr checks:*)", "Bash(gh pr diff:*)",
  "Bash(gh issue view:*)", "Bash(gh issue list:*)",
  "Bash(gh run view:*)", "Bash(gh run list:*)", "Bash(gh run logs:*)",
  "Bash(gh repo view:*)", "Bash(gh api:*)"
]

最终落盘结构（按类别分组、注释说明来源）：

{
  "permissions": {
    "allow": [
      // 基线 + 仅检测到的栈命令 + 框架 WebFetch 域名
    ],
    "deny": []
  }
}

MCP 建议（仅检测到对应服务时，写入 .mcp.json，占位符替换为实际值）：

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@linear/mcp-server"],
      "env": { "LINEAR_API_KEY": "${LINEAR_API_KEY}" }
    }
  }
}

输出结构：① 检测摘要表（语言/包管理器/框架/服务/构建工具）；② 可复制的 .claude/settings.json；③ 如适用的 .mcp.json；④ 已有设置时的合并说明。

注意事项

• 只放只读、无副作用的命令；:* 仅放行该基命令的任意参数，不要放行 shell 串联。
• 绝不纳入：用户态绝对路径（/home/...、/Users/...）、项目自定义脚本、任何 install/build/run/写/删命令。
• 包管理器互斥：项目用 pnpm 就别放 npm/yarn；用 poetry 就别放 pip（除非同时有 requirements.txt）；uv→不放 pip/poetry。多锁文件并存时各取所需。
• MCP 配在 .mcp.json，不在 settings.json；永不建议 GitHub MCP，GitHub 操作统一用 gh CLI。
• 有第三方服务（如 Sentry/Linear）时，对应的 Skill 放行、文档域名、MCP 仅在确实检测到该服务时才加，避免污染基线。
• 输出是推荐基线，落库前需人工复核是否贴合本仓库的安全边界；缺输入或边界不清时先停下问清。

互见

• related：agent-plugin-audit —— 审计已安装的 Agent 插件/技能的权限与风险，与本技能的权限基线互补。
• related：env-secrets-hygiene —— 配套收紧密钥/环境变量暴露面，避免只读放行外的泄露。
• related：dependency-auditor —— 同为仓库级只读审计，可在 CI 中与权限基线一起跑。
• combines_with：devcontainer-claude-setup —— 搭建 Claude Code 项目环境后，用本技能生成配套的 settings.json 权限。

---

本条采编自 sickn33/antigravity-awesome-skills（MIT 许可证）。