indexion-identity

アイデンティティ監査のワークフロー

関数、ファイル、またはフォルダーの名前が、その内容と今も一致しているかを確認するときに、このスキルを使用します。

CLI は、ファイル、フォルダー、グラフレベルの宣言シンボルをスキャンします。すべてのローカル変数、パラメーター、フィールドを独立した命名対象として扱うわけではありません。ただし、これらはそれを含むファイルの要約に影響することがあります。ファイル名は親スコープを考慮して評価されます。宣言が多いファイルは、追加調査で実際の名前変更や分割が確認されるまでは、通常、根拠が乏しいものとして扱ってください。

パイプライン

1. 機械的なスキャンを実行します。

   indexion identity audit .
   

   機械可読なキューを取得するには、次を実行します。

   indexion identity audit --format=json --output=.indexion/cache/identity/report.json .
   

2. 各行はレビュー候補であり、確証ではないものとして扱います。次の項目を比較します。

   • name：アイデンティティパッケージが推定したスコープ付きの名前
   • expected_summary：パス、名前、スコープから予測される内容
   • actual_summary：グラフから得られた宣言、ドキュメント、モジュールの注記、パスの用語
   • assessment：実際のずれ、範囲が広すぎる内容、内容不足のいずれに該当するか
   • recommendation：確認のために最初に行う操作

3. 編集する前に確認します。

   indexion doc graph --format=text <path>
   indexion grep --semantic=name:<symbol> .
   rg "<name-or-term>" <path>
   

4. 確認できた中で最小限の操作を選びます。

   • insufficient-content は、命名のずれを示す証拠ではなく、根拠が不足している問題として扱います。 名前を変更する前に、そのファイルが意図的に宣言的で内容が薄いのか、グラフ抽出機能でサポートされていないのか、空なのか、ドキュメントや宣言の情報が不足しているのかを調べます。
   • 実装に一貫性があり、名前が古くなっている場合は、シンボルの名前を変更します。
   • 宣言に一貫性があり、ファイル名が古くなっている場合は、ファイル名を変更します。
   • 含まれるファイルが、より明確な親概念を共有している場合は、フォルダー名を変更します。
   • 現在のフォルダーより既存の別のフォルダーに適しているファイルは、移動します。
   • 候補から複数の主要な責務が明らかになった場合は、ファイルを分割します。

5. 変更後：

   moon info && moon fmt
   moon test
   indexion identity audit .
   

この監査は、レビューが必要な作業を明らかにするためのものです。機械的にスコアを最大化しようとせず、まず実際のコードの所有関係と参照先を確認してください。