orch-refine-code は何をしますか?
アクター · アクション · ターゲット: orch · refine · code。orch-pipeline の共有エンジンをラップした薄いラッパー。
使用するタイミング
- 同じ振る舞い、より良い構造: モジュールの抽出、重複の除去、デッドコードの削除、ネストの低減、明確化のためのリネーム。
- 関連スキルとの区別: もし振る舞いが少しでも変わるなら、このスキルは間違いです(
orch-change-feature/orch-fix-defectを使用してください)。
操作設定
- デフォルトのサイズフロア: 標準 — リファクタリングは複数のファイルに影響します。
- フェーズマスク: 0 → 2(リファクタリング計画) → 4(グリーン維持) → 5 → 6。新しい振る舞いテストは書きません — 既存のテストスイートが安全網です。
- 最初の一手(フェーズ4): コードに触れる前に、関連するテストが存在しグリーンであることを確認します。カバレッジが薄い場合は、最初に特性テストを追加します。その後、小さなステップでリファクタリングし、各ステップ後にテストを再実行します。
動作の仕組み
- 上記の設定で
orch-pipelineエンジンを実行します。 - デッドコード/重複の除去スイープでは、
refactor-cleanerエージェントに委任します(knip / depcheck / ts-prune を実行し、安全に削除します)。 - ゲート 1(リファクタリング計画)とゲート 2(コミット前)で停止します。
refactor:としてコミットします — 差分は振る舞いが中立でなければなりません。
例
orch-refine-code: poller.py から NWS HTTP クライアントを抽出
→ テストがグリーンであることを確認 → 抽出計画 [ゲート 1: 承認]
→ 小さなステップで移動、テストは常にグリーン → コードレビュー
→ refactor: でコミット [ゲート 2: 承認]