メニュー
既存コードを振る舞いを変えずに小さく安全に改善したいとき。 機能追加よりも、保守性改善・責務分離・重複削減・命名改善に向く。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | safe-refactor |
| description | 既存コードを振る舞いを変えずに小さく安全に改善したいとき。 機能追加よりも、保守性改善・責務分離・重複削減・命名改善に向く。 |
既存コードを安全な小さな段階で整え、レビューしやすい差分で改善するための手順です。最小のコードで最大の効果を狙い、長い目で見て Happy にならない複雑化を避けます。
deep-review-preflight - 事前レビューで壊していないかを確認したいときmodularity-review - 責務境界やモジュール分割を先に見直したいとき変更対象が何を担当していて、どの振る舞いを絶対に変えないかを一文で定義します。
Why: 最初に境界を固定しないと、改善のつもりで仕様変更を混ぜやすくなるためです。
今回の変更意図を次のどれかに絞ります。
1 回の変更で複数の意図を混ぜないようにします。
既存テストがあるなら先に実行し、ない場合でも最低限の比較手段を決めます。
Why: 確認手段なしのリファクタは、改善か退行かを判断できないためです。
1 回のコミットや差分では、1 つの関心事だけを扱います。外科的対応を既定にし、今回の改善意図に直接効かない整理は次回へ回します。
公開 API や外部契約に触れる場合は、その影響を明示します。
リファクタ後は、少なくとも次の 2 点を言語化します。
Why: 差分の価値と安全性を同時に説明できると、レビューが速くなりやすいためです。
こんなときに使う: Ubuntu / Linux サーバーに SSH で接続し、sudo、systemd サービス、HTTP 監視を一連で安全に進めたいとき。 接続前に SSH_AUTH_SOCK を含む認証状態を固定し、認証で止まらずに サーバー接続・権限確認・サービス起動・停止・再起動・状態確認を一気に行いたいとき。
調査→修正→検証→ふりかえり/後続 Issue 化までを 1 つの改善ループで回したいときに使う。 実装前の再現確認や、review 指摘・検証結果をもとに次のアクションへつなぐ。
こんなときに使う: 現在の会話内容をもとに、実装・エージェント発注に直結する PRD を作りたいとき。 追加のインタビューはせず、すでに会話に出ている内容だけから構成する。 情報が不足している場合は捏造せず「未確定」として明示する。
こんなときに使う: ユーザーが「インタビューして」「質問して」「設計を詰めたい」などと言ったら使う。 計画や設計の重要な判断軸を洗い出し、具体例・反例・影響範囲まで深掘りして要件整理に落とす。
Copilot の custom skill / agent / repository instructions の作成・改善・構造確認を 1 つの入口にまとめる。複合スキルとして、対象に応じて適切な authoring ルートへ 分けつつ、実行時のモデル呼び出しを抑止してルーティングを優先する。試作から `plugins/*` 配布へ昇格するときの name / description 整備も扱う。skill / agent / repo-wide instructions / path-specific instructions を新規作成したいとき、既存定義を育てたいとき、公開前に責務や導線を確かめたいとき。
新しい custom agent を既存 agent 群と同じ型で立ち上げる。agent の新規追加、役割分離のための専門 agent 作成、既存群の隙間を埋めたいとき。