메뉴
系统化、安全地代码重构技能。能够识别代码坏味道、提供重构手法，支持制定计划、执行重构并验证结果。适用于代码质量提升、技术债清理、可维护性改进、代码优化、代码改进等场景。当用户请求重构代码、优化代码质量、修复代码问题或清理技术债时触发。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
基于FastAPI知识库服务实现的RAG知识管理与检索技能，支持文档上传、解析、入库、删除、列表查询、内容检索、全文检索等能力，兼容PDF/DOCX/TXT/MD等格式，支持图片解析与多粒度描述入库，可直接对接Agent/机器人进行知识问答。
Analyzes pull requests and codebases for implementation and architecture issues, outputs structured analysis reports and refactoring suggestions. Use when reviewing PRs, examining code changes, conducting periodic codebase reviews, or when the user asks for refactoring/architecture analysis.
模型资源收集。联网搜索最新免费/优惠的AI模型资源信息（如各大云厂商优惠活动、免费API、Coding计划等），整理并生成配置指南文档。适用于用户询问"有什么便宜的模型推荐"、"免费模型有哪些"、"模型优惠"等场景。
GitCode PR安全审查技能。用于自动审查GitCode仓库的Pull Request中的代码安全问题，使用sdk-security-audit技能进行代码安全分析，并将审查结果作为评论发布到对应的PR上。当用户需要对GitCode仓库的PR进行安全代码审查时使用此技能。
Generate reply drafts for a single GitCode issue; maintainer reviews before posting. Use when user asks to reply to or comment on an issue and provides a GitCode issue link; do not use when user only wants to fetch or query issue data. 针对单个 GitCode Issue 生成回复草稿，维护者审阅后可发送评论；仅当用户要回复或评论且提供链接时使用，仅获取或查询 issue 信息时勿用。Python 3.7+ standard library only.
Write README-style technical documentation for AscendC custom operators by reading local source files and adapting an existing template. Use when Codex needs to document an AscendC operator, compare a target operator repo against a reference README, turn `op_host` and `op_kernel` implementations into structured docs, or generate per-operator documentation from code with the model instead of a parser script.
| name | code-refactoring |
| description | 系统化、安全地代码重构技能。能够识别代码坏味道、提供重构手法，支持制定计划、执行重构并验证结果。适用于代码质量提升、技术债清理、可维护性改进、代码优化、代码改进等场景。当用户请求重构代码、优化代码质量、修复代码问题或清理技术债时触发。 |
本技能提供系统化、安全的代码重构指导，帮助改善既有代码的内部结构而不改变其外部行为。
在执行任何重构前，必须先输出详细的重构计划，格式如下：
## 重构计划
### 重构项 1
- **位置**：[文件路径]:[行号范围]，[函数/类/模块名称]
- **问题**：[描述当前存在的问题，标注坏味道类型]
- **方案**：[推荐的重构手法名称]
- **重构前**：
[重构前的关键代码片段]
- **重构后**：
[重构后的关键代码片段]
- **参考**：[参考资源]中的相关规则（如果涉及）
### 重构项 2
...
目的：建立安全网，确保重构不会破坏现有功能。
执行动作：
验证标准：所有现有测试通过，关键路径有测试覆盖。
当无法执行测试（如缺少依赖、环境未配置）时，可暂时跳过测试执行，但必须：
风险告知：
替代验证方式：
后续验证建议：
目的：系统性地发现代码中的问题点。
执行动作：
常见坏味道快速参考：
| 坏味道 | 说明 | 优先级 |
|---|---|---|
| 重复代码 | 相同代码出现在多处 | 高 |
| 过长函数 | 方法超过20-30行 | 高 |
| 过大类 | 类承担过多职责 | 中 |
| 过长参数列表 | 参数超过3-4个 | 中 |
| 数据泥团 | 多个数据项经常一起出现 | 中 |
| 特性依恋 | 方法对其他类数据更感兴趣 | 中 |
| Switch语句 | 复杂的条件分支 | 中 |
目的：为每个坏味道匹配合适的重构手法。
执行动作：
常见映射关系：
| 坏味道 | 推荐重构手法 |
|---|---|
| 重复代码 | 提取方法、提取超类 |
| 过长函数 | 提取方法、以查询取代临时变量 |
| 过大类 | 提取类 |
| 过长参数列表 | 引入参数对象 |
| 特性依恋 | 移动方法 |
| Switch语句 | 以多态取代条件表达式 |
目的：安全地执行重构，每一步都可验证。
执行动作：
验证标准：每一步后测试通过，代码可正常运行。
目的：检查重构效果，发现新的优化机会。
执行动作：
目的：确保重构未改变代码的外部行为。
执行动作：
验证标准：所有测试通过，功能行为与重构前一致，无新增的警告或错误。
重构后的代码必须符合项目代码风格规范：
| 文件 | 内容 | 适用场景 |
|---|---|---|
| cpp-coding-style-guide.md | C++ 编程规范 | 重构 C++ 代码时 |
| python-coding-style-guide.md | Python 编程规范 | 重构 Python 代码时 |
| go-coding-style-guide.md | Go 编程规范 | 重构 Go 代码时 |
| 文件 | 内容 | 加载时机 |
|---|---|---|
| code-smells.md | 22种坏味道详解 | 需要识别特定坏味道时 |
| refactoring-techniques.md | 25种重构手法 | 需要执行特定重构时 |
重构完成后，输出重构报告，报告内容包括：