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 .
   

审计旨在发现审查工作。不要机械地最大化分数；首先验证实际的代码所有权和引用。