用途：refactorkit 用于对已有代码库做结构性重构调研，回答“该在哪里重构、为什么”。它读取仓库的变更频率、模块形态和测试，找出结构代价所在，排序候选，最多推荐一个，并写成可评审的提案。可限定子树，如 /refactorkit src/payments。它只有一种流程，没有模式。
主要能力：只写一个 Markdown 文件，绝不改动源码，不做移动、重命名或提取。它关注四类摩擦模式：浅接口、适配器泛滥、未测试的耦合、局部性差。每个候选须通过两道门槛：删除测试（模块消失后复杂度是集中还是转移）和接口作为测试面（能否仅通过新接口测试行为）。强度分为 strong、moderate、weak，weak 永不被推荐。
使用方式：先读仓库的 CONTEXT.md 与 docs/adr/ 等既有约定；用 git log --format= --name-only --since=<约一年> 按变更频率排序并聚类；每个区域派一个子代理应用三种读码模式并自行过门槛，局部性差由主会话处理；汇总、去重、排序、推荐一个；先打印表格，再写文件到 docs/refactor/NNNN-refactor-<slug>-YYYY-MM-DD.md，含覆盖行、排序表、每个候选的问题、建议形态、为何更深、两道门槛结论与影响范围，推荐项至少配 Mermaid 前后对比图。
适用场景：想知道该重构哪里、代码难改、审计模块边界、接缝混乱时。
限制：不是代码审查、不是文档、不是视觉设计、不是决策记录。只读 shell，不安装或运行分析工具。无 git 历史则跳过排序并说明。无可写文件系统时以代码块打印。无子代理工具时改为内联扫描高变更文件。干净结果或全弱结果时不写文件，并明确说明。它只路由到后续工具，不自行调用。