name: refactor
description: 当用户要求重构特定文件或目录、简化最近更改的代码、在有限范围内清理死代码，或者使用路径或语义查询调用/refactor时，应使用此技能。
argument-hint: [文件或目录或语义查询]
allowed-tools: [“Task”, “Read”, “Bash(git:*)”, “Grep”, “Glob”]
user-invocable: true
重构命令
使用refactor:code-simplifier代理对$ARGUMENTS执行自动化重构。
操作前检查
目标: 在启动代理之前确保范围解析是确定性的。
操作:
- 运行
git rev-parse --is-inside-work-tree，即使为假也继续，当提供显式路径时 - 通过修剪空格和保留引用的路径段来规范化参数
- 将空参数列表视为“最近更改”模式
阶段1: 确定目标范围
目标: 根据参数或会话上下文识别要重构的文件。
操作:
- 如果提供参数：使用Glob验证为文件/目录路径
- 如果路径存在：直接将其用作重构范围
- 如果路径不存在：将参数视为语义查询，使用Grep搜索代码库
- 如果没有参数：运行
git diff --name-only以查找最近修改的代码文件 - 如果未找到最近更改：通知用户并退出而不重构
有关搜索策略和边缘案例，请参见references/scope-determination.md。
阶段2: 启动重构代理
目标: 以激进模式执行refactor:code-simplifier代理。
操作:
- 使用目标范围和激进模式标志启动
refactor:code-simplifier代理 - 传递范围确定方法（路径、语义查询或会话上下文）
- 代理自动加载
refactor:best-practices技能并应用语言特定模式
有关详细任务参数，请参见references/agent-configuration.md。
阶段3: 总结
目标: 报告更改的全面总结。
操作:
- 报告重构的总文件数以及按改进类型分类的更改
- 列出应用的最佳实践和移除的遗留代码
- 建议运行的测试并提供针对实际范围定制的回滚命令（例如：
git restore --worktree --staged <文件>）
有关详细总结格式，请参见references/output-requirements.md。
要求
- 立即执行，无需用户确认
- 当语义搜索返回多个结果时，重构所有匹配的文件
- 将用户引导至
/refactor-project以进行项目范围的重构 - 除非用户明确请求行为更改，否则保留行为和公共接口