claude-settings-audit

Claude Settings の監査

このリポジトリを分析し、読み取り専用コマンド用の推奨 Claude Code settings.json 権限を生成します。

フェーズ 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
ビルド	Makefile、Dockerfile、docker-compose.yml
インフラ	*.tf ファイル、kubernetes/、helm/
モノレポ	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:django-access-review)",
  "Skill(sentry-skills:django-perf-review)",
  "Skill(sentry-skills:doc-coauthoring)",
  "Skill(sentry-skills:document-api-endpoint)",
  "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-link-issue)",
  "Skill(sentry-skills:pr-screenshots)",
  "Skill(sentry-skills:pr-writer)",
  "Skill(sentry-skills:presentation-creator)",
  "Skill(sentry-skills:prompt-optimizer)",
  "Skill(sentry-skills:secret-serialization)",
  "Skill(sentry-skills:security-model)",
  "Skill(sentry-skills:security-review)",
  "Skill(sentry-skills:skill-scanner)",
  "Skill(sentry-skills:skill-writer)",
  "Skill(sentry-skills:sred-project-organizer)",
  "Skill(sentry-skills:sred-work-summary)",
  "Skill(sentry-skills:triage-frontend-issues)",
  "Skill(sentry-skills:typing-exclusion-worker)"
]

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

複数のロックファイルがある場合は、検出された各パッケージマネージャーのコマンドのみを記載してください。