Agent Skills
返回列表
💻

Indexion 代码库重构

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/trkbt10-indexion-skills-indexion-refactor。

技能介绍

要解决什么问题

多仓库、多包演进后,重复往往不只在「复制粘贴」:同一逻辑换名散落在不同模块、同一领域概念各自实现一套,改一处要动十几个文件。更隐蔽的是用 if is_special_case(x) { skip } 打补丁、opendir 类错误从本不该到达的路径冒出来——这类都是结构问题,而不是单点 bug。

本技能以 indexion 的 plan refactor、plan solid、plan unwrap 与 explore 为主线,把重复划分为 文本 / 结构 / 概念 三层,并按阶段清理,最后用 SoT(单一真相源) 规则验收:谁定义概念,谁才是唯一实现方。

技能如何工作

Phase 1 — plan refactor:从同文件 90%+ 相似函数等高价值目标入手,读输出中的 Similar Files、Duplicate Code Blocks、Function-Level Duplicates,把块级重复抽到 @common 或共享模块。清理后应保留的平台 stub、CLI @argparse 样板等属于 有意模式,不必硬并。

Phase 2 — plan solid:各目录内清完后再用 --from=dirA,dirB 找 跨包重叠,按建议抽出到新包,并用 indexion grep "TypeIdent:SharedType" 核对引用是否全改。

Phase 3 — plan unwrap:识别「函数体只是一次转发、无控制流」的壳函数;务必先 --dry-run,平台 FFI、对外 API 包装不要误删。

Phase 4–5 — 概念重复与 SoT:对 40%–60% 相似但无结构重复的 concept neighbors 追问「共享什么概念、谁拥有它」;按规则 一个概念、一个模块、一个函数,对外导出 try_* 式结果 API,而不是拆散的多步配料函数。

Phase 6–7:重跑同类 plan refactor 阈值验证相似度下降;再写 结构性测试 锁住 SoT 不变量,防止旧模式复发。

边界与注意点

  • plan refactor 与 plan solid 职责不同:前者是目录内归并,后者是跨目录抽取;应先各自 plan refactor 再 plan solid。
  • 「相似只是词汇」在 40%–60% 跨模块 TF-IDF 重叠时往往是 概念泄漏信号,不要一律.dismiss。
  • 红标:需要在上游修数据流时再在下游加 guard;同一修复散落多个 command 说明应进共享 pipeline,而不是每个命令各改一遍。

使用场景

  • 新增抽象层或 I/O 边界后,用 `plan refactor` 查清哪些文件与函数块在重复实现同一逻辑
  • 一次修 bug 改动了 3 个以上文件且原因相同,需要按三层重复定位该抽共享模块还是收拢 SoT
  • 多包之间要抽公共代码时,先各自清内重复,再 `plan solid --from=A,B` 找跨目录候选并核对引用
  • 重构收尾阶段用 `plan unwrap --dry-run` 筛掉无价值的转发函数,并做周期性 SoT 健康检查

适合人员

  • 维护多包 monorepo、经常要跨目录抽公共类型的平台工程师
  • 在 indexion/kgfs 工作流里负责 reconcile、plan、grep 的代码库工具维护者
  • 刚引入新文件格式或 API 层、需要避免概念在 vfs/discover/args 等多处各自实现的模块负责人
  • 擅长写约束型测试、希望用结构性用例防止「多步配料 API」与 guard 补丁复发的质量工程师