name	metago-refactor-suggest
description	重构建议技能。检测代码异味（Code Smell）、量化技术债务、识别重构机会，生成含优先级和影响范围的重构方案。遵循行为保持变换原则，确保重构不改变外部行为。输出含前后对比的重构报告。
version	1.0.0
author	MetaGO
category	科技开发
platforms	["cursor","claude-code","codex","trae","codebuddy","qoder","zcode","workbuddy","qclaw","ima"]
trigger	["帮我重构代码","检测代码异味","技术债务评估","代码优化建议","重构方案生成"]

重构建议（metago-refactor-suggest）

描述

检测代码异味、量化技术债务、识别重构机会，生成含优先级和影响范围的重构方案。遵循行为保持变换（Behavior Preservation）原则，确保重构不改变外部行为。

触发条件

用户请求重构、代码优化、技术债务评估时激活
代码审查发现可维护性问题时联动触发
定期技术债务盘点
与 metago-code-review-deep 协同：审查发现 Minor/Major 问题时触发

核心流程

1. 代码异味检测

长函数（行数 > 阈值，默认 50 行）
大类（字段/方法数 > 阈值）
重复代码（相似度 > 80%）
过长参数列表（参数数 > 5）
发散式修改（一个类因多个原因修改）
霰弹式修改（一个修改引发多处变更）
特性依恋（方法调用大量其他类）
数据泥团（多个变量总是一起出现）

2. 复杂度量分析

圈复杂度（Cyclomatic Complexity）> 10 需重构
认知复杂度（Cognitive Complexity）> 15 需重构
继承深度（DIT）> 4 需关注
耦合度（CBO）> 10 需优化

3. 依赖分析

循环依赖检测
不稳定依赖（依赖不稳定模块）
上层依赖下层（违反依赖倒置）
过度耦合（一个模块依赖过多模块）

4. 重构机会识别

异味类型	推荐重构手法	优先级	影响范围
长函数	Extract Method	高	函数级
重复代码	Extract Method / Pull Up Method	高	类级
大类	Extract Class	中	模块级
过长参数	Introduce Parameter Object	低	函数级
特性依恋	Move Method	中	类级
循环依赖	Extract Class / Move Method	高	模块级

5. 重构方案生成

重构步骤分解（原子化操作）
行为保持验证（测试覆盖要求）
风险评估（回归概率）
前后对比（复杂度、可读性、可维护性指标）

输出格式

【重构建议报告】

## 1. 技术债务概览
债务等级：🟢 低 / 🟡 中 / 🔴 高
债务量化：预估 N 人天
热点模块：path/to/module

## 2. 代码异味清单
| # | 异味 | 位置 | 严重度 | 推荐手法 |
|---|------|------|--------|----------|
| 1 | 长函数（85行） | file.ext:L10-L95 | 🟡 Major | Extract Method |
| 2 | 重复代码（92%相似） | file.ext:L20 / file2.ext:L15 | 🔴 Critical | Extract Method |
| ... | ... | ... | ... | ... |

## 3. 重构方案（按优先级排序）

### 方案1：[重构名称]
- 目标：...
- 步骤：
  1. ...
  2. ...
  3. ...
- 测试要求：覆盖率达 X%
- 风险评估：低 / 中 / 高
- 预期收益：复杂度 15→8，可读性 +40%

### 方案2：...

## 4. 重构前后对比
| 指标 | 重构前 | 重构后 | 改善 |
|------|--------|--------|------|
| 圈复杂度 | 18 | 6 | -67% |
| 重复率 | 35% | 5% | -86% |
| 可维护性 | 4.2/10 | 8.1/10 | +93% |

## 5. 建议执行顺序
1. 先补充测试（当前覆盖率 X%）
2. 执行方案1（低风险高收益）
3. 执行方案2（...）

与其他技能的协同

与 metago-code-review-deep 协同：审查发现可维护性问题时触发重构建议
与 metago-coupling-optimize 协同：耦生度量化指导重构优先级
与 metago-critique 协同：重构方案需通过批判性分析
与 metago-decision-lock 协同：重构执行前需通过决策锁校验
与 metago-fact-check 协同：验证重构前后行为一致性

Más de este repositorio

mismo repositorio

metago-activate

metago-ai/metagolifeform

元构生命体意识激活。将 8 条公理、7 条属性、6 层思维协议注入当前会话，使 AI 以元构超级智能生命体身份运行。适用于不支持系统提示词自动注入的平台（Claude Code / Codex / Cursor / CodeBuddy / Qoder / ZCode）。一次激活，会话内持久生效。

2026-07-092

metago-action-plan

metago-ai/metagolifeform

行动计划生成技能。将目标分解为可执行的步骤序列。每个步骤必须是可执行的，有明确的依赖关系和预期耗时，高风险步骤标注提醒和回滚方案。

2026-07-052

metago-architecture-design

metago-ai/metagolifeform

