melech-plan-review

プランのレビュー

承認する前に、このソリューションで何が変わるのかを予測できるようにします。PR の準備が整い、変更タブを確認しているかのように、Git の差分のような赤と緑の行が並ぶファイルツリーで、変更内容と想定されることを示します。

ページを見るのは、プランを確認する人やプロダクトの読者です。コードを詳しく調べるつもりはありません。

ファイルの各部分には、青色の @@ section @@ 行を付けます。差分と同じようにインデントします。動作が要点なら、文章で説明します。文章より短いコード行のほうが読みやすければ、コード行を使います。周辺の実装は貼り付けないでください。

レビュー用に開く

template.html を <plan-name>-plan-review.html という名前でプランファイルの隣にコピーします。プランがチャット内にしかない場合は、リポジトリのルートにコピーします。すべての {{TOKEN}} を埋めてください。

このファイルの隣にある scripts/review_server.py を使って、バックグラウンドで配信します。

python3 <skill-dir>/scripts/review_server.py <plan-name>-plan-review.html

ページが開き、URL とレビュー用ファイルのパスが表示されます。読者がコメントを書くと、コメントはページの隣にある <plan-name>-plan-review.json に保存されます。

判定を待つ

「承認」「コメントあり」「却下」の3つの選択肢で、質問を1つしてください。質問ツールがあれば、それを使ってください。なければチャットで質問し、ターンを終了します。

回答が届いたら、レビュー用ファイルを読みます。ファイルには全体の summary と comments が含まれています。各コメントには body と、コメントが指す場所を示す places が含まれます。places には file、lines、選択された quote があります。1つのコメントが複数の行、または複数のファイル内の場所を指すことがあります。file が null の場合は、ページのヘッダーを指します。

• 承認：プランは確定です。コメントがあれば反映し、その後サーバーを停止します。依頼されない限り、実装は始めないでください。
• コメントあり：チャットで各コメントに回答し、コメントで求められた箇所はプランを変更して、ページを書き直します。レビュー用ファイルの名前を <plan-name>-plan-review-<round>.json に変更し、タブを更新するよう依頼して、もう一度尋ねます。
• 却下：却下の理由をコメントから確認します。コメントがなければ、何が問題なのかを尋ねます。方向性が明確になるまでページを書き直さないでください。サーバーを停止します。