開始之前

本指南使用 Twitter 範例 twitter-starter 來建置一項功能：分享一個下方附有文字的巨大 emoji。你會直接向 agent 描述你要的內容、追蹤它的工作，並審查完成的結果。同樣的工作流程也可用於其他功能，或你想修正的錯誤。

安裝 Panolayer、登入，然後開啟 Twitter Clone 範例。如果你還沒開啟過任何儲存庫，請參閱安裝與設定 Panolayer。
使用內建的 Panolayer Agent。你也可以使用其他支援的 agent，但需先安裝才能使用。設定方式請參閱支援的 agent。

最後你會得到一筆已審查的變更，記錄在本機的 Git 歷史中。推送到遠端則是另一個步驟。

啟動 Panolayer Agent

在側邊欄開啟 我的 Agent。
按一下 監控 Agent 旁的 + 按鈕，開啟 agent 選單。
本逐步教學請選擇 Panolayer Agent。

選單包含 Panolayer Agent 以及你已安裝的 agent。你可以任選其一來修正錯誤或建置程式碼。

Twitter 範例的「我的 Agent」頁面，監控 Agent 旁有加號按鈕，且其選單已展開，顯示 Panolayer Agent 與已安裝的 coding agent。 — 按一下監控 Agent 旁的 +，然後選擇 Panolayer Agent 或你已安裝的其他 agent。

Panolayer Agent 的運作方式與你慣用的 coding agent 相同。 請它建置功能、修正錯誤，或回答關於你程式碼的問題。在 與你的程式碼庫對話，或建置些什麼… 中輸入你的需求，並在工作過程中持續對話。

從 issue 開始？ 在 Issues 中選擇修正，然後選取 Panolayer Agent。Panolayer 會把 issue 的脈絡帶入任務中。這條路徑請參閱第一個錯誤的逐步教學。

交派一個結果明確的任務

描述哪裡有問題，或你想建立什麼、成功運作時應該發生什麼，以及代理應保留哪些內容。若你知道檔案或函式名稱，請一併指明。

以 Twitter 範例來說，請使用截圖中顯示的相同請求：

add a new feature where you can share a giant emoji with text underneath

將請求輸入訊息框，然後按一下傳送箭頭。

Panolayer Agent 在 Twitter 範例中，訊息框已輸入新增可分享巨大表情符號並在下方附上文字的請求，準備傳送。 — 描述你想建立的功能。此請求要求提供一個下方附有文字的巨大表情符號。

Panolayer Agent 在工作時可以使用程式碼地圖找出相關函式與關聯。即使你不知道每個檔案名稱，也能指出你關心的行為。

如果代理提出問題，請在同一段對話中回答。如果你需要縮小任務範圍，請說明你想要的具體結果。

追蹤工作進度，同時保留你的工作區

當 Panolayer Agent 開始一次程式撰寫執行時，進度會顯示在對話中。程式撰寫工作會在隔離的 Git worktree 中進行：這是一個獨立的簽出，代理可在其中編輯與測試程式碼，而你的主要工作區仍保持可用。

在對話中觀看任務

執行卡片會顯示任務與目前活動，同時代理正在建立巨大表情符號功能。你可以追蹤進度，並查看它在工作時使用的檔案與命令。

開啟執行以查看更多詳細資料

在卡片右側選擇開啟，即可查看該執行的活動。在串流中選取一項活動，即可在右側面板檢查命令及其輸出。使用 返回代理 回到對話。

在串流中開啟的「新增巨大表情符號並附上標題」執行，顯示即時活動，以及右側面板中選取命令及其輸出。 — 開啟會顯示進行中的「新增巨大表情符號並附上標題」任務。選取項目即可檢查執行了什麼以及傳回了什麼。

查看執行何時完成

工作完成後，卡片會更新為 子代理執行完成。完成橫幅會摘要檢查結果與變更的檔案數。你仍可選擇開啟來檢查已完成的執行。

Panolayer Agent 對話顯示巨大表情符號任務為子代理執行完成，並有完成橫幅、通過的檢查、16 個變更檔案，以及開啟按鈕。 — 完成的巨大表情符號任務會出現在對話中，其結果與變更檔案的證據可供檢閱。

你可以繼續工作，稍後再回到該執行。當有多個代理在工作時，使用 監控代理 取得總覽。多個代理可以在各自的工作樹中處理同一個儲存庫；合併前請檢閱它們的變更如何整合。

讓後續訊息與其任務保持連結。 傳送後續訊息時，請使用對話中顯示的執行參照，以便清楚知道你指的是哪個任務。

檢閱驗證結果

合併前，請一併檢閱變更的程式碼與驗證結果。完整的代理變更檢閱指南，請參閱檢閱變更並提交。

當代理請求合併時，請閱讀驗證摘要：通過的規則、驗證執行次數與變更的檔案。請將新增的失敗與原本就存在的問題分開檢閱。

Panolayer Agent 的 giant-emoji 功能待合併對話框，顯示 121 條規則中有 110 條通過、一次驗證執行、16 個檔案變更，以及展開的 Details 摘要。 — giant-emoji 功能已完成，正等待你核准合併。Details 會說明變更內容以及代理如何檢查。

在這次執行中，摘要顯示 121 條規則中有 110 條通過、1 次驗證執行與 16 個檔案變更。它另外標示出 11 項先前即存在的失敗，並回報沒有新的失敗、警告或未檢查的規則。你的總數會依你的任務而有所不同。

開啟 Details 以進一步探究結果。摘要欄位與狀態的說明，請參閱瞭解驗證結果。

當任務需要時，請在執行中的應用程式裡檢查行為。以本例來說，試著建立一則帶有巨大表情符號、下方附有文字的貼文，然後確認一般文字貼文仍能如預期運作。

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.