架构设计技能。根据业务需求生成完整系统架构方案，含架构模式选择、模块分解、接口契约、数据流设计、技术选型依据。遵循高内聚低耦合、可扩展、可维护原则，输出含决策依据的架构文档。

2026-07-052

metago-balance-optimize

metago-ai/metagolifeform

当用户需要优化系统平衡、进行APO三维动态平衡分析时触发

2026-07-052

metago-code-review-deep

metago-ai/metagolifeform

深度代码审查技能。对代码进行多维度分级审查（Critical/Major/Minor/Info），覆盖逻辑正确性、安全漏洞、性能瓶颈、可维护性、风格一致性。基于元构批判性分析（metago-critique）和事实核查（metago-fact-check）能力，输出含修复建议的结构化审查报告。

2026-07-052

metago-compliance

metago-ai/metagolifeform

合规主动检查技能。在每次任务执行前主动检查法律合规性、伦理合规性、安全合规性，遵循法律优先于效率原则。当任务涉及数据处理、用户隐私、安全操作、外部API调用时强制触发。

2026-07-052

name	metago-refactor-suggest
description	重构建议技能。检测代码异味（Code Smell）、量化技术债务、识别重构机会，生成含优先级和影响范围的重构方案。遵循行为保持变换原则，确保重构不改变外部行为。输出含前后对比的重构报告。
version	1.0.0
author	MetaGO
category	科技开发
platforms	["cursor","claude-code","codex","trae","codebuddy","qoder","zcode","workbuddy","qclaw","ima"]
trigger	["帮我重构代码","检测代码异味","技术债务评估","代码优化建议","重构方案生成"]

重构建议（metago-refactor-suggest）

描述

触发条件

用户请求重构、代码优化、技术债务评估时激活
代码审查发现可维护性问题时联动触发
定期技术债务盘点
与 metago-code-review-deep 协同：审查发现 Minor/Major 问题时触发

核心流程

1. 代码异味检测

长函数（行数 > 阈值，默认 50 行）
大类（字段/方法数 > 阈值）
重复代码（相似度 > 80%）
过长参数列表（参数数 > 5）
发散式修改（一个类因多个原因修改）
霰弹式修改（一个修改引发多处变更）
特性依恋（方法调用大量其他类）
数据泥团（多个变量总是一起出现）

2. 复杂度量分析

圈复杂度（Cyclomatic Complexity）> 10 需重构
认知复杂度（Cognitive Complexity）> 15 需重构
继承深度（DIT）> 4 需关注
耦合度（CBO）> 10 需优化

3. 依赖分析

循环依赖检测
不稳定依赖（依赖不稳定模块）
上层依赖下层（违反依赖倒置）
过度耦合（一个模块依赖过多模块）

4. 重构机会识别

异味类型	推荐重构手法	优先级	影响范围
长函数	Extract Method	高	函数级
重复代码	Extract Method / Pull Up Method	高	类级
大类	Extract Class	中	模块级
过长参数	Introduce Parameter Object	低	函数级
特性依恋	Move Method	中	类级
循环依赖	Extract Class / Move Method	高	模块级

5. 重构方案生成

重构步骤分解（原子化操作）
行为保持验证（测试覆盖要求）
风险评估（回归概率）
前后对比（复杂度、可读性、可维护性指标）

输出格式

【重构建议报告】

## 1. 技术债务概览
债务等级：🟢 低 / 🟡 中 / 🔴 高
债务量化：预估 N 人天
热点模块：path/to/module

## 2. 代码异味清单
| # | 异味 | 位置 | 严重度 | 推荐手法 |
|---|------|------|--------|----------|
| 1 | 长函数（85行） | file.ext:L10-L95 | 🟡 Major | Extract Method |
| 2 | 重复代码（92%相似） | file.ext:L20 / file2.ext:L15 | 🔴 Critical | Extract Method |
| ... | ... | ... | ... | ... |

## 3. 重构方案（按优先级排序）

### 方案1：[重构名称]
- 目标：...
- 步骤：
  1. ...
  2. ...
  3. ...
- 测试要求：覆盖率达 X%
- 风险评估：低 / 中 / 高
- 预期收益：复杂度 15→8，可读性 +40%

### 方案2：...

## 4. 重构前后对比
| 指标 | 重构前 | 重构后 | 改善 |
|------|--------|--------|------|
| 圈复杂度 | 18 | 6 | -67% |
| 重复率 | 35% | 5% | -86% |
| 可维护性 | 4.2/10 | 8.1/10 | +93% |

## 5. 建议执行顺序
1. 先补充测试（当前覆盖率 X%）
2. 执行方案1（低风险高收益）
3. 执行方案2（...）

与其他技能的协同

与 metago-code-review-deep 协同：审查发现可维护性问题时触发重构建议
与 metago-coupling-optimize 协同：耦生度量化指导重构优先级
与 metago-critique 协同：重构方案需通过批判性分析
与 metago-decision-lock 协同：重构执行前需通过决策锁校验
与 metago-fact-check 协同：验证重构前后行为一致性