rule-auditor

ルール監査スキル

ルール監査 - エキスパートスキルに基づくコーディング規約とベストプラクティスに照らしてコードを検証します。規約違反を報告し、修正案を提示します。 - ベストプラクティスに照らしたコードの監査 - 違反やアンチパターンの特定 - 違反の修正案の提示 - コンプライアンスレポートの作成

ステップ 1: 適用可能なスキルを特定する

監査対象のコードに基づいて、関連するエキスパートスキルを見つけます。

ファイルの種類	エキスパートスキル
.ts、.tsx	typescript-expert, react-expert
.py	python-backend-expert
.go	go-expert
.java	java-expert
*.test.*	testing-expert

ステップ 2: ベストプラクティスを読み込む

関連するスキルファイルを読み、ベストプラクティスを把握します。

cat .claude/skills/[skill-name]/SKILL.md

確認すべき重要なルールとパターンを抽出します。

ステップ 3: 対象ファイルをスキャンする

対象ファイルを分析して、違反を確認します。

1. 対象ファイルを読む：Read ツールを使ってコードを調べます
2. パターンを確認する：スキルのガイドラインにあるアンチパターンを探します
3. 問題を特定する：ファイル、行、違反の種類を記録します

一般的な確認項目：

• 命名規則
• コード構造
• インポートのパターン
• 型安全性
• セキュリティ上の問題
• パフォーマンスに関するアンチパターン

ステップ 4: レポートを作成する

構造化されたコンプライアンスレポートを作成します。

## Audit Report

**Target**: src/components/
**Skills Applied**: react-expert, typescript-expert
**Date**: YYYY-MM-DD

### Summary

- **Pass**: 12 rules
- **Warn**: 3 rules
- **Fail**: 2 rules

### Violations

#### FAIL: Avoid using `any` type

- **File**: src/components/UserAuth.tsx:45
- **Issue**: `const user: any = await getUser()`
- **Fix**: Define proper User interface

#### WARN: Use Server Components by default

- **File**: src/components/UserAuth.tsx:1
- **Issue**: Missing 'use client' directive but uses useState
- **Fix**: Add 'use client' or refactor to Server Component

</execution_process>

<best_practices>

1. 早めに実施する：コミット直前だけでなく、開発中に監査します
2. 優先順位を付ける：重大度の高い違反から対処します
3. 具体的にする：ファイルパスと行番号を記載します
4. 修正案を提示する：実行可能な修正手順を示します
5. 問題を分類する：重大度とカテゴリーごとに整理します

</best_practices>

**監査の依頼**：

Audit src/components/ for TypeScript and React best practices

回答：

## Audit Report: src/components/

### Violations Found

1. **[ERROR]** src/components/User.tsx:23
   - Rule: Avoid `any` type
   - Code: `const data: any = response.json()`
   - Fix: `const data: UserResponse = response.json()`

2. **[WARN]** src/components/Form.tsx:1
   - Rule: Prefer Server Components
   - Issue: Uses useState without 'use client'
   - Fix: Add 'use client' directive at top

### Passed Checks

- Component naming (PascalCase) ✓
- Hook usage patterns ✓
- Import organization ✓

</usage_example>

ルール

• 必ず関連するエキスパートスキルを確認し、規約を把握します
• 行番号と具体的な修正案を提示します
• セキュリティと型安全性の問題を優先します

メモリプロトコル（必須）

開始前：

cat .claude/context/memory/learnings.md

完了後：

• 新しいパターン → .claude/context/memory/learnings.md
• 問題を発見した場合 → .claude/context/memory/issues.md
• 決定した内容 → .claude/context/memory/decisions.md

中断を想定してください：コンテキストがリセットされる可能性があります。メモリに記録されていないことは、実施されなかったものとします。