request-refactor-plan

request-refactor-plan スキルの概要

request-refactor-plan ができること

request-refactor-plan スキルは、曖昧なリファクタリング依頼を、小さなコミット単位の構造化された計画に落とし込み、その計画を GitHub issue としてまとめるのに役立ちます。これは request-refactor-plan for Refactoring 向けに作られており、ゼロから設計し直すのではなく、安全にコードを改善したいときに向いています。

どんな人に向いているか

request-refactor-plan skill は、リファクタリングの RFC、実装計画、または明確なスコープが必要な issue を作成するエンジニア、テックリード、エージェントに適しています。実際のコードベースに対して、変更が単純ではなく、編集に入る前の不確実性を減らしたい場面で特に有効です。

何が違うのか

このスキルは、単なる汎用プロンプトの下書き以上のことをします。ユーザーインタビュー、リポジトリの確認、スコープ境界の整理、テストカバレッジの見直し、そしてコミットごとの分解まで促します。そのため、戻しやすさとレビューしやすさが重要な段階的リファクタリングの計画により適した出力になります。

request-refactor-plan スキルの使い方

インストールして有効化する

スキルマネージャーから request-refactor-plan install のフローを使うか、ツール側で直接ソースを指定する必要がある場合はリポジトリのパスからインストールしてください。リポジトリの場所は mattpocock/skills の skills/deprecated/request-refactor-plan なので、本番作業で頼る前に、ローカルのローダーが deprecated skills をまだ解決できるか確認しておくべきです。

リファクタリング向けのブリーフを渡す

このスキルは、最初の入力に以下が含まれていると最もよく機能します。解決したい問題、現在の挙動、関係するコードベースの範囲、制約、そしてすでに検討した案です。良いプロンプトの例は次のようなものです。「billing の retry フローをリファクタリングして結合度を下げ、API レスポンスは変えず、既存テストは維持し、DB スキーマ変更は避けてください。」

想定されているワークフローに沿う

request-refactor-plan usage の流れは、問題を詳しく説明する、リポジトリの状態を確認する、代替案を検討する、正確なスコープを定義する、テストを見直す、そして作業を小さなコミットに分ける、という順番です。これらの入力を飛ばすと、計画はたいてい広すぎるか、逆に慎重すぎて使いにくくなります。

最初に読むべきファイル

まず SKILL.md を開き、その後で環境に存在するなら README.md、AGENTS.md、metadata.json、および rules/、resources/、references/、scripts/ フォルダを確認してください。このリポジトリでは、主要な判断材料は SKILL.md に集約されているため、補助資料を突き合わせる必要はあまりありません。

request-refactor-plan スキル FAQ

これは通常の機能開発向けですか？

いいえ。request-refactor-plan skill は、機能追加ではなくリファクタリングとスコープ管理を目的としています。機能仕様、アーキテクチャ提案、ロードマップが必要なら、別の計画スキルか、通常のプロンプトのほうが合っている場合があります。

使うのに高い技術詳細は必要ですか？

完璧な設計図までは不要ですが、問題をうまく聞き取れるだけの文脈は必要です。ブリーフが「これをきれいにして」だけだと出力は一般的になりがちです。ファイル名、挙動、リスク、制約を挙げられれば、計画はずっと実行しやすくなります。

どんなときに使わないほうがいいですか？

変更が小さい、明白、またはすでに十分にスコープされている場合は使わないでください。リポジトリを確認できない、テストカバレッジを把握できない、あるいは正式な issue と段階的な計画のオーバーヘッドを望まない場合も、相性はあまりよくありません。

通常のプロンプトと比べるとどう違いますか？

通常のプロンプトでもリファクタリングのチェックリストは得られますが、request-refactor-plan は検証、代替案の見直し、スコープ固定、テスト確認、小さなコミット分割といったプロセスの дисциплиниを加えます。その結果、過剰リファクタリングや見えない結合の見落としを減らせます。

request-refactor-plan スキルを改善するには

最初の入力をもっと具体的にする

結果を最速で良くする方法は、現状の痛点、理想の到達点、明確な非目標をはっきり書くことです。たとえば「src/payments/* の重複したバリデーションロジックを減らし、公開 API は安定させ、export されている関数名は変更せず、現在のエラーメッセージは維持する」と伝えます。こうすると request-refactor-plan の案内が推測に頼らずに済みます。

テストとリスクの文脈を含める

このスキルがカバレッジを尋ねるのには理由があります。テストが弱いと計画が変わるからです。その領域を既に守っているテスト、許容できない失敗、リファクタリングの前後どちらでテストを追加できるかを伝えてください。これを省くと、計画が攻めすぎるか、逆に慎重すぎるものになりかねません。

よくある失敗パターンに注意する

大きな失敗は、スコープ不足、スコープ過多、そして曖昧な到達点です。最初の出力が広すぎると感じたら、対象ファイルを絞り、変更してはいけない挙動を明示し、より小さなコミット順にしてほしいと伝えてください。逆に慎重すぎるなら、リファクタリングが必要な業務上の理由と、変更を正当化する受け入れ条件を追加します。

issue の下書きを使って反復する

生成された GitHub issue は完成版ではなく、作業用ドラフトとして扱ってください。request-refactor-plan for Refactoring の結果は、問題定義を見直し、推測ベースの手順を削り、各ステップを個別にレビューできる粒度までコミット一覧を絞り込むことで改善できます。