code-review
Claude + 静态代码分析自动审查。无需外部API。执行质量检查、安全验证和改进建议。
📖 中文导读:Claude + 静态代码分析自动审查。无需外部API。执行质量检查、安全验证和改进建议。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: code-review description: Claude + 静的解析による自動コードレビュー。外部API不要。品質チェック・セキュリティ検証・改善提案を実行 context: fork arguments:
- name: target description: レビュー対象(ファイルパス/PR番号/diff/ディレクトリ) required: true
- name: policy description: レビューポリシー(standard/strict/security) required: false default: "standard"
- name: fix description: 自動修正実行(true/false) required: false default: "false"
- name: dod description: DoD Level(bronze/silver/gold) required: false default: "silver" allowed-tools:
- Read
- Write
- Edit
- Glob
- Grep
- Bash(npm run lint:*)
- Bash(npx eslint:*)
- Bash(npx tsc:*)
- Bash(npm run typecheck:*)
- Bash(git diff:*)
- Bash(git log:*)
- Bash(gh pr view:*)
- Bash(grep:*)
- TodoWrite
/code-review - 自動コードレビュー(API不要版)
Claude + 静的解析ツールで、品質チェック・セキュリティ検証・改善提案を実行。 外部API呼び出しなし - Claude自身の分析能力と既存ツールで完結。
実行フロー
Step 1: 対象ファイル特定
# PR番号指定の場合
gh pr view {PR番号} --json files -q '.files[].path'
gh pr diff {PR番号}
# 変更ファイル一覧(ローカル)
git diff --name-only HEAD~1
# 特定ディレクトリ
Glob: src/**/*.{ts,tsx}
Step 2: 静的解析実行
# TypeScript型チェック
npx tsc --noEmit 2>&1
# ESLint
npx eslint {target} --format stylish 2>&1
# 複合チェック(package.jsonにスクリプトがある場合)
npm run lint 2>&1
npm run typecheck 2>&1
Step 3: セキュリティチェック
以下のパターンをGrepで検索:
# ハードコードされた認証情報
grep -rn "password\s*=" --include="*.ts" --include="*.tsx" {target}
grep -rn "api[_-]?key\s*=" --include="*.ts" --include="*.tsx" {target}
grep -rn "secret\s*=" --include="*.ts" --include="*.tsx" {target}
# eval使用(危険)
grep -rn "eval(" --include="*.ts" --include="*.tsx" {target}
# dangerouslySetInnerHTML(XSSリスク)
grep -rn "dangerouslySetInnerHTML" --include="*.tsx" {target}
# SQLインジェクションリスク
grep -rn "query\s*(" --include="*.ts" {target} | grep -v "prisma"
Step 4: Claude分析(コードを読んでレビュー)
対象ファイルを読み込み、以下の観点でレビュー:
品質観点
- 関数・変数の命名は明確か
- 単一責任の原則を守っているか
- 複雑度は適切か(ネストが深すぎないか)
- 重複コードはないか
- コメントは適切か(過不足なく)
TypeScript観点
-
any型を使用していないか - 型定義は適切か
- nullチェックは行われているか
- ジェネリクスが適切に使われているか
React観点(.tsx)
- useEffect の依存配列は正しいか
- useMemo/useCallback は適切に使われているか
- key propは一意か
- 不要な再レンダリングはないか
セキュリティ観点
- ユーザー入力のサニタイズ
- 認証・認可チェック
- シークレットの露出なし
- XSS対策
テスト観点
- 対応するテストファイルが存在するか
- エッジケースがカバーされているか
- モックが適切に使われているか
Step 5: レポート生成
## 🔍 コードレビューレポート
### サマリー
- **対象**: {target}
- **ポリシー**: {policy}
- **DoD Level**: {dod}
- **総合評価**: ✅ PASS / ⚠️ WARNING / ❌ FAIL
### 静的解析結果
| ツール | 結果 | 詳細 |
|-------|------|------|
| TypeScript | ✅ / ❌ | {errors} |
| ESLint | ✅ / ❌ | {warnings/errors} |
| Security Scan | ✅ / ❌ | {findings} |
### コードレビュー結果
| ファイル | 評価 | 主な指摘 |
|---------|------|---------|
| {file1} | ⭐⭐⭐⭐ | {comment} |
| {file2} | ⭐⭐⭐ | {comment} |
### 問題点
#### 🔴 Critical(修正必須)
- {issue1}
- 場所: `{file}:{line}`
- 修正案: {suggestion}
#### 🟡 Warning(推奨)
- {issue2}
- 場所: `{file}:{line}`
- 修正案: {suggestion}
#### 🟢 Info(参考)
- {issue3}
### セキュリティ
| チェック項目 | 結果 | 備考 |
|-------------|------|------|
| ハードコード認証情報 | ✅ / ❌ | {detail} |
| XSSリスク | ✅ / ❌ | {detail} |
| eval使用 | ✅ / ❌ | {detail} |
### 改善提案
1. **{suggestion1}**
```typescript
// Before
{before_code}
// After
{after_code}
追加すべきテスト
- {test1}
- {test2}
結論
{summary}
## ポリシー別チェック項目
### standard(デフォルト)
- 型エラーなし
- ESLintエラーなし
- 基本的なセキュリティチェック
### strict
- standard +
- ESLint警告もなし
- 複雑度チェック
- 命名規則チェック
- any禁止
### security
- standard +
- 全セキュリティパターン検索
- 依存関係の脆弱性チェック
- 認証・認可フローレビュー
## DoD Level別要件
| Level | 要件 |
|-------|------|
| bronze | 型エラー・ESLintエラーなし |
| silver | bronze + テストファイル存在・セキュリティOK |
| gold | silver + E2E・パフォーマンス・a11y |
## 使用例
ファイル指定
/code-review target=src/components/UserList.tsx
PR指定
/code-review target=#123
ディレクトリ指定(strictポリシー)
/code-review target=src/lib policy=strict
セキュリティ重視
/code-review target=src/app/api policy=security dod=gold
自動修正付き
/code-review target=src/components fix=true ```