retro

Retro

セッションのトランスクリプトをレビューします。どの程度うまく進んだか、時間をどこに使ったか、次回に向けて何を変えるべきかを報告します。

ルール

1. デフォルトでは現在のセッションを対象にします。 最新のファイルではなく、このセッションの ID で特定します。並行して実行中のセッションは同じプロジェクトフォルダーを共有します。代わりにセッション ID またはトランスクリプトのパスを指定することもできます。サブエージェントのトランスクリプトも含めます。その作業も対象となるためです。OpenCode はセッションをデータベースに保存するため、対応していないと伝えてください。

2. 読む前にトランスクリプトを要約します。 トランスクリプトは数メガバイトに及び、その大部分をツールの出力が占めます。短いタイムラインを作成します。各ユーザープロンプトと、各ツール呼び出しの時刻、所要時間、入力、エラーを抽出します。エラーの確認に必要な場合に限り、結果全体を読みます。

3. 各フェーズの時間を計測します。 フェーズは、理解、実装、テスト、レビュー、その他（git、CI、デプロイ）です。あるフェーズは、次のフェーズが始まるまで続きます。ユーザーを待っている時間はエージェントの作業時間ではありません。別途報告してください。ユーザーへの質問や許可を求めるプロンプトも、ユーザーを待つ時間に含めます。バックグラウンドタスクは呼び出し時の表示より遅れて完了するため、完了通知を使ってください。この Retro 自体の呼び出しは除外します。

4. 理由のない遅いチェックの再実行を指摘します。 遅いチェックとは、Playwright、e2e、統合テスト、全テストスイート、CI の監視です。対象となるコードに変更がない場合、またはより範囲の狭いチェックで修正を確認できた場合、再実行は無駄です。関連する変更後の再実行は問題ありません。

5. ツール呼び出しのエラーを原因別にまとめます。 例：不正なパス、不正な引数、アクセス拒否、コマンドが見つからない。変更せずに再試行して失敗した呼び出しは、特に重要です。

6. 労力が無駄になった箇所を特定します。 次の点を確認します。

   • スキルの手順が無視されていないか、またはスキルの手順が無駄を招いていないか
   • 同じ情報を何度も調べていないか
   • 検索で済むのにファイル全体を読んでいないか
   • 独立した呼び出しを一つずつ実行していないか
   • 小さなタスクにサブエージェントを使っていないか
   • ユーザーからの訂正（「いいえ」「そう言ったのではなく」「もう一度」）

   それぞれについて、変更すべきスキル、指示ファイル、または習慣を明記します。

7. 報告のみを行い、編集はしません。 何を変更するかはユーザーが決めます。

8. エージェントの作業時間に占める無駄な時間の割合で評価します。 A：なし。B：10%未満。C：10～25%。D：25～50%。F：50%超、またはタスク失敗。

9. 指定の形式で回答します。 指摘事項にはすべてタイムスタンプを付けます。該当する項目がないセクションは省略します。セッションが問題なく進んだ場合は、その旨を1行で伝えます。指摘事項を捏造してはいけません。

   Session: <id> (<harness>), <start>–<end>, <agent time> agent / <user wait> user wait
   Grade: <A–F> — <one-line reason>
   
   Time by phase
   | Phase | Time | % | Notes |
   
   Wasteful verification
   - <suite> run <N>× (<total>) at <times> — <why wasteful>; saves ~<time>
   
   Tool-call errors
   - <N>× <cause> at <times> — <fix>
   
   Improvements
   1. <file or skill>: <one-line change> — <evidence>