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 .
   

稽核的目的是呈現審查工作。請勿機械式地最大化分數；請先驗證實際的程式碼所有權與參考。