claude-settings-audit

Claude 設定監査

このリポジトリを分析し、読み取り専用コマンド向けに推奨される Claude Code settings.json のパーミッションを生成します。

使用するタイミング

• リポジトリ向けに Claude Code settings.json のパーミッションを設定または監査する場合。
• リポジトリの技術スタック、ツール、モノレポ構成から、安全な読み取り専用の許可リストを推測する必要がある場合。
• 既存の Claude パーミッションのベースラインを、根拠に基づいた内容でレビューまたは置き換えたい場合。

フェーズ 1: 技術スタックの検出

以下のコマンドを実行して、リポジトリ構成を検出します:

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

以下の指標となるファイルを確認します:

カテゴリ	確認するファイル
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	go.mod、go.sum
Rust	Cargo.toml、Cargo.lock
Ruby	Gemfile、Gemfile.lock
Java	pom.xml、build.gradle、build.gradle.kts
Build	Makefile、Dockerfile、docker-compose.yml
Infra	*.tf ファイル、kubernetes/、helm/
Monorepo	lerna.json、nx.json、turbo.json、pnpm-workspace.yaml

フェーズ 2: サービスの検出

サービスの連携を確認します:

サービス	検出方法
Sentry	依存関係内の sentry-sdk、@sentry/* パッケージ、.sentryclirc、sentry.properties
Linear	Linear の設定ファイル、.linear/ ディレクトリ

依存関係ファイルを読み取ってフレームワークを特定します:

• package.json → dependencies と devDependencies を確認
• pyproject.toml → [project.dependencies] または [tool.poetry.dependencies] を確認
• Gemfile → gem 名を確認
• Cargo.toml → [dependencies] を確認

フェーズ 3: 既存の設定の確認

cat .claude/settings.json 2>/dev/null || echo "No existing settings"

フェーズ 4: 推奨事項の生成

以下を組み合わせて許可リストを構築します:

ベースラインコマンド (常に含める)

[
  "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:*)"
]

スタック固有のコマンド

プロジェクトで実際に検出されたツールのコマンドのみを含めます。

Python (Python ファイルまたは設定が検出された場合)

検出された場合	追加するコマンド
Python 全般	python --version、python3 --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 (package.json が検出された場合)

検出された場合	追加するコマンド
Node.js 全般	node --version
pnpm-lock.yaml	pnpm list、pnpm why
yarn.lock	yarn list、yarn info、yarn why
package-lock.json	npm list、npm view、npm outdated
TypeScript (tsconfig.json)	tsc --version

その他の言語

検出された場合	追加するコマンド
go.mod	go version、go list、go mod graph、go env
Cargo.toml	rustc --version、cargo --version、cargo tree、cargo metadata
Gemfile	ruby --version、bundle list、bundle show
pom.xml	java --version、mvn --version、mvn dependency:tree
build.gradle	java --version、gradle --version、gradle dependencies

ビルドツール

検出された場合	追加するコマンド
Dockerfile	docker --version、docker ps、docker images
docker-compose.yml	docker-compose ps、docker-compose config
*.tf ファイル	terraform --version、terraform providers、terraform state list
Makefile	make --version、make -n

スキル (Sentry プロジェクト向け)

これが Sentry プロジェクトの場合 (または sentry-skills プラグインがインストールされている場合)、以下を含めます:

[
  "Skill(sentry-skills:agents-md)",
  "Skill(sentry-skills:blog-writing-guide)",
  "Skill(sentry-skills:brand-guidelines)",
  "Skill(sentry-skills:claude-settings-audit)",
  "Skill(sentry-skills:code-review)",
  "Skill(sentry-skills:code-simplifier)",
  "Skill(sentry-skills:commit)",
  "Skill(sentry-skills:create-branch)",
  "Skill(sentry-skills:create-pr)",
  "Skill(sentry-skills:django-access-review)",
  "Skill(sentry-skills:django-perf-review)",
  "Skill(sentry-skills:doc-coauthoring)",
  "Skill(sentry-skills:find-bugs)",
  "Skill(sentry-skills:gh-review-requests)",
  "Skill(sentry-skills:gha-security-review)",
  "Skill(sentry-skills:iterate-pr)",
  "Skill(sentry-skills:pr-writer)",
  "Skill(sentry-skills:security-review)",
  "Skill(sentry-skills:skill-creator)",
  "Skill(sentry-skills:skill-scanner)",
  "Skill(sentry-skills:skill-writer)",
  "Skill(sentry-skills:sred-project-organizer)",
  "Skill(sentry-skills:sred-work-summary)"
]

WebFetch ドメイン

常に含める (Sentry プロジェクト)

[
  "WebFetch(domain:docs.sentry.io)",
  "WebFetch(domain:develop.sentry.dev)",
  "WebFetch(domain:docs.github.com)",
  "WebFetch(domain:cli.github.com)"
]

フレームワーク別

検出された場合	追加するドメイン
Django	docs.djangoproject.com
Flask	flask.palletsprojects.com
FastAPI	fastapi.tiangolo.com
React	react.dev
Next.js	nextjs.org
Vue	vuejs.org
Express	expressjs.com
Rails	guides.rubyonrails.org、api.rubyonrails.org
Go	pkg.go.dev
Rust	docs.rs、doc.rust-lang.org
Docker	docs.docker.com
Kubernetes	kubernetes.io
Terraform	registry.terraform.io

MCP サーバーの提案

MCP サーバーは .mcp.json で設定します (settings.json ではありません)。既存の設定を確認します:

cat .mcp.json 2>/dev/null || echo "No existing .mcp.json"

Sentry MCP (Sentry SDK が検出された場合)

.mcp.json に追加します ({org-slug} と {project-slug} は、お使いの Sentry の組織とプロジェクトのスラッグに置き換えてください):

{
  "mcpServers": {
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp/{org-slug}/{project-slug}"
    }
  }
}

Linear MCP (Linear の使用が検出された場合)

.mcp.json に追加します:

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

Note: GitHub MCP は決して提案しないでください。GitHub には常に gh コマンドラインコマンドを使用します。

出力形式

調査結果は次のように提示します:

1. サマリーテーブル - 検出されたもの
2. 推奨 settings.json - そのままコピーできる完全な JSON
3. MCP の提案 - 該当する場合
4. マージ手順 - 既存の設定が見つかった場合

出力構造の例:

## Detected Tech Stack

| Category        | Found          |
| --------------- | -------------- |
| Languages       | Python 3.x     |
| Package Manager | poetry         |
| Frameworks      | Django, Celery |
| Services        | Sentry         |
| Build Tools     | Docker, Make   |

## Recommended .claude/settings.json

\`\`\`json
{
"permissions": {
"allow": [
// ... grouped by category with comments
],
"deny": []
}
}
\`\`\`

## Recommended .mcp.json (if applicable)

If you use Sentry or Linear, add the MCP config to `.mcp.json`...

重要なルール

含めるもの

• 状態を変更できない READ-ONLY コマンドのみ
• プロジェクトで実際に使用されているツールのみ (ロックファイルで検出)
• 標準的なシステムコマンド (ls、cat、find など)
• :* サフィックスは、ベースコマンドにあらゆる引数を許可します

決して含めてはいけないもの

• 絶対パス - /home/user/scripts/foo や /Users/name/bin/bar のようなユーザー固有のパスは決して含めないでください
• カスタムスクリプト - 副作用を持つ可能性のあるプロジェクトスクリプト (例: ./scripts/deploy.sh) は決して含めないでください
• 代替パッケージマネージャー - プロジェクトが pnpm を使用している場合、npm/yarn コマンドを含めないでください
• 状態を変更するコマンド - install、build、run、write、delete コマンドは含めないでください

パッケージマネージャーのルール

プロジェクトで実際に使用されているパッケージマネージャーのみを含めてください:

検出された場合	含める	含めない
pnpm-lock.yaml	pnpm コマンド	npm、yarn
yarn.lock	yarn コマンド	npm、pnpm
package-lock.json	npm コマンド	yarn、pnpm
poetry.lock	poetry コマンド	pip（requirements.txt も存在する場合を除く）
uv.lock	uv コマンド	pip、poetry
Pipfile.lock	pipenv コマンド	pip、poetry

複数のロックファイルが存在する場合は、検出された各マネージャーのコマンドのみを含めてください。

制限事項

• このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が欠けている場合は、停止して確認を求めてください。