orch-refine-code は何をしますか?
Actor · action · target: 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: NWS HTTPクライアントをpoller.pyから抽出する
→ テストがグリーンであることを確認 → 抽出計画 [ゲート1: 承認]
→ 小さなステップで移動、テストは常にグリーン → コードレビュー
→ commit refactor: [ゲート2: 確認]