← ClaudeAtlas

codebase-auditlisted

コードベース全体を横断監査し、重大度・根拠ファイル・改善案を構造化する。技術負債や設計課題の包括的な洗い出しに使う。単一ファイルや PR のレビューには使わない。「技術負債を洗い出して」「横断的にレビュー」を正のトリガーとし、特定差分のセカンドオピニオンには reviewer skill を使う。
MasashiFukuzawa/agent-toolbox · ★ 0 · AI & Automation · score 70
Install: claude install-skill MasashiFukuzawa/agent-toolbox
# Codebase Audit Skill コードベースを A×B マトリックス(9技術領域 × 5評価軸)で包括的に監査し、構造化された改善提案レポートを生成する。 このスキルは汎用の正本であり、特定 repo の業務前提・セキュリティ境界・運用ルールを本体に埋め込まない。repo 固有の前提は対象 repo の `docs/agents/profile.md` から読み取り、監査時の Domain Lens と repo invariant として適用する。 --- ## Step 1: パラメータ収集 起動時に以下を確認する。すでに指定されているパラメータは再確認しない。 ```text コードベース監査を開始します。以下を教えてください。 1. 対象 repo のパス(複数可、カンマ区切り) 2. 追加分析領域(任意。なければ「なし」) 3. スキャン深度 - quick: 設定ファイル・設計文書・スキーマ・主要実装中心 - deep: quick + 全実装ファイル精読 ``` パラメータが揃ったら、破壊的操作なしで分析を開始する。 --- ## Step 2: Repo Context と Domain Lens の抽出 各 repo で次の順に探索する。標準 profile は `docs/agents/profile.md`。存在する場合は最優先で読み、Domain Lens、repo invariant、canonical verification path、secret/PII handling を抽出する。 1. `docs/agents/profile.md` 2. `AGENTS.md` 3. `DESIGN.md` または `docs/**/DESIGN.md` 4. ADR index: `docs/adr/README.md`, `docs/adrs/README.md`, `docs/adr/*.md`, `docs/adrs/*.md` 5. Guidelines / policies / runbooks: `docs/guidelines/`, `docs/policies/`, `docs/runbooks/` 6. Contracts / API / DB / tests: shared schemas, OpenAPI, DB schemas, migrations, policy files, representative tests `docs/agents/profile.md` がない場合は、警告を出して続行する。その場合、上記 2〜6 から暫定 Domain Lens を抽出し、レポートの `Assumptions` に「profile 不在のため暫定」と明記する。 読み取り時の注意: - `AGENTS.md` に Document Routing がある repo では、routing の制約を尊重する。ただし profile の有無を確認するための `docs/agents/profile.md` 読み取りは標準探索として扱う。 - secrets、tokens、cookies、storageState 内容、raw PII、機密原文、provider raw payload は読まない・出力しない。必要な場合でも existence、path、metadata、redaction policy の確認に留める。 - Domain Lens