@bovinphang/frontend-craft 2.8.0 → 2.9.0

package/localized/zh-CN/skills/fec-refactoring-api/references/api-refactorings.md

@@ -0,0 +1,496 @@
+# API 类重构
+
+这些卡片以用户提供的标准重构目录为知识基线，转换为面向前端 Agent 的操作指南。保留标准 ID/中英文名称，框架适配和示例为项目原创内容。
+
+## RF-SEPARATE-QUERY-FROM-MODIFIER — 将查询函数和修改函数分离（Separate Query from Modifier）
+
+### 意图
+把“获取信息”和“修改状态”拆开，让读取不再隐式触发副作用。
+
+### 典型信号
+- 当前结构出现与本手法目标一致的重复、耦合、命名、职责、数据所有权或控制流问题，并有具体代码证据。
+
+### 不适用条件
+- 当前结构已经清晰，或该变换会制造更强耦合、隐藏依赖、破坏公共契约且没有兼容方案时，不使用。
+
+### 前置条件
+- 已明确当前可观察行为、受影响调用者和公共契约。
+- 目标位于声明的差异预算内，并且这个单一主要变换完成后能够立即验证。
+
+### 操作步骤
+1. 确认当前行为、调用者和边界，并锁定本步骤只处理这一项主要结构意图。
+2. 创建最小的新结构/位置/接口，让旧行为可以逐步迁移而不是一次性大改。
+3. 一次迁移一个调用点或职责片段，并保持兼容边界。
+4. 运行窄范围验证；若变红，先回滚本步骤，再缩小变换。
+
+### 行为保持检查点
+- 对比输入、输出、异常、副作用、执行顺序和公共契约。
+- 前端还要核对 UI 状态、事件、焦点、网络请求、生命周期/状态迁移，以及相关对象身份语义。
+
+### 相关坏味道
+- `SMELL-MUTABLE-DATA`
+
+### 常见组合
+- 不建立固定流水线；下一步必须重新依据证据选择。
+
+### JavaScript 注意事项
+- 保持回调 arity、`this`、默认值、异常和副作用时序。
+
+### TypeScript 注意事项
+- 导出函数签名、泛型、overload、DTO 和公共类型都属于兼容契约。
+
+### React 注意事项
+- Props/callback、Hook、loader/action、router 和 context API 可能是公共边界。
+
+### Vue 注意事项
+- props/emits、composable 返回、Pinia action、route contract 和 injection key 可能是公共边界。
+
+### Frontend-Craft 前端适配
+- 优先显式、可测试依赖；Command 只有在 undo/queue/retry/audit/复杂生命周期有价值时才值得引入。
+
+### 原创前端变换示例
+- 把“Separate Query from Modifier”应用到一个局部组件/Hook/Composable/Service 范围内，先记录行为契约，只迁移一个职责片段，并立即验证输出、事件与状态变化保持不变。
+
+## RF-PARAMETERIZE-FUNCTION — 函数参数化（Parameterize Function）
+
+### 意图
+把仅在某个显式值上不同的重复函数合成一个参数化函数。
+
+### 典型信号
+- 当前结构出现与本手法目标一致的重复、耦合、命名、职责、数据所有权或控制流问题，并有具体代码证据。
+
+### 不适用条件
+- 当前结构已经清晰，或该变换会制造更强耦合、隐藏依赖、破坏公共契约且没有兼容方案时，不使用。
+
+### 前置条件
+- 已明确当前可观察行为、受影响调用者和公共契约。
+- 目标位于声明的差异预算内，并且这个单一主要变换完成后能够立即验证。
+
+### 操作步骤
+1. 确认当前行为、调用者和边界，并锁定本步骤只处理这一项主要结构意图。
+2. 创建最小的新结构/位置/接口，让旧行为可以逐步迁移而不是一次性大改。
+3. 一次迁移一个调用点或职责片段，并保持兼容边界。
+4. 运行窄范围验证；若变红，先回滚本步骤，再缩小变换。
+
+### 行为保持检查点
+- 对比输入、输出、异常、副作用、执行顺序和公共契约。
+- 前端还要核对 UI 状态、事件、焦点、网络请求、生命周期/状态迁移，以及相关对象身份语义。
+
+### 相关坏味道
+- 不要求先存在某一种固定坏味道；以具体结构证据为准。
+
+### 常见组合
+- 不建立固定流水线；下一步必须重新依据证据选择。
+
+### JavaScript 注意事项
+- 保持回调 arity、`this`、默认值、异常和副作用时序。
+
+### TypeScript 注意事项
+- 导出函数签名、泛型、overload、DTO 和公共类型都属于兼容契约。
+
+### React 注意事项
+- Props/callback、Hook、loader/action、router 和 context API 可能是公共边界。
+
+### Vue 注意事项
+- props/emits、composable 返回、Pinia action、route contract 和 injection key 可能是公共边界。
+
+### Frontend-Craft 前端适配
+- 优先显式、可测试依赖；Command 只有在 undo/queue/retry/audit/复杂生命周期有价值时才值得引入。
+
+### 原创前端变换示例
+- 把“Parameterize Function”应用到一个局部组件/Hook/Composable/Service 范围内，先记录行为契约，只迁移一个职责片段，并立即验证输出、事件与状态变化保持不变。
+
+## RF-REMOVE-FLAG-ARGUMENT — 移除标记参数（Remove Flag Argument）
+
+### 意图
+把用于选择行为的 flag 参数替换为意图明确的操作；普通领域 boolean 不属于行为 flag。
+
+### 典型信号
+- boolean/enum 参数并非普通数据，而是在指挥函数选择不同业务行为。
+
+### 不适用条件
+- 参数只是领域数据，而不是选择函数行为的控制指令时，不应机械拆 API。
+
+### 前置条件
+- 已明确当前可观察行为、受影响调用者和公共契约。
+- 目标位于声明的差异预算内，并且这个单一主要变换完成后能够立即验证。
+
+### 操作步骤
+1. 确认当前行为、调用者和边界，并锁定本步骤只处理这一项主要结构意图。
+2. 创建最小的新结构/位置/接口，让旧行为可以逐步迁移而不是一次性大改。
+3. 一次迁移一个调用点或职责片段，并保持兼容边界。
+4. 运行窄范围验证；若变红，先回滚本步骤，再缩小变换。
+
+### 行为保持检查点
+- 对比输入、输出、异常、副作用、执行顺序和公共契约。
+- 前端还要核对 UI 状态、事件、焦点、网络请求、生命周期/状态迁移，以及相关对象身份语义。
+
+### 相关坏味道
+- `SMELL-LONG-PARAMETER-LIST`
+
+### 常见组合
+- 不建立固定流水线；下一步必须重新依据证据选择。
+
+### JavaScript 注意事项
+- 保持回调 arity、`this`、默认值、异常和副作用时序。
+
+### TypeScript 注意事项
+- 导出函数签名、泛型、overload、DTO 和公共类型都属于兼容契约。
+
+### React 注意事项
+- Props/callback、Hook、loader/action、router 和 context API 可能是公共边界。
+
+### Vue 注意事项
+- props/emits、composable 返回、Pinia action、route contract 和 injection key 可能是公共边界。
+
+### Frontend-Craft 前端适配
+- 优先显式、可测试依赖；Command 只有在 undo/queue/retry/audit/复杂生命周期有价值时才值得引入。
+
+### 原创前端变换示例
+- 把“Remove Flag Argument”应用到一个局部组件/Hook/Composable/Service 范围内，先记录行为契约，只迁移一个职责片段，并立即验证输出、事件与状态变化保持不变。
+
+## RF-PRESERVE-WHOLE-OBJECT — 保持对象完整（Preserve Whole Object）
+
+### 意图
+当多个参数本就来自同一对象时，传递对象或窄接口，而不是先拆字段再传入。
+
+### 典型信号
+- 当前结构出现与本手法目标一致的重复、耦合、命名、职责、数据所有权或控制流问题，并有具体代码证据。
+
+### 不适用条件
+- 当前结构已经清晰，或该变换会制造更强耦合、隐藏依赖、破坏公共契约且没有兼容方案时，不使用。
+
+### 前置条件
+- 已明确当前可观察行为、受影响调用者和公共契约。
+- 目标位于声明的差异预算内，并且这个单一主要变换完成后能够立即验证。
+
+### 操作步骤
+1. 确认当前行为、调用者和边界，并锁定本步骤只处理这一项主要结构意图。
+2. 创建最小的新结构/位置/接口，让旧行为可以逐步迁移而不是一次性大改。
+3. 一次迁移一个调用点或职责片段，并保持兼容边界。
+4. 运行窄范围验证；若变红，先回滚本步骤，再缩小变换。
+
+### 行为保持检查点
+- 对比输入、输出、异常、副作用、执行顺序和公共契约。
+- 前端还要核对 UI 状态、事件、焦点、网络请求、生命周期/状态迁移，以及相关对象身份语义。
+
+### 相关坏味道
+- `SMELL-LONG-FUNCTION`
+- `SMELL-LONG-PARAMETER-LIST`
+- `SMELL-DATA-CLUMPS`
+
+### 常见组合
+- 不建立固定流水线；下一步必须重新依据证据选择。
+
+### JavaScript 注意事项
+- 保持回调 arity、`this`、默认值、异常和副作用时序。
+
+### TypeScript 注意事项
+- 导出函数签名、泛型、overload、DTO 和公共类型都属于兼容契约。
+
+### React 注意事项
+- Props/callback、Hook、loader/action、router 和 context API 可能是公共边界。
+
+### Vue 注意事项
+- props/emits、composable 返回、Pinia action、route contract 和 injection key 可能是公共边界。
+
+### Frontend-Craft 前端适配
+- 优先显式、可测试依赖；Command 只有在 undo/queue/retry/audit/复杂生命周期有价值时才值得引入。
+
+### 原创前端变换示例
+- 把“Preserve Whole Object”应用到一个局部组件/Hook/Composable/Service 范围内，先记录行为契约，只迁移一个职责片段，并立即验证输出、事件与状态变化保持不变。
+
+## RF-REPLACE-PARAMETER-WITH-QUERY — 以查询取代参数（Replace Parameter with Query）
+
+### 意图
+当函数可以从恰当且稳定的来源获得同一值时，去掉冗余参数。
+
+### 典型信号
+- 当前结构出现与本手法目标一致的重复、耦合、命名、职责、数据所有权或控制流问题，并有具体代码证据。
+
+### 不适用条件
+- 当前结构已经清晰，或该变换会制造更强耦合、隐藏依赖、破坏公共契约且没有兼容方案时，不使用。
+
+### 前置条件
+- 已明确当前可观察行为、受影响调用者和公共契约。
+- 目标位于声明的差异预算内，并且这个单一主要变换完成后能够立即验证。
+
+### 操作步骤
+1. 确认当前行为、调用者和边界，并锁定本步骤只处理这一项主要结构意图。
+2. 创建最小的新结构/位置/接口，让旧行为可以逐步迁移而不是一次性大改。
+3. 一次迁移一个调用点或职责片段，并保持兼容边界。
+4. 运行窄范围验证；若变红，先回滚本步骤，再缩小变换。
+
+### 行为保持检查点
+- 对比输入、输出、异常、副作用、执行顺序和公共契约。
+- 前端还要核对 UI 状态、事件、焦点、网络请求、生命周期/状态迁移，以及相关对象身份语义。
+
+### 相关坏味道
+- `SMELL-LONG-PARAMETER-LIST`
+
+### 常见组合
+- 不建立固定流水线；下一步必须重新依据证据选择。
+
+### JavaScript 注意事项
+- 保持回调 arity、`this`、默认值、异常和副作用时序。
+
+### TypeScript 注意事项
+- 导出函数签名、泛型、overload、DTO 和公共类型都属于兼容契约。
+
+### React 注意事项
+- Props/callback、Hook、loader/action、router 和 context API 可能是公共边界。
+
+### Vue 注意事项
+- props/emits、composable 返回、Pinia action、route contract 和 injection key 可能是公共边界。
+
+### Frontend-Craft 前端适配
+- 优先显式、可测试依赖；Command 只有在 undo/queue/retry/audit/复杂生命周期有价值时才值得引入。
+
+### 原创前端变换示例
+- 把“Replace Parameter with Query”应用到一个局部组件/Hook/Composable/Service 范围内，先记录行为契约，只迁移一个职责片段，并立即验证输出、事件与状态变化保持不变。
+
+## RF-REPLACE-QUERY-WITH-PARAMETER — 以参数取代查询（Replace Query with Parameter）
+
+### 意图
+把隐藏查询依赖变为显式参数，提高纯度、可复用性和可测试性。
+
+### 典型信号
+- 当前结构出现与本手法目标一致的重复、耦合、命名、职责、数据所有权或控制流问题，并有具体代码证据。
+
+### 不适用条件
+- 当前结构已经清晰，或该变换会制造更强耦合、隐藏依赖、破坏公共契约且没有兼容方案时，不使用。
+
+### 前置条件
+- 已明确当前可观察行为、受影响调用者和公共契约。
+- 目标位于声明的差异预算内，并且这个单一主要变换完成后能够立即验证。
+
+### 操作步骤
+1. 确认当前行为、调用者和边界，并锁定本步骤只处理这一项主要结构意图。
+2. 创建最小的新结构/位置/接口，让旧行为可以逐步迁移而不是一次性大改。
+3. 一次迁移一个调用点或职责片段，并保持兼容边界。
+4. 运行窄范围验证；若变红，先回滚本步骤，再缩小变换。
+
+### 行为保持检查点
+- 对比输入、输出、异常、副作用、执行顺序和公共契约。
+- 前端还要核对 UI 状态、事件、焦点、网络请求、生命周期/状态迁移，以及相关对象身份语义。
+
+### 相关坏味道
+- 不要求先存在某一种固定坏味道；以具体结构证据为准。
+
+### 常见组合
+- 不建立固定流水线；下一步必须重新依据证据选择。
+
+### JavaScript 注意事项
+- 保持回调 arity、`this`、默认值、异常和副作用时序。
+
+### TypeScript 注意事项
+- 导出函数签名、泛型、overload、DTO 和公共类型都属于兼容契约。
+
+### React 注意事项
+- Props/callback、Hook、loader/action、router 和 context API 可能是公共边界。
+
+### Vue 注意事项
+- props/emits、composable 返回、Pinia action、route contract 和 injection key 可能是公共边界。
+
+### Frontend-Craft 前端适配
+- 优先显式、可测试依赖；Command 只有在 undo/queue/retry/audit/复杂生命周期有价值时才值得引入。
+
+### 原创前端变换示例
+- 把“Replace Query with Parameter”应用到一个局部组件/Hook/Composable/Service 范围内，先记录行为契约，只迁移一个职责片段，并立即验证输出、事件与状态变化保持不变。
+
+## RF-REMOVE-SETTING-METHOD — 移除设值函数（Remove Setting Method）
+
+### 意图
+对于创建后不应再改变的状态，移除 setter 并把初始化放到构造/工厂阶段。
+
+### 典型信号
+- 当前结构出现与本手法目标一致的重复、耦合、命名、职责、数据所有权或控制流问题，并有具体代码证据。
+
+### 不适用条件
+- 当前结构已经清晰，或该变换会制造更强耦合、隐藏依赖、破坏公共契约且没有兼容方案时，不使用。
+
+### 前置条件
+- 已明确当前可观察行为、受影响调用者和公共契约。
+- 目标位于声明的差异预算内，并且这个单一主要变换完成后能够立即验证。
+
+### 操作步骤
+1. 确认当前行为、调用者和边界，并锁定本步骤只处理这一项主要结构意图。
+2. 创建最小的新结构/位置/接口，让旧行为可以逐步迁移而不是一次性大改。
+3. 一次迁移一个调用点或职责片段，并保持兼容边界。
+4. 运行窄范围验证；若变红，先回滚本步骤，再缩小变换。
+
+### 行为保持检查点
+- 对比输入、输出、异常、副作用、执行顺序和公共契约。
+- 前端还要核对 UI 状态、事件、焦点、网络请求、生命周期/状态迁移，以及相关对象身份语义。
+
+### 相关坏味道
+- `SMELL-MUTABLE-DATA`
+- `SMELL-DATA-CLASS`
+
+### 常见组合
+- 不建立固定流水线；下一步必须重新依据证据选择。
+
+### JavaScript 注意事项
+- 保持回调 arity、`this`、默认值、异常和副作用时序。
+
+### TypeScript 注意事项
+- 导出函数签名、泛型、overload、DTO 和公共类型都属于兼容契约。
+
+### React 注意事项
+- Props/callback、Hook、loader/action、router 和 context API 可能是公共边界。
+
+### Vue 注意事项
+- props/emits、composable 返回、Pinia action、route contract 和 injection key 可能是公共边界。
+
+### Frontend-Craft 前端适配
+- 优先显式、可测试依赖；Command 只有在 undo/queue/retry/audit/复杂生命周期有价值时才值得引入。
+
+### 原创前端变换示例
+- 把“Remove Setting Method”应用到一个局部组件/Hook/Composable/Service 范围内，先记录行为契约，只迁移一个职责片段，并立即验证输出、事件与状态变化保持不变。
+
+## RF-REPLACE-CONSTRUCTOR-WITH-FACTORY-FUNCTION — 以工厂函数取代构造函数（Replace Constructor with Factory Function）
+
+### 意图
+当创建过程包含选择、规范化、缓存或需要更明确名称时，用工厂函数表达创建策略。
+
+### 典型信号
+- 当前结构出现与本手法目标一致的重复、耦合、命名、职责、数据所有权或控制流问题，并有具体代码证据。
+
+### 不适用条件
+- 当前结构已经清晰，或该变换会制造更强耦合、隐藏依赖、破坏公共契约且没有兼容方案时，不使用。
+
+### 前置条件
+- 已明确当前可观察行为、受影响调用者和公共契约。
+- 目标位于声明的差异预算内，并且这个单一主要变换完成后能够立即验证。
+
+### 操作步骤
+1. 确认当前行为、调用者和边界，并锁定本步骤只处理这一项主要结构意图。
+2. 创建最小的新结构/位置/接口，让旧行为可以逐步迁移而不是一次性大改。
+3. 一次迁移一个调用点或职责片段，并保持兼容边界。
+4. 运行窄范围验证；若变红，先回滚本步骤，再缩小变换。
+
+### 行为保持检查点
+- 对比输入、输出、异常、副作用、执行顺序和公共契约。
+- 前端还要核对 UI 状态、事件、焦点、网络请求、生命周期/状态迁移，以及相关对象身份语义。
+
+### 相关坏味道
+- 不要求先存在某一种固定坏味道；以具体结构证据为准。
+
+### 常见组合
+- 不建立固定流水线；下一步必须重新依据证据选择。
+
+### JavaScript 注意事项
+- 保持回调 arity、`this`、默认值、异常和副作用时序。
+
+### TypeScript 注意事项
+- 导出函数签名、泛型、overload、DTO 和公共类型都属于兼容契约。
+
+### React 注意事项
+- Props/callback、Hook、loader/action、router 和 context API 可能是公共边界。
+
+### Vue 注意事项
+- props/emits、composable 返回、Pinia action、route contract 和 injection key 可能是公共边界。
+
+### Frontend-Craft 前端适配
+- 优先显式、可测试依赖；Command 只有在 undo/queue/retry/audit/复杂生命周期有价值时才值得引入。
+
+### 原创前端变换示例
+- 把“Replace Constructor with Factory Function”应用到一个局部组件/Hook/Composable/Service 范围内，先记录行为契约，只迁移一个职责片段，并立即验证输出、事件与状态变化保持不变。
+
+## RF-REPLACE-FUNCTION-WITH-COMMAND — 以命令取代函数（Replace Function with Command）
+
+### 意图
+只有当操作确实需要状态、undo、queue、retry、audit 或复杂生命周期时，才把函数提升为命令/执行上下文。
+
+### 典型信号
+- 一个操作确实需要持有跨步骤状态，或需要 undo、queue、retry、audit、取消/进度等生命周期。
+
+### 不适用条件
+- 简单纯函数没有状态或生命周期价值时，不引入命令对象。
+
+### 前置条件
+- 已明确当前可观察行为、受影响调用者和公共契约。
+- 目标位于声明的差异预算内，并且这个单一主要变换完成后能够立即验证。
+
+### 操作步骤
+1. 确认当前行为、调用者和边界，并锁定本步骤只处理这一项主要结构意图。
+2. 创建最小的新结构/位置/接口，让旧行为可以逐步迁移而不是一次性大改。
+3. 一次迁移一个调用点或职责片段，并保持兼容边界。
+4. 运行窄范围验证；若变红，先回滚本步骤，再缩小变换。
+
+### 行为保持检查点
+- 对比输入、输出、异常、副作用、执行顺序和公共契约。
+- 前端还要核对 UI 状态、事件、焦点、网络请求、生命周期/状态迁移，以及相关对象身份语义。
+
+### 相关坏味道
+- `SMELL-LONG-FUNCTION`
+
+### 常见组合
+- 不建立固定流水线；下一步必须重新依据证据选择。
+
+### JavaScript 注意事项
+- 保持回调 arity、`this`、默认值、异常和副作用时序。
+
+### TypeScript 注意事项
+- 导出函数签名、泛型、overload、DTO 和公共类型都属于兼容契约。
+
+### React 注意事项
+- Props/callback、Hook、loader/action、router 和 context API 可能是公共边界。
+
+### Vue 注意事项
+- props/emits、composable 返回、Pinia action、route contract 和 injection key 可能是公共边界。
+
+### Frontend-Craft 前端适配
+- 优先显式、可测试依赖；Command 只有在 undo/queue/retry/audit/复杂生命周期有价值时才值得引入。
+
+### 原创前端变换示例
+- 复杂上传流程包含 retry、progress、cancel、audit 时，可由上传命令/会话对象持有生命周期状态。
+
+## RF-REPLACE-COMMAND-WITH-FUNCTION — 以函数取代命令（Replace Command with Function）
+
+### 意图
+当命令对象已经没有值得保留的状态或生命周期时，将其收敛为普通函数。
+
+### 典型信号
+- 当前结构出现与本手法目标一致的重复、耦合、命名、职责、数据所有权或控制流问题，并有具体代码证据。
+
+### 不适用条件
+- 当前结构已经清晰，或该变换会制造更强耦合、隐藏依赖、破坏公共契约且没有兼容方案时，不使用。
+
+### 前置条件
+- 已明确当前可观察行为、受影响调用者和公共契约。
+- 目标位于声明的差异预算内，并且这个单一主要变换完成后能够立即验证。
+
+### 操作步骤
+1. 确认当前行为、调用者和边界，并锁定本步骤只处理这一项主要结构意图。
+2. 创建最小的新结构/位置/接口，让旧行为可以逐步迁移而不是一次性大改。
+3. 一次迁移一个调用点或职责片段，并保持兼容边界。
+4. 运行窄范围验证；若变红，先回滚本步骤，再缩小变换。
+
+### 行为保持检查点
+- 对比输入、输出、异常、副作用、执行顺序和公共契约。
+- 前端还要核对 UI 状态、事件、焦点、网络请求、生命周期/状态迁移，以及相关对象身份语义。
+
+### 相关坏味道
+- 不要求先存在某一种固定坏味道；以具体结构证据为准。
+
+### 常见组合
+- 不建立固定流水线；下一步必须重新依据证据选择。
+
+### JavaScript 注意事项
+- 保持回调 arity、`this`、默认值、异常和副作用时序。
+
+### TypeScript 注意事项
+- 导出函数签名、泛型、overload、DTO 和公共类型都属于兼容契约。
+
+### React 注意事项
+- Props/callback、Hook、loader/action、router 和 context API 可能是公共边界。
+
+### Vue 注意事项
+- props/emits、composable 返回、Pinia action、route contract 和 injection key 可能是公共边界。
+
+### Frontend-Craft 前端适配
+- 优先显式、可测试依赖；Command 只有在 undo/queue/retry/audit/复杂生命周期有价值时才值得引入。
+
+### 原创前端变换示例
+- 把“Replace Command with Function”应用到一个局部组件/Hook/Composable/Service 范围内，先记录行为契约，只迁移一个职责片段，并立即验证输出、事件与状态变化保持不变。

