name: refactor-project
description: 当用户请求项目范围重构、跨文件简化、代码库一致性标准化、重复减少或调用/refactor-project时,应使用此技能。
argument-hint: (无需参数)
allowed-tools: [“Task”, “Read”, “Bash(git:*)”, “Grep”, “Glob”]
user-invocable: true
重构项目命令
使用refactor:code-simplifier代理执行自动化的项目范围重构,专注于跨文件优化。
预操作检查
目标: 确保项目范围执行是明确且可复现的。
操作:
- 运行
git rev-parse --is-inside-work-tree;如果为假,告知用户项目范围模式需要一个git工作空间 - 使用
git rev-parse --short HEAD记录当前版本,并在最终摘要中包含它以供回滚上下文 - 忽略命令参数,继续进行全项目发现
阶段1: 分析项目范围
目标: 发现所有代码文件并显示范围摘要。
操作:
- 使用Glob模式查找常见扩展的所有代码文件
- 过滤掉
node_modules/,.git/,dist/,build/,vendor/,.venv/ - 按语言/扩展分组文件并识别主要源目录
- 显示范围摘要(文件数量、语言、目录),然后自动进行
有关排除模式和边缘情况,请参阅references/scope-analysis.md。
阶段2: 启动重构代理
目标: 执行refactor:code-simplifier代理,具有项目范围和跨文件焦点。
操作:
- 使用所有发现的代码文件启动
refactor:code-simplifier代理 - 传递跨文件优化重点:重复减少、一致模式
- 传递激进模式标志以移除遗留代码
- 代理自动加载
refactor:best-practices技能并应用语言特定模式
有关详细的任务参数,请参阅references/agent-configuration.md。
阶段3: 摘要
目标: 报告项目范围更改的全面摘要。
操作:
- 报告重构的总文件数(项目中的数量和百分比)
- 列出按改进类型和跨文件改进分类的更改
- 列出应用的最佳实践和移除的遗留代码
- 建议运行的测试套件并推荐按逻辑组审查更改
- 提供绑定到记录基线的更安全回滚命令(例如:
git restore --worktree --staged .)
有关详细摘要格式,请参阅references/output-requirements.md。
要求
- 显示范围后立即执行(无需确认)
- 在所有发现的代码文件中重构整个项目
- 优先考虑跨文件重复减少和一致模式
- 除非用户明确请求行为更改,否则保留行为和公共接口