indexion-identity

标识审计工作流

检查函数、文件或文件夹名称是否仍与其内容相符时，请使用此技能。

CLI 会扫描文件、文件夹和图谱级声明符号。它不会将每个局部变量、参数或字段都视为独立的命名目标；这些内容仍可能影响其所属文件的摘要。文件名会结合父级作用域进行评估；对于声明较多的文件，在后续检查证明确实需要重命名或拆分之前，通常应将其视为证据不足。

流程

1. 运行机械扫描：

   indexion identity audit .
   

   若要获取机器可读的队列：

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

2. 将每一行视为待审查项，而非确凿证据。比较：

   • name：由 identity 包推断的带作用域名称
   • 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 .
   

此审计旨在找出需要审查的工作。不要机械地追求最高分；请先核实实际的代码归属和引用。