用途:在不改变行为的前提下提升 UI 可维护性,包括提取子组件、为清晰而重命名、在既有约定内重组文件结构、降低组件复杂度(防止“上帝组件”)。行为必须保持稳定,且该技能要求提供证据。
主要能力:识别能有效降低复杂度的最小提取;保持公共 API 稳定(除非明确要求,否则保持现有 props 不变;保持导出稳定或更新所有调用点);提取子组件时优先纯展示型组件并传递最少 props;除提取正确性所需外不改逻辑;新增或调整测试,确保至少一个测试断言预期渲染或交互;按配置运行校验。
输入:目标组件或路由、重构意图(原因与痛点)、公共 API 约束(props、导出、路由)、仓库约定(如存在 REPO_PROFILE.json)。输出:更小模块的重构后 UI、按需更新的导入导出、无行为变更的证据(更新或新增测试,或在无测试时提供确定性的前后检查说明)。
非目标:新增功能、视觉重设计、更改数据契约、触碰范围之外的全面重构。
检查项:无意引入行为变更;公共 API 兼容性保持(props、导出、导入路径);如已配置则类型检查、lint、测试通过;组件复杂度降低。
失败模式:重构漂移为功能开发时停止并建议单独调用技能;提取暴露隐藏状态耦合时建议 frontend/state-modeling;无测试时提供确定性检查步骤并保持最小 diff。
遥测记录:skill、refactor_type(extract/rename/reorganize)、evidence(tests/inspection)、files_touched、outcome(success/partial/blocked)。