概要
ChatGPTで検討した内容をCodexで実装するなど、AIエージェント間で作業を引き継ぐときは、GitHubのissueにまとめてもらうと手軽です。ただ、仕様や実装方針は残っても、目的や背景は抜けがちです。そこで、それらを「Goal Context」として分けて書くためのプロンプトを作りました。
最初に結論まとめ
プロンプトはパブリックリポジトリに置いてあるので、URLを渡して「このフォーマットでissueを作って」と言えば使えます。次のURLです。
https://github.com/suusanex/coding_agent_plan_and_verify_process/blob/main/apm-packages/goal-context-authoring/.apm/skills/goal-context-authoring/references/generation-prompt.md
AIエージェントへの引き継ぎ用issueに「Goal Context」を残す
少ないAIエージェントの利用枠をやりくりしていると、ChatGPTで検討したものをCodexで実装する、といった引き継ぎがどうしても発生すると思います。
上位プランで最初から最後までAstraにやらせる、みたいな富豪の人はスルーしてください。
GitHubを使っているなら、こうした引き継ぎには、やはり「issueを作って」と頼むのが手軽でしょう。ただ、単にそう指示するだけだと、引き継ぎたい情報が抜けてしまうことがあります。
仕様は残っても、目的や背景が抜けがち
AIエージェントにissueの作成を頼むと、具体的に決まった仕様や実装方針は手厚く書いてくれがちです。一方で、「なぜその方式に決定したのか」「そもそも何をやろうとしていたのか」といった、目的や背景（目的の理由や事情）の情報は失われがちです。
すると、実装後になって目的と違うことに気付き、振り返ると実は「issueの時点でズレが始まっていた」となりがちです。
これを防ぐには、issueを作るときに、目的や背景を手厚く書くのがよいと感じました。そこで、そうしたissueを安定して作るためのプロンプトを作成しました。
目的や背景を「Goal Context」として分けて書く
フォーマットとしては、目的や背景の情報を「Goal Context」と名付けて書き、それとは別の章に、検討して決めた仕様や方式などを書く形です。
プロンプトはパブリックリポジトリに置いてあるので、URLを渡して「このフォーマットでissueを作って」と言えば使えます。
最近使っている定番のプロンプトはこちらです。
ここまでの内容を、次のフォーマットでまとめてください。
https://github.com/suusanex/coding_agent_plan_and_verify_process/blob/main/apm-packages/goal-context-authoring/.apm/skills/goal-context-authoring/references/generation-prompt.md
まとめたものをそのまま使って、issueを作成してください。設計・実装向けに補足しておくべき情報がある場合は、その後に別の見出しを付けて追記してください。
まとめ
この「Goal Context」があると、最初のチャットまで戻らなくても、目的や背景が分かります。後段のAIエージェントもズレづらい気がしますし、あとから「この目的に合っていたか」をレビューする際にも使いやすいです。
手軽に使えて、失敗してもissueを書き直すだけなので、使ってみる価値はあると思います。よかったらどうぞ！