inspect-role-naming について
inspect-role-naming は、コード上の名前がアーキテクチャ上の役割や責任を正しく表すかを調べる監査スキルです。対象コードを確認する開発者向けで、局所的な改名と構造的なリファクタリングを区別します。
主な機能
- 01リポジトリ規約または指定ルーブリックの適用
- 02アーキテクチャの誤表現や境界スキーマ漏出の検出
- 03指摘を [RENAME] と [REFACTOR] に分類
- 04局所変更と構造変更を適切なスキルへ振り分け
- 05分類された監査レポートの作成
活用シーン
- 01モジュール内の誤解を招く名前や役割の確認
- 02命名上の問題に構造抽出が必要かの判断
- 03優先度を整理した命名監査レポートの作成
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ venhdev/ zenforge --skill inspect-role-namingインストール後、Claude Code で/inspect-role-namingを入力して読み込まれたか確認します。
同梱ファイルreferences/role-naming-rubric.md
詳細
inspect-role-naming — アーキテクチャ上の役割と命名の監査者
ドメイン評価基準
1. 対象範囲と許容範囲のガードレール(無視する対象)
- 重大なリスクに限定する:危険なアーキテクチャ上の誤表現、実行時の衝突、境界スキーマの漏えいのみを対象とします。
- 問題のないコードは許容する:小規模なローカルヘルパー(メソッドが3つ未満)、内部変数の簡潔な命名、アクセサー内の問題のないメトリクスやログ出力、見た目だけのスタイルの違いは許容します。動作していて一貫性のあるコードに対して、リファクタリングを強制してはいけません。
- 判断の基準となる仕様:命名と役割の整合性は、
references/role-naming-rubric.md(またはホストリポジトリの正式な命名仕様。常にこちらが優先されます)に厳密に基づいて評価します。
2. 判断の区分:[RENAME] と [REFACTOR]
[RENAME](純粋な命名のずれ):基礎となる責務は単一かつ適切で、識別子や接尾辞のみがreferences/role-naming-rubric.mdからずれています。修正は局所的でリスクが低いものです。[REFACTOR](役割の偽装/責務の漏えい):シンボル名が複数の異なる責務を隠している、または誤った期待を抱かせています(例:外部 API を呼び出すリポジトリ)。名前を変更する前に、構造を切り出す必要があります。
標準出力契約
# Role & Naming Audit Dossier: <Target Scope>
## 1. Executive Summary
- **Target Inspected**: `<directory_or_file_path>`
- **Health Rating**: <PRISTINE | LOCALIZED_DRIFT | SYSTEMIC_DEBT>
- **Primary Bottleneck**: <Single-sentence summary of greatest role or boundary hazard>
## 2. Load-Bearing Defect Catalog
### [<CRITICAL | MAJOR>] [<RENAME | REFACTOR>] <Dimension>: `<Target Symbol>`
- **Offending Code**: [<file>#L<N>](file:///path/to/file#L<N>)
- **Violated Rubric**: [<spec_or_rubric>](references/role-naming-rubric.md#anchor)
- **Smell**: <Observable contract mismatch or dangerous collision>
- **Action**: <[RENAME] New Identifier OR [REFACTOR] Minimal Separation Path>
*(Emit 'No load-bearing role or naming defects observed' if clean)*
振り分け
- 単一ファイル内で完結する局所的なシンボル名の変更や、軽微な真偽値の整理 → (/simplify-audit 経由)。
- 複数ファイルにまたがるシンボルの移行や、役割の構造的な切り出し → (/changeset 経由)。
実行プロトコル
-
受け付けと仕様の確認:
- 対象パス(
directoryまたはfiles)を取り込みます。 - ホストリポジトリに命名規約がある場合はそれを確認します(プロジェクトの規約を優先します)。ない場合は
references/role-naming-rubric.mdを読み、適用します。
- 対象パス(
-
そのターン内での実践的な監査:
- 評価基準の各項目に照らし、対象コードをそのターン内で直接監査します。
- セクション1の許容範囲のガードレールを適用し、問題のない慣用表現、簡潔なローカル命名、動作するヘルパーは厳密に無視します。
- 指摘事項ごとに、修正方法を
[RENAME]または[REFACTOR]のいずれかに明示的に分類します。
-
統合とターン終了の判定:
- 指摘事項を標準出力契約にまとめます。
- 最終的な健全性評価(
PRISTINE、LOCALIZED_DRIFT、またはSYSTEMIC_DEBT)を決定します。 - 完成した報告書を会話に提示し、直ちにターンを終了します。
コメント
Markdown 対応