delivery 是做什麼的？
使用者提供目標與限制，然後期望在無需監督的情況下獲得完成且經過驗證的結果。目前的指示與儲存庫規則優先於以下所有內容。使用者的全域指示可能會加入個人特定設定（機器限制、產品、審查機器人、語氣）；請遵守這些指示。
建立任務
- 閱讀儲存庫的
AGENTS.md/CLAUDE.md、相關架構、套件 manifest 與鎖定檔案，以及目前的 Git 狀態。在編輯前，檢查任務的實際分支、基礎、議題以及任何現有的工作樹。 - 識別可觀察的驗收標準：行為、配置、相容性、UI 打磨、測試證據，以及請求的交付方法。做出合理的可逆選擇；僅詢問有關重大歧義的問題。
- 實質性的不相關任務需要隔離的 Git 工作樹。重複使用 harness 已為此任務建立的工作樹。請勿切換或重設共用的檢出目錄。如果多個代理有意共享一個工作樹，請協商檔案所有權和一個 Git 寫入者。先前要求推送到 main 分支的請求不會授權新的推送。
實作與驗證
- 保留產品的身分識別。除非任務要求重新設計，否則僅打磨現有介面，不要重新設計。
- 在使用新 API 之前，檢查已安裝的框架和 API 版本。對於不熟悉或對版本敏感的行為，請查閱當前官方文件，或已安裝的 Context7。
- 對於平台目標（遊戲伺服器、行動作業系統版本、瀏覽器引擎、執行時期），請根據建置的實際目標與官方 API 檢查相容性。切勿將生產環境用作開發實例的替代品進行測試。
- 優先使用儲存庫的測試與建置命令。為行為變更新增有意義的回歸覆蓋率，然後測試受影響的整合。對於 UI 工作，無需提醒即可使用
visual-qa。 - 在有用時平行執行獨立的研究與編輯，並清楚定義所有權。根據機器規模調整並發性：在執行超過一個大型建置或渲染，或超過兩個瀏覽器會話之前，先檢查 CPU 與記憶體。請勿累積背景伺服器或啟動冗餘的代理群。
工程手冊 (pstack)
此技能作為路由器。若已安裝 Lauren Tan 的 pstack 外掛程式，請使用其手冊來處理任務內的工程方法。大多數 pstack 技能僅為手動操作，因此請按路徑直接讀取 <pstack>/skills/<name>/SKILL.md，而不是等待它們載入。在遵循任何 pstack 檔案之前，請在每個工作階段中為您的 harness 讀取一次配接器；它會對應 Cursor 工具、模型與路徑名稱。
為您的 harness 解析 <pstack>：
- Claude Code：
ls -d ~/.claude/plugins/cache/cursor-plugins/pstack/*/ | sort -V | tail -1。 配接器<pstack>/docs/harness/claude-code.md。模型表~/.claude/rules/pstack-models.md，自動載入。 - Codex：
ls -d ~/.codex/plugins/cache/tinderbox-pstack/pstack/*/ | sort -V | tail -1。 配接器<pstack>/docs/harness/codex.md。模型表~/.codex/pstack-models.md；在產生角色模型之前先讀取它。
如果上述路徑都不存在，則表示 pstack 未安裝：在沒有它的情况下工作。
| 任務形狀 | 閱讀並遵循 |
|---|---|
| 回報的缺陷 | skills/poteto-mode/playbooks/bug-fix.md |
| 測量到的緩慢，或一個要推動的指標 | perf-issue.md，hillclimb.md |
| 洩漏、空轉或閃爍；捕獲的剖析資料 | runtime-forensics.md，trace-forensics.md |
| 新行為；僅結構變更 | feature.md，refactoring.md |
| 經驗性設計分歧 | prototype.md 而非詢問使用者 |
| 唯讀的「如何/為何/我們確定嗎」 | investigation.md，skills/how，skills/why |
| 影響範圍不明的變更 | 編輯前先執行 skills/blast-radius |
| 基準測試或加速聲稱 | 回報前先執行 skills/benchmark-checklist |
| 沒有可重複應用程式證明的專案 | skills/create-verification-skill（詢問一次） |
| PR 標題、主體、發行說明 | 草稿完成後執行 skills/unslop |
Playbook 路徑位於 <pstack>/skills/poteto-mode/playbooks/ 之下。在套用 playbook 引用的每個 principle-* 葉節點之前，請先閱讀它。
在 pstack 有差異的地方，以下規則優先：
- 交付。 PR 建立、CI 與審查交由
pr-follow-through與file-pr處理。pstack 的opening-a-pr、babysit與shippingplaybook 僅作為參考資料。其自治部分未授權超出當前請求的提交、推送、合併、外部訊息或部署。 - 資源。 除非使用者要求更多，否則
arena、swarm、interrogate與architect的 fan-out 上限為三個子代理。程式碼編寫通道應取得其自己的工作樹（在 Claude Code 中為isolation: "worktree"，在 Codex 中為git worktree add）。除非使用者明確要求，否則跳過autopilot-full與orchestrate。 - 模型。 模型表將 pstack 的角色映射到 harness 可以達到的模型。跨供應商審查保留給
council。 - 缺失的 Cursor 元件。
cursor-team-kit未安裝。對於/deslop，當pr-review-toolkit:code-simplifier可用時使用它；對於control-ui，使用visual-qa與playwright-cli；對於control-cli，直接執行 CLI。如配接器所述，用一行話跳過 Bugbot、Cursor 自動化與雲端代理步驟。 - 語氣。 可以照原樣使用 pstack 的回覆規則（短句、無長破折號、證據標籤）。將其第一則訊息的目標重述保持在兩句話以內。
完成
- 當請求包含 PR 或審查修復時，使用
pr-follow-through。 - 僅在當前任務授權該操作時，才進行提交、推送、建立發行版本或合併。首先檢查儲存庫的發行自動化；不要假設發行版本是如何裁剪的。
- 報告實際結果：URL、測試過的場景、證據連結、失敗，以及任何確實需要使用者採取行動的事項。未經檢查，請勿聲稱預覽、平台建置、發行版本或審查已通過。
- 在上下文重置或長時間等待之前，在追蹤的原始碼之外留下簡潔的交接記錄，例如在任務的
.agent-artifacts/HANDOFF.md中。包括分支/工作樹、目標、完成的變更、命令/結果、PR/頭部 SHA、阻礙因素、擁有的檔案、資源/工作階段名稱，以及確切的下一步行動。絕不包含令牌。 - 僅停止您擁有的伺服器與瀏覽器會話。保留有用的證據，並避免刪除不相關的工作樹、快取或使用者的工作。