关于 refactoring-analysis
Refactoring Analysis 是用于代码维护性审查的技能，面向希望在保持行为不变的同时降低维护成本的开发者。它要求将代码异味与具体证据、改进方案和影响联系起来，并按影响与风险排序。
主要功能
- 01识别有证据支持的代码异味
- 02追踪所有权、耦合与调用点
- 03按影响、频率、风险和工作量排序
- 04生成重构分析报告
适用场景
- 01审查代码库并确定重构优先级
- 02评估具体改动对维护性的影响
- 03在保持兼容性的前提下规划重构
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/refactoring-analysis确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
assets/refactoring-report-template.mdchecklists/analysis-checklist.mdreferences/code-smells-catalog.mdrefactoring-techniques.mdsolid-ddd-context.mdscripts/validate-metadata.py详细介绍
重构分析
找出能够降低已体现的维护成本，同时保留行为的改动。指出代码异味、源代码证据和具体改进方案；仅给出教科书式的分类，而不说明实际影响，不算作发现。
- 根据请求和当前上下文确定范围。对于范围较广的请求，应梳理代码库并优先关注依赖项和热点；不要仅因涉及文件超过 50 个就停止并请求确认。说明抽样或未检查的部分。
- 针对发现的候选项，阅读
references/code-smells-catalog.md和references/refactoring-techniques.md中的相关章节。目录中的阈值是参考信号，不是必须进行修改的硬性要求，也不要求每个类别都必须给出发现。 - 追踪归属、耦合、调用点和公共边界。只有涉及领域模型的问题才查阅
references/solid-ddd-context.md；普通代码无需进行 SOLID 审查。 - 根据用户影响、发生频率、风险和工作量，对确认的改进机会排序。对于影响最大的项目，说明改动前后的行为以及负责验证的机制。优先复用现有覆盖；缺少测试并不意味着每一层都必须新建一套测试。
- 报告默认保存为
docs/_refacs/<YYYYMMDD>-<slug>.md。根据需要调整assets/refactoring-report-template.md；范围较窄的请求可以简要作答。视情况使用checklists/analysis-checklist.md检查重要引用和推理。 - 如果用户只要求审查，则报告发现。如果用户已授权重构，则无需再次询问，直接继续完成选定的工作。保留已发布的兼容性，并避免改动无关内容。
评论
支持 Markdown