package/localized/zh-CN/skills/fec-refactoring-catalog/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: fec-refactoring-catalog
+description: 已经有结构问题证据，需要在多种保持行为的重构手法之间比较前置条件、选择最小安全方案，或决定多个重构步骤的合理先后关系时。
+---
+
+# 重构目录选择
+
+## 概览
+把完整重构目录作为决策辅助，而不是自动套用的配方。只有当证据、前置条件和行为契约匹配时，才选择最小可验证的手法。
+
+## 工作流
+1. 在[重构目录索引](references/catalog-index.md)定位标准手法。
+2. 若从坏味道或症状出发，使用[选择指南](references/selection-guide.md)比较成因和候选手法。
+3. 若需要多个步骤，使用[组合指南](references/composition-guide.md)只安排当前代码真正需要的前置关系。
+4. 确定手法后再按需加载对应 family 的详细资料。
+
+## 选择规则
+- 一个坏味道可能对应多个候选，先确认真实成因。
+- 优先可回滚、局部、小范围的变换，而不是直接大改架构。
+- 执行前检查公共 API、路由、状态所有权、异步/生命周期、持久化和 SSR 边界。
+- 组合关系都是有条件的，不是强制流水线。

package/localized/zh-CN/skills/fec-refactoring-catalog/references/catalog-index.md

