開始する前に
このガイドでは、Twitterの例twitter-starterを使って、機能を構築します。巨大な絵文字をその下のテキストとともに共有する機能です。作りたい内容をagentに直接伝え、agentの作業を追い、完成した結果をレビューします。同じワークフローは、別の機能や修正したいバグにも使用できます。
- Panolayerをインストールしてサインインし、Twitter Cloneの例を開きます。まだrepositoryを開いていない場合は、Panolayerのインストールとセットアップを参照してください。
- 組み込みのPanolayer Agentを使用します。ほかにサポートされているagentも使用できますが、使用前にインストールする必要があります。セットアップについてはサポートされているagentを参照してください。
最後には、レビュー済みの変更がローカルのGit履歴に記録された状態になります。リモートへのプッシュは別の手順です。
Panolayer Agentを開始
- サイドバーで My Agents を開きます。
- Monitor Agents の横にある + ボタンをクリックして、エージェントメニューを開きます。
- このウォークスルーでは Panolayer Agent を選択してください。
メニューには Panolayer Agent と、インストール済みのエージェントが含まれています。バグの修正やコードの構築に、これらの中から任意のエージェントを選択できます。
Panolayer Agent は、既にお使いのコーディングエージェントと同様に動作します。 機能の構築、バグの修正、またはコードに関する質問への回答を依頼してください。Chat with your codebase or build something… にリクエストを入力し、作業を進めながら会話を継続できます。
Issue から開始する場合： Issues で Fix を選択し、Panolayer Agent を選択してください。Panolayer は Issue のコンテキストをタスクに引き継ぎます。その手順については first-bug walkthrough を参照してください。
結果が明確なタスクを渡す
何が問題か、または何を作りたいのか、正常に動作したときにどうなるべきか、agent が保持すべき事項を説明してください。ファイルや関数が分かっている場合は、その名前を指定してください。
Twitter の例では、スクリーンショットに示されている同じリクエストを使用してください：
add a new feature where you can share a giant emoji with text underneath
メッセージボックスにリクエストを入力し、送信矢印をクリックしてください。
Panolayer Agent は、作業中にコードマップを使用して関連する関数と関係を見つけることができます。すべてのファイル名を把握していなくても、重視する動作を指定できます。
agent が質問してきた場合は、同じ会話で回答してください。タスクを絞り込む必要がある場合は、求める具体的な結果を伝えてください。
ワークスペースを維持したまま作業を追う
Panolayer Agent がコーディング実行を開始すると、その進行状況は会話に表示されます。コーディング作業は分離された Git worktree で行われます。これは別のチェックアウトで、agent がコードを編集およびテストしている間もメインワークスペースを利用できるようにします。
会話でタスクを確認する
実行カードには、agent が巨大絵文字機能を構築している間のタスクと現在のアクティビティが表示されます。進行状況を追い、作業中に使用しているファイルやコマンドを確認できます。
実行を開いて詳細を確認する
カードの右側にある 開く を選択すると、実行のアクティビティを確認できます。ストリーム でアクティビティを選択すると、右側のパネルでコマンドとその出力を検査できます。agentに戻る を使用すると会話に戻ります。
実行が完了したことを確認する
作業が完了すると、カードは サブagent実行完了 に更新されます。完了 バナーには、チェックと変更されたファイル数がまとめられます。完了した実行を検査するには、引き続き 開く を選択できます。
作業を続けて、後で実行に戻ることができます。複数の agent が作業している場合は、agentを監視 で概要を確認できます。複数の agent が同じ repository の別々の worktree で作業できます。マージする前に、それぞれの変更がどのように組み合わさるかを確認してください。
フォローアップはタスクに紐づけてください。 フォローアップを送信するときは、会話に表示される実行参照を使用して、どのタスクを指しているのかを明確にしてください。
検証結果を確認する
マージする前に、変更されたコードを検証結果と併せて確認してください。agent の変更を確認するための完全なガイドについては、変更を確認して commit する を参照してください。
agent がマージを要求したら、検証サマリーを確認してください: 合格したルール、検証実行、変更されたファイル。新たに発生した失敗は、既に存在していた問題とは別に確認してください。
この実行では、サマリーに 121 件中 110 件のルール合格、1 回の検証実行、16 個の変更ファイル が表示されています。11 件の既存の失敗 を別途特定し、新しい失敗、警告、未チェックのルールは報告されていません。合計値はタスクによって異なります。
結果をさらに調査するには、詳細 を開いてください。サマリーのフィールドとステータスについては、検証結果を理解する を参照してください。
タスクで必要な場合は、実行中のアプリで動作を確認してください。この例では、巨大絵文字とその下のテキストを含む投稿を作成し、通常のテキスト投稿が引き続き期待どおりに動作することを確認してください。
Merge when you’re ready
You decide what moves from the agent’s worktree into your branch. Choose Not now to keep reviewing. Once you’re satisfied with the changes and results, confirm the target branch and choose Merge into main for the Twitter sample.
The Merged into main confirmation shows a commit ID. This workflow records the change in local Git history, so you don’t need to commit that same change again.
Open Changes and find the commit in History. Check for unexpected uncommitted edits. If your repository has a remote and you want to share the commit, use Git → Push.
You’ve given an agent a task, followed its work, reviewed the result, and decided what reaches your branch.