# ゲート付きリファクタ (orch-refine-code)

> テストが緑であることを確認し、振る舞いを変えずに構造を整え、レビュー後にゲート付きでコミットします。

- カテゴリ: [リファクタリング](https://www.myskills.tools/ja/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/ja/ · URL: https://www.myskills.tools/ja/skills/orch-refine-code/