@@ -0,0 +1,99 @@
+# 重构目录索引
+
+以下 61 个稳定 ID 对应用户资料第 6～12 章的完整重构目录。详细机制放在各 family Reference 中，按需加载。
+
+## Functions — 11
+
+| ID | 中文标准名 | English | Family | Detail |
+| --- | --- | --- | --- | --- |
+| `RF-EXTRACT-FUNCTION` | 提炼函数 | Extract Function | `functions` | [Detail](../../fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-INLINE-FUNCTION` | 内联函数 | Inline Function | `functions` | [Detail](../../fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-EXTRACT-VARIABLE` | 提炼变量 | Extract Variable | `functions` | [Detail](../../fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-INLINE-VARIABLE` | 内联变量 | Inline Variable | `functions` | [Detail](../../fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-CHANGE-FUNCTION-DECLARATION` | 改变函数声明 | Change Function Declaration | `functions` | [Detail](../../fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-ENCAPSULATE-VARIABLE` | 封装变量 | Encapsulate Variable | `functions` | [Detail](../../fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-RENAME-VARIABLE` | 变量改名 | Rename Variable | `functions` | [Detail](../../fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-INTRODUCE-PARAMETER-OBJECT` | 引入参数对象 | Introduce Parameter Object | `functions` | [Detail](../../fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-COMBINE-FUNCTIONS-INTO-CLASS` | 函数组合成类 | Combine Functions into Class | `functions` | [Detail](../../fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-COMBINE-FUNCTIONS-INTO-TRANSFORM` | 函数组合成变换 | Combine Functions into Transform | `functions` | [Detail](../../fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-SPLIT-PHASE` | 拆分阶段 | Split Phase | `functions` | [Detail](../../fec-refactoring-functions/references/function-refactorings.md) |
+
+## Encapsulation — 9
+
+| ID | 中文标准名 | English | Family | Detail |
+| --- | --- | --- | --- | --- |
+| `RF-ENCAPSULATE-RECORD` | 封装记录 | Encapsulate Record | `encapsulation` | [Detail](../../fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-ENCAPSULATE-COLLECTION` | 封装集合 | Encapsulate Collection | `encapsulation` | [Detail](../../fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-REPLACE-PRIMITIVE-WITH-OBJECT` | 以对象取代基本类型 | Replace Primitive with Object | `encapsulation` | [Detail](../../fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-REPLACE-TEMP-WITH-QUERY` | 以查询取代临时变量 | Replace Temp with Query | `encapsulation` | [Detail](../../fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-EXTRACT-CLASS` | 提炼类 | Extract Class | `encapsulation` | [Detail](../../fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-INLINE-CLASS` | 内联类 | Inline Class | `encapsulation` | [Detail](../../fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-HIDE-DELEGATE` | 隐藏委托关系 | Hide Delegate | `encapsulation` | [Detail](../../fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-REMOVE-MIDDLE-MAN` | 移除中间人 | Remove Middle Man | `encapsulation` | [Detail](../../fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-SUBSTITUTE-ALGORITHM` | 替换算法 | Substitute Algorithm | `encapsulation` | [Detail](../../fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+
+## Moving Features — 9
+
+| ID | 中文标准名 | English | Family | Detail |
+| --- | --- | --- | --- | --- |
+| `RF-MOVE-FUNCTION` | 搬移函数 | Move Function | `move-features` | [Detail](../../fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-MOVE-FIELD` | 搬移字段 | Move Field | `move-features` | [Detail](../../fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-MOVE-STATEMENTS-INTO-FUNCTION` | 搬移语句到函数 | Move Statements into Function | `move-features` | [Detail](../../fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-MOVE-STATEMENTS-TO-CALLERS` | 搬移语句到调用者 | Move Statements to Callers | `move-features` | [Detail](../../fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-REPLACE-INLINE-CODE-WITH-FUNCTION-CALL` | 以函数调用取代内联代码 | Replace Inline Code with Function Call | `move-features` | [Detail](../../fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-SLIDE-STATEMENTS` | 移动语句 | Slide Statements | `move-features` | [Detail](../../fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-SPLIT-LOOP` | 拆分循环 | Split Loop | `move-features` | [Detail](../../fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-REPLACE-LOOP-WITH-PIPELINE` | 以管道取代循环 | Replace Loop with Pipeline | `move-features` | [Detail](../../fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-REMOVE-DEAD-CODE` | 移除死代码 | Remove Dead Code | `move-features` | [Detail](../../fec-refactoring-move-features/references/moving-refactorings.md) |
+
+## Data — 5
+
+| ID | 中文标准名 | English | Family | Detail |
+| --- | --- | --- | --- | --- |
+| `RF-SPLIT-VARIABLE` | 拆分变量 | Split Variable | `data` | [Detail](../../fec-refactoring-data/references/data-refactorings.md) |
+| `RF-RENAME-FIELD` | 字段改名 | Rename Field | `data` | [Detail](../../fec-refactoring-data/references/data-refactorings.md) |
+| `RF-REPLACE-DERIVED-VARIABLE-WITH-QUERY` | 以查询取代派生变量 | Replace Derived Variable with Query | `data` | [Detail](../../fec-refactoring-data/references/data-refactorings.md) |
+| `RF-CHANGE-REFERENCE-TO-VALUE` | 将引用对象改为值对象 | Change Reference to Value | `data` | [Detail](../../fec-refactoring-data/references/data-refactorings.md) |
+| `RF-CHANGE-VALUE-TO-REFERENCE` | 将值对象改为引用对象 | Change Value to Reference | `data` | [Detail](../../fec-refactoring-data/references/data-refactorings.md) |
+
+## Conditional Logic — 6
+
+| ID | 中文标准名 | English | Family | Detail |
+| --- | --- | --- | --- | --- |
+| `RF-DECOMPOSE-CONDITIONAL` | 分解条件表达式 | Decompose Conditional | `control` | [Detail](../../fec-refactoring-control/references/conditional-refactorings.md) |
+| `RF-CONSOLIDATE-CONDITIONAL-EXPRESSION` | 合并条件表达式 | Consolidate Conditional Expression | `control` | [Detail](../../fec-refactoring-control/references/conditional-refactorings.md) |
+| `RF-REPLACE-NESTED-CONDITIONAL-WITH-GUARD-CLAUSES` | 以卫语句取代嵌套条件表达式 | Replace Nested Conditional with Guard Clauses | `control` | [Detail](../../fec-refactoring-control/references/conditional-refactorings.md) |
+| `RF-REPLACE-CONDITIONAL-WITH-POLYMORPHISM` | 以多态取代条件表达式 | Replace Conditional with Polymorphism | `control` | [Detail](../../fec-refactoring-control/references/conditional-refactorings.md) |
+| `RF-INTRODUCE-SPECIAL-CASE` | 引入特例 | Introduce Special Case | `control` | [Detail](../../fec-refactoring-control/references/conditional-refactorings.md) |
+| `RF-INTRODUCE-ASSERTION` | 引入断言 | Introduce Assertion | `control` | [Detail](../../fec-refactoring-control/references/conditional-refactorings.md) |
+
+## API — 10
+
+| ID | 中文标准名 | English | Family | Detail |
+| --- | --- | --- | --- | --- |
+| `RF-SEPARATE-QUERY-FROM-MODIFIER` | 将查询函数和修改函数分离 | Separate Query from Modifier | `api` | [Detail](../../fec-refactoring-api/references/api-refactorings.md) |
+| `RF-PARAMETERIZE-FUNCTION` | 函数参数化 | Parameterize Function | `api` | [Detail](../../fec-refactoring-api/references/api-refactorings.md) |
+| `RF-REMOVE-FLAG-ARGUMENT` | 移除标记参数 | Remove Flag Argument | `api` | [Detail](../../fec-refactoring-api/references/api-refactorings.md) |
+| `RF-PRESERVE-WHOLE-OBJECT` | 保持对象完整 | Preserve Whole Object | `api` | [Detail](../../fec-refactoring-api/references/api-refactorings.md) |
+| `RF-REPLACE-PARAMETER-WITH-QUERY` | 以查询取代参数 | Replace Parameter with Query | `api` | [Detail](../../fec-refactoring-api/references/api-refactorings.md) |
+| `RF-REPLACE-QUERY-WITH-PARAMETER` | 以参数取代查询 | Replace Query with Parameter | `api` | [Detail](../../fec-refactoring-api/references/api-refactorings.md) |
+| `RF-REMOVE-SETTING-METHOD` | 移除设值函数 | Remove Setting Method | `api` | [Detail](../../fec-refactoring-api/references/api-refactorings.md) |
+| `RF-REPLACE-CONSTRUCTOR-WITH-FACTORY-FUNCTION` | 以工厂函数取代构造函数 | Replace Constructor with Factory Function | `api` | [Detail](../../fec-refactoring-api/references/api-refactorings.md) |
+| `RF-REPLACE-FUNCTION-WITH-COMMAND` | 以命令取代函数 | Replace Function with Command | `api` | [Detail](../../fec-refactoring-api/references/api-refactorings.md) |
+| `RF-REPLACE-COMMAND-WITH-FUNCTION` | 以函数取代命令 | Replace Command with Function | `api` | [Detail](../../fec-refactoring-api/references/api-refactorings.md) |
+
+## Inheritance — 11
+
+| ID | 中文标准名 | English | Family | Detail |
+| --- | --- | --- | --- | --- |
+| `RF-PULL-UP-METHOD` | 函数上移 | Pull Up Method | `inheritance` | [Detail](../../fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-PULL-UP-FIELD` | 字段上移 | Pull Up Field | `inheritance` | [Detail](../../fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-PULL-UP-CONSTRUCTOR-BODY` | 构造函数本体上移 | Pull Up Constructor Body | `inheritance` | [Detail](../../fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-PUSH-DOWN-METHOD` | 函数下移 | Push Down Method | `inheritance` | [Detail](../../fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-PUSH-DOWN-FIELD` | 字段下移 | Push Down Field | `inheritance` | [Detail](../../fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-REPLACE-TYPE-CODE-WITH-SUBCLASSES` | 以子类取代类型码 | Replace Type Code with Subclasses | `inheritance` | [Detail](../../fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-REMOVE-SUBCLASS` | 移除子类 | Remove Subclass | `inheritance` | [Detail](../../fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-EXTRACT-SUPERCLASS` | 提炼超类 | Extract Superclass | `inheritance` | [Detail](../../fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-COLLAPSE-HIERARCHY` | 折叠继承体系 | Collapse Hierarchy | `inheritance` | [Detail](../../fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-REPLACE-SUBCLASS-WITH-DELEGATE` | 以委托取代子类 | Replace Subclass with Delegate | `inheritance` | [Detail](../../fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-REPLACE-SUPERCLASS-WITH-DELEGATE` | 以委托取代超类 | Replace Superclass with Delegate | `inheritance` | [Detail](../../fec-refactoring-inheritance/references/inheritance-refactorings.md) |