request-refactor-plan

request-refactor-planについて

request-refactor-planは、mattpocock-skills-zh-cnコレクション（非推奨パス）に属する中国語版の計画策定スキルで、ユーザーへのインタビューを通じて小さなコミットに分けられた詳細なリファクタリング計画を作成し、それをGitHubのissueとして保存します。このスキルが対処する問題は、大規模なリファクタリングを一度に行うとリスクが高くなる点であり、Martin Fowlerが提唱する「各リファクタリングステップをできるだけ小さく保つことで常にプログラムが動作している状態を確認できる」という考え方に基づき、段階的かつ常に実行可能なステップを実施します。

手順（ステップは省略可能）は以下の通りです。まずユーザーに問題点と候補となる解決策を説明してもらい、リポジトリを調査してその主張を確認し現在の状態を把握します。次に代替案を提示し、実装に関してユーザーに徹底的に質問します。変更対象となる範囲を正確に特定し、何が変更され、何が変更されないかを明確にします。影響を受ける領域のテストカバレッジを確認し、カバレッジが不十分な場合はテスト計画について尋ねます。その後、実装内容を、コードベースを常に動作可能な状態に保つような多数の小さなコミットに分け、最後にProblem Statement、Solution、Commits、Decision Document、Testing Decisions、Out of Scope、および任意のFurther Notesのセクションを備えたテンプレートを使用してGitHub issueを作成します。テンプレートでは具体的なファイルパスやコードスニペットは意図的に省略されており、これらはすぐに古くなってしまうためです。

このスキルは、リファクタリングを計画したりリファクタリングに関するRFCを作成したりする開発者やテクノロジーリードを対象としており、厳格でインタビュー中心の、安全かつ段階的な計画を永続的なissueとして記録したい人向けです。その動作内容はリポジトリの調査とissueの作成のみで、破壊的な操作や機密性の高い処理は行われません。

FAQ

このスキルは何を作成するのですか？

Problem Statement、Solution、Commits、Decision Document、Testing Decisions、Out of Scope、および任意のFurther Notesのセクションを備えたテンプレートを使用し、GitHub issueとして詳細なリファクタリング計画が作成されます。

どのようにしてリファクタリングを安全に保つのですか？

Martin Fowlerの指針に従い、各リファクタリングステップをできるだけ小さく保つことで、作業内容を多数の小さなコミットに分け、各コミットがコードベースを常に動作可能な状態に保つようにしています。

計画には特定のファイルやコードが参照されますか？

いいえ。具体的なファイルパスやコードスニペットはすぐに古くなってしまうため、テンプレートでは意図的に省略されており、意思決定やモジュール、インターフェース、動作内容に焦点が当てられています。

テストについてはどのように対応しますか？

影響を受ける領域のテストカバレッジを確認し、カバレッジが不十分な場合はユーザーにテスト計画について尋ね、その後issueにテストに関する決定事項を記録します。

前提条件は何ですか？

調査やインタビューを行うためのリポジトリ、および完成した計画をGitHub issueとして作成するための機能が必要です。

全ファイル

2ファイルSKILL.md1.5 KBViewagents/openai.yaml0.1 KBView