研发协作
名称与内容漂移时:审计并规划已验证的重命名、移动…
需要检查函数、文件或文件夹名称是否仍与内容匹配时,用 `indexion identity audit` 生成审查候选,验证后做最小改动。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
名称与内容漂移时:审计并规划已验证的重命特定
解决思路
- 运行机械扫描:`indexion identity audit .`。
- 如需机器可读队列,运行:`indexion identity audit --format=json --output=.indexion/cache/identity/report.json .`。
- 理解扫描范围:CLI 扫描文件、文件夹和图级声明符号。
- 不要将每个局部变量、参数或字段当作独立命名目标;它们仍可能影响所在文件的摘要。
- 文件名按父作用域评估;声明较多的文件通常先视为证据不足,直到后续检查证明确实需要重命名或拆分。
- 将每一行视为审查候选,而不是证明。
- 比较 `name`:identity 包推断出的作用域名称。
- 比较 `expected_summary`:路径、名称、作用域预测出的内容。
- 比较 `actual_summary`:图派生的声明、文档、模块说明和路径词项。
- 比较 `assessment`:判断是实际漂移、内容过宽,还是内容不足。
- 比较 `recommendation`:首个需要验证的操作。
- 编辑前验证:`indexion doc graph --format=text <path>`。
- 编辑前验证:`indexion grep --semantic=name:<symbol> .`。
- 编辑前验证:`rg "<name-or-term>" <path>`。
- 选择最小且已确认的操作。
- 将 `insufficient-content` 视为证据问题,而不是命名漂移的证明。
- 重命名前检查文件是否故意为声明式/很薄、图提取器不支持、为空,或缺少文档/声明材料。
- 当实现内聚但符号名过时时,重命名符号。
- 当声明内聚但文件名过时时,重命名文件。
- 当所含文件共享更清晰的父概念时,重命名文件夹。
- 当文件更适合现有文件夹而不是当前文件夹时,移动文件。
- 当候选项显示多个主导职责时,拆分文件。
- 变更后运行:`moon info && moon fmt`。
- 变更后运行:`moon test`。
- 变更后运行:`indexion identity audit .`。
- 该审计用于暴露需要审查的工作;不要机械地最大化评分,先验证实际代码归属和引用。
适用边界 · 注意事项
- 不要把局部变量、参数或字段当作独立命名目标来审计;它们只会影响所在文件摘要。
- 不要仅凭 `insufficient-content` 或评分就断定需要重命名/拆分;必须先验证文件意图、归属和引用。
- 不要在未运行 `indexion doc graph`、`indexion grep`、`rg` 验证前直接编辑。