关于 refactoring-analysis
refactoring-analysis 是用于分析代码库的技能,帮助开发者寻找有证据表明能降低维护成本且保持行为不变的重构机会。它会追踪代码关系、评估影响并按请求范围整理报告。
主要功能
- 01追踪代码归属与依赖关系
- 02参考代码异味与重构资料
- 03按影响、风险和工作量排序
- 04说明改动及对应验证
- 05按请求范围调整报告
适用场景
- 01审查代码库中的高维护成本模式
- 02确定重构机会的优先级
- 03分析后继续已获授权的重构
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ marcioaltoe/ skills --skill refactoring-analysis安装后在 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