# 编排式重构 (orch-refine-code)

> 编排行为不变的重构：先确认测试通过，在测试保持绿色的前提下重组结构，经审查后分关卡提交。

- 分类: [重构](https://www.myskills.tools/zh/categories/refactoring/)
- 来源: 社区 · Affaan Mustafa
- 代码仓库: https://github.com/affaan-m/ECC/tree/main/skills/orch-refine-code (commit db7f2a6)
- SKILL.md: https://github.com/affaan-m/ECC/blob/main/skills/orch-refine-code/SKILL.md
- 安装命令: `npx skills add affaan-m/ECC --skill orch-refine-code`
- 许可证: MIT
- 兼容工具: Claude Code, Codex, Cursor, Copilot, OpenCode
- 权限: read-repo ✓, write-files ✓, shell ✓, network ✗
- 状态: 扫描通过
- 规则扫描无法覆盖所有风险，安装前请阅读此技能的 SKILL.md，确认权限后再使用。
- ⚠ 关卡 2 确认后会创建 git 提交，清理阶段可能删除死代码。

## 核心规则

差异必须保持行为中立，只要行为需要改变，就不该使用这个技能。

## 执行阶段

1. **确认测试通过** — 动代码前确认相关测试存在且通过；覆盖不足时先补表征测试。
2. **规划重构** — 通过 orch-pipeline 引擎规划重构方案，并在关卡 1 停下等待批准。
3. **小步重组** — 小步修改并在每步后重跑测试；清理死代码或重复时交给 refactor-cleaner 代理（使用 knip、depcheck、ts-prune）。
4. **代码审查** — 对行为中立的差异进行代码审查。
5. **关卡提交** — 在关卡 2 停下确认，然后以 refactor: 前缀提交。

## 权限说明（据 SKILL.md 整理）

| 能力 | 是否需要 | 说明 |
|---|---|---|
| 文件写入 | 需要 | 跨多个文件重组代码，必要时添加表征测试。 |
| 命令执行 | 需要 | 运行测试套件、knip/depcheck/ts-prune 等工具，并执行 git 提交。 |
| 网络外发 | 不需要 | 技能未要求访问网络。 |

## SKILL.md 头部信息（YAML）

```yaml
---
name: orch-refine-code
description: Orchestrate a behavior-preserving refactor — confirm tests are green, restructure without changing behavior, keep tests green, review, and gated commit. Use when the structure should improve but behavior must not change.
metadata:
  origin: ECC
---
```

首页: https://www.myskills.tools/zh/ · URL: https://www.myskills.tools/zh/skills/orch-refine-code/