📚 Big — 大
v1.0.0重构规划器 规划并执行持续数周至数月的架构级重构战役——来自……的四大命名模式,用于大规模结构性重组。
详细分析 ▾
运行时依赖
版本
初始版本:使用 Fowler 与 Beck 的四种命名架构模式,规划并编排持续数周的大型重构战役。 - 依据代码库中的结构信号,判断适用四大重构模式(Tease Apart Inheritance、Convert Procedural Design to Objects、Separate Domain from Presentation、Extract Hierarchy)中的哪一种。 - 输出多阶段战役计划,含决策点与里程碑,可与持续的功能开发安全交错。 - 支持直接代码库分析和/或代码异味诊断报告作为输入。 - 明确何时必须启用(结构或架构问题过大,单会话重构无法解决),何时禁用(较小范围重构或前期测试套件搭建)。 - 引导设定清晰的停止条件,以启用目标功能或解除关键阻塞。 - 面向熟悉面向对象设计与遗留代码改造的经验开发者、技术负责人与架构师。
安装命令
点击复制技能文档
--- name: big-refactoring-planner description: | 规划并执行需数周到数月的架构级重构战役——Fowler 与 Beck 第 12 章的四大命名模式,用于大规模结构重组。 适用场景:
- 继承体系同时承担两项职责,且子类名在每一层都带相同形容词前缀(Tease Apart Inheritance);
- 面向对象代码却以过程式风格编写:行为空类上的长方法、 dumb data objects(Convert Procedural Design to Objects);
- GUI/窗口类里出现 SQL、业务规则、计价逻辑而非仅展示代码(Separate Domain from Presentation);
- 单个类累积大量条件分支,新增 case 需在多处修改(Extract Hierarchy)。
当 code-smell-diagnosis 发现 Parallel Inheritance Hierarchies、Data Class 或带深层条件的大型类,且修复超出单次重构时启用。 按结构信号区分四模式,选对模式及变体,输出可穿插功能开发的数周战役计划。
version: 1.0.0 homepage: https://github.com/bookforge-ai/bookforge-skills/tree/main/books/refactoring/skills/big-refactoring-planner metadata: {"openclaw":{"emoji":"📚","homepage":"https://github.com/bookforge-ai/bookforge-skills"}} status: draft depends-on: - code-smell-diagnosis source-books: - id: refactoring title: "Refactoring: Improving the Design of Existing Code" authors: ["Martin Fowler", "Kent Beck"] chapters: [12] tags: [refactoring, code-quality, legacy-code, architecture] execution: tier: 2 mode: hybrid inputs: - type: codebase description: "存在架构级结构问题的目标代码库或子系统" - type: document description: "已运行的 code-smell-diagnosis 报告,指明适用的大重构模式" tools-required: [Read, Grep, Write] tools-optional: [Bash] mcps-required: [] environment: "在项目目录内运行;读源文件识别结构模式;输出战役计划。" discovery: goal: "识别适用四大模式之一;选对执行变体;产出含里程碑、决策点、与功能开发穿插策略的战役计划" tasks: - "读代码确认结构信号对应模式" - "按结构信号选模式及变体" - "找出模式内的关键决策点" - "制定可与功能开发并行的分阶段战役计划" - "设定完成条件:重构何时算够" audience: roles: ["software-developer", "senior-developer", "tech-lead", "architect"] experience: "资深——需熟悉面向对象设计与单步重构" triggers: - "继承体系每层子类名带相同形容词前缀" - "面向对象代码却用过程式风格:无数据类上的长方法、无行为的 dumb data objects" - "窗口/GUI 类含 SQL、计价逻辑或业务规则" - "新增 case 需在五个不同地方修改同一类" - "code-smell-diagnosis 发现 Parallel Inheritance Hierarchies、Data Class 或条件泛滥的 god class" - "团队新增功能类型时总要在同一类多处动手" not_for: - "单次会话可完成的单步重构——请用 method-decomposition-refactoring 或 conditional-simplification-strategy" - "性能优化——请用 profiling-driven-performance-optimization" - "诊断气味——先运行 code-smell-diagnosis" - "重构前搭建测试覆盖——先用 build-refactoring-test-suite"
# Big Refactoring Planner
何时使用
你遇到结构设计问题,无法在一次重构会话内解决。单步动作——Extract Method、Move Method、Extract Class——不是问题所在;挑战在于架构:数十个类纠缠、一个体系身兼数职、或过程式逻辑遍布名义上的对象代码。修复需数周至数月。本技能为这类战役而生。Fowler 与 Beck 核心原则: “重构不是因为好玩,而是因为你期望程序在重构后能做成一些现在做不成的事。” 大重构有明确目的——