用途
csharp-refactoring 是一个面向 C#/.NET 代码的重构技能,核心原则是:重构只改变代码结构,绝不改变可观察的行为。它适用于重命名、移动、提取、内联、合并、去重等保持行为不变的结构性请求。
主要能力
- 先分类后动手:在还原、构建或编辑前,先判断请求是否属于保持行为不变的重构。若请求混合了行为变更,只完成可分离的结构性操作,其余部分明确转交对应工作流(如 dotnet-upgrade、功能工作流、缺陷修复或行为变更工作流、API 契约工作流)。
- 基于绑定而非文本编辑:重命名和移动代码时,先查找所有绑定引用,再按语义修改,避免误改注释、字符串或无关重载。工具优先级为 IDE/Roslyn 重构、C# LSP 的 findReferences/goToDefinition/incomingCalls/rename、分析器修复、编译器校验的编辑,最后才是小范围已验证的查找替换。
- 保留外部契约:重命名或移动前检查名称或元数据是否被序列化、反射、依赖注入、配置绑定、源生成器、P/Invoke 或动态调用观察到,并通过仓库既有机制保留外部名称。
- 按影响范围验证:局部私有改动只需一次最窄构建和相关测试;公共或已发布符号、多目标框架、条件编译或生成代码等跨边界改动,需先建立基线,再对每个目标框架显式构建并运行相关测试。
- 处理跨边界风险:涉及公共符号、多目标项目或生成代码时,检查 PublicAPI.Shipped/Unshipped.txt、ApiCompat、TargetFrameworks、条件编译分支和 InternalsVisibleTo 等表面。
使用方式
作为技能使用时,向代理提出具体的 C# 重构请求,技能会先分类,再在限定工作区内完成单个命名重构操作,最后以简洁的证据式交付说明重构内容、保留的行为或兼容边界、验证命令与结果,以及被推迟的变更。典型验证命令为 dotnet build 和 dotnet test。
适用场景
适用于 C#/.NET 项目中需要安全重命名、移动、提取、内联、合并或去重的场景,尤其是涉及公共 API、多目标框架和生成代码的代码库。
限制
不执行版本升级、新功能实现或行为变更;若结构性变更会破坏公共/已发布 API 且无法用兼容垫片保留,技能会停止并报告边界;基线已失败或等价性依赖测试未覆盖的运行时行为时,也会停止并报告未验证边界。具体安装方式与许可信息暂未提供。