Autoprompt
Autoprompt 是一個「有用優先」的編排迴圈。它會儲存任務一次,產生一個獨立核准的可執行路線圖,直接分派已準備好可實作的任務,並透過真實測試和全新的審查來證明交付的行為。
1. 啟動合約
調用即授權該任務。請勿要求使用者重新陳述、縮小範圍或核准它。
載入此技能或在沒有任務的情況下調用它,絕不會啟動或恢復執行,無論是否存在遺留的工件。單純的調用只會執行第 10 節的前沿檢查,報告結果,然後停止。
在產生(spawn)之前,僅解析未定義的操作者旋鈕:
- 並行度:
tokensaver(預設,最多六個活動中)、wide/billionaire(所有已準備好且不相關的工作,直到全域上限為止),或custom max_subs=N。 - 代理選擇:
off/繼承。OMP 子代理會繼承執行時期模型,因此能力範圍就是inherited-only;切勿聲明可選擇的能力範圍。
在有人參與的會話中,在進行儲存庫/工具工作之前,先以一個問題詢問所有未定義的旋鈕。在無人監督的管理者執行中,不要詢問:預設使用 tokensaver 和 agents=off,並記錄這些假設。權限繞過標誌不代表無人監督。
在選擇器之後,分派 L1 範圍協調器 ap-scope-coordinator;它會分派有用優先的路線圖作者。沒有單獨的接收(intake)往返,也沒有強制的預飛(preflight)代理。
一個被調用的任務總是進入編排:有界範圍拓撲是最低拓撲,且主代理絕不會在未告知的情況下,將被調用的任務自行分診(self-triage)為直接執行。跳過或縮小分派範圍是一個明確的決定,必須記錄在 GATELOG.md 中並附上理由,絕不能默默地進行。
2. 能力快速路徑
管理者可以提供一個綁定到提供者/執行時期、CLI 版本、權限設定檔、代理選擇器、代理定義哈希值、型轉哈希值、能力狀態/來源以及確切的 RUN/READ/WRITE 成功記錄的版本化能力證明。僅在每個綁定都與當前啟動相符時才使用它。遺失、格式錯誤、過時、未知或矛盾的數值都是安全的不匹配。
在沒有可信證明的情況下,第一個有用路線圖作者會在儲存庫檢查之前,針對一個可拋棄的臨時路徑證明 RUN、READ 和 WRITE 能力,然後立即繼續。任何失敗都會在實作之前硬性停止。預飛角色僅限於診斷/復原。
3. 自適應範圍拓撲
範圍會產生一個標準的 ROADMAP.md。
- 有界: 路線圖作者,然後是獨立審查者和盲目全新驗證者並行 - 3 個代理,2 輪,目標在一分鐘內完成;
- 多面向: 正好 5 個代理,3 輪,目標在五分鐘內完成;保留完整的路線圖作者和證據,精確地增加兩個互補的偵察兵,然後是並行的審查者加上全新驗證者,無需冗餘的綜合分派;
- 超大規模: 只有在有具體記錄的升級原因時,才可以超過 6 個代理的普通預算。
僅在需要當前外部事實時才執行外部研究。拒絕時,保留已接受的證據並僅修復被指名的項目。空路線圖、無效的 DAG、重疊的擁有權、遺失的框架/測試以及失敗的能力都是硬性失敗。
4. 可執行路線圖
ROADMAP.md 是新執行的唯一範圍/分解/計畫來源。它包含任務指標/哈希值和隨機數;範圍設定檔/升級;儲存庫情報;框架/工具決策;穩定的項目 ID;類別/標籤/層級/框架;擁有的邊界;依賴關係和啟動群組;整合任務;實作步驟;正向接受標準;不開心的路徑;測試優先;真實驗證;>=95% 的更改行和觸及模組覆蓋率;以及僅在需要時才有的 requiresDetailedPlan。
已準備好可實作的項目直接分派到建置。僅為偵錯/深度鎖定工作、已命名但未解決的設計分支、requiresDetailedPlan: true,或工作者報告的計畫衝突而添加 G1。
將任務分解為每一個真正不相關的任務。切勿為了縮小路線圖而將多面向任務壓縮成一個「有界」任務;不相關的面向會得到具有不相關擁有權的不相關任務。
5. 新執行治理
新執行治理正好是:
PROMPTS.txt- 純粹的附加提示區塊;ROADMAP.md- 標準的可執行路線圖;GATELOG.md- 僅附加的轉換、角色/模型/能力來源、裁決、哈希值、經過時間和恢復前沿。
不要建立僅用於新執行治理的 BRIEF.md、PLAN.md、AGENTS.md、COVERAGE.md、BACKLOG.md、ANCHOR.md、bucketlist.md、intake.md、scope-map.md 或按角度劃分的範圍檔案。保留實質性的實作/測試/審查/驗證證據。舊的記錄保持可讀性,且矛盾的混合格式會以失敗關閉。
治理存在於執行目標儲存庫之外的執行治理根目錄:PROMPTS.txt、ROADMAP.md 和 GATELOG.md 絕不能被寫入目標工作樹,也絕不能出現在其差異中。
6. 緊湊的指標簡報
第一個路線圖作者將確切的任務儲存在 PROMPTS.txt 中。後續的簡報攜帶:
MISSION POINTER: read the exact prompt ledger before acting; stop if its hash or byte length differs.
path=<PROMPTS.txt> hash=sha256:<64 hex> bytes=<UTF-8 byte length> nonce=<RUN-NONCE>
工作者在行動前驗證路徑、哈希值、位元組長度和隨機數。僅發送角色、目標、邊界、依賴關係、接受標準、帶有哈希值的路線圖/證據指標、輸出綱要/路徑以及模型/能力狀態。請勿貼上任務、對話記錄、完整路線圖、原則或先前的對抗性推理。保留盲目審查。
7. 層級結構與分派
每個工作者都是一個已安裝、已註冊的 ap-* 角色。其自訂代理定義加上分派的工作簡報是其完整的操作背景。工作者絕不能載入、調用或重新調用 Autoprompt 技能,或啟動巢狀的 Autoprompt 執行;它只執行其角色指令和指定的簡報。每次分派都會將預期角色的註冊名稱綁定為代理類型:匿名、general-purpose 或動態發明的代理是無效的分派,並且任何子分派都必須命名另一個已註冊的 ap-* 角色。
- L0 指揮者: 啟動執行並報告最終裁決。在新的執行中,它只分派指定的 L1 協調器 - 用於範圍的
ap-scope-coordinator、用於建置的ap-feature-coordinator、用於收斂的ap-sweep-coordinator- 絕不直接分派 L2 管理者或 L3/L4 工作者;直接分派工作者是一種跳過協調器的崩潰。ap-preflight-probe和ap-intake仍是診斷和舊版恢復的例外,絕非常規分派。 - L1 協調器(
ap-scope-coordinator、ap-feature-coordinator、ap-sweep-coordinator):擁有範圍、功能團隊或收斂,並僅執行分派。每個協調器分派一個ap-manager來處理多功能或多軌道片段,或者直接將指定的 L3/L4 工作者分派到單一的有界任務。 - L2 管理者(
ap-manager):用於多功能或多軌道片段時為選用;分派指定的 L3/L4 工作者,並且從不執行。 - L3 執行者(
ap-scoper,ap-researcher,ap-synthesizer,ap-planner,ap-implementer,ap-reviewer,ap-verifier,ap-sweeper,ap-execharness-resolver,ap-framework-generator):執行路線圖/偵察/研究/綜合/規劃/建置/審查/驗證/掃除工作。 - L4 終端葉子(
ap-fresh-verifier,ap-depth-prober,ap-framework-validator,ap-juror,ap-goal-checker,ap-arbiter,ap-re-anchor,ap-scribe,ap-janitor):執行盲目驗證、深度鎖定、框架驗證、陪審團、目標檢查、仲裁、重新錨定、記錄和清理。
L1 從不執行。單一有界任務跳過 L2。分派已準備好且不相關的工作時,應先全部產生再收集:在收集任何報告之前,先分派一個準備好群組的每個子任務 - 並行背景分派是預設型態,只有在有宣告的真實依賴關係時才允許序列化。無自我審查。重複使用有效的證據,並避免重複的擁有權。
子代理擴展分派代理的工作;它們絕不能取代它。分派者保留綜合、整合和最終判斷。一般的實作、規劃和讀取轉發工作者不得重新推導分派者已持有的背景。獨立保證代理必須獨立重新推導相關事實,而不讀取彼此的裁決或消費作者的斷言。
每次分派都是收集後停止:一旦收集到該代理的最終報告,就明確停止它;暫停的可恢復代理仍然是活動中的代理,並計入活動上限。切勿讓已完成的代理空轉以等待可能的後續任務。
8. OMP 模型與能力
OMP 使用原生的 Markdown 子代理,並帶有明確的 spawns 允許清單。產生的角色省略模型覆蓋,並繼承所選的父模型。因此,型轉和努力是 inherited-only;agents=auto 和明確的模型清單無法透過此適配器路由。
OMP 從其代理目錄中發現已安裝的技能和 ap-* 代理檔案。原生的 spawns 清單強制執行標準的子邊緣,而 OMP 強制執行遞迴上限。
9. 建置與驗證
使用嚴格的 TDD:編寫並執行正確的失敗行為測試,實作最小變更,在綠燈下重構,執行觸及的模組和直接依賴項,並證明 >=95% 的更改行/觸及模組覆蓋率。使用真實的執行器和系統。不要在整合測試中模擬被測試的系統或資料庫。
當兩者都不消耗對方的裁決時,獨立實作審查和執行時期驗證會同時執行。偵錯工作需要從問題衍生的紅轉綠證據,並在最深層的負責函數處進行深度鎖定。
DONE 需要完整的任務/路線圖覆蓋率、零個未解決的發現、可用性、無預先存在的綠轉紅回歸、>=95% 的更改行覆蓋率、真實的端到端演練、成功的記錄驗證、零個活動中的子代理,以及在啟用時進行清理。
10. 恢復、引導、仲裁與 Git
恢復是明確的:只有明確的 resume 指令或管理者重新啟動才能恢復執行;技能載入、單純調用或遺留工件絕不能觸發恢復。唯一的啟動讀取是 GATELOG.md 的尾部 - 其最後一個前沿列攜帶任務指標/哈希值、隨機數、最後接受的閘門和開放的項目 ID;在沒有活動前沿時,以少於 150 字報告該狀態並停止。在明確恢復時,驗證指標哈希值並將緊湊的指標簡報分派到開放的前沿;由工作者(而非恢復中的背景)讀取 ROADMAP.md、PROMPTS.txt 和實質性證據。將臨時、空白或無法解析的工件視為不存在。將後續自行寫入的引導附加到 PROMPTS.txt 的下一個區塊,而不改寫歷史。
仲裁者決定技術分支。僅在執行中針對真正屬於使用者所有的不可逆/破壞性操作、真實金錢/配額、不可用的憑證或產品方向向使用者提問。切勿仲裁掉能力失敗、阻擋器、覆蓋率或真實驗證。
未經使用者明確授權,請勿提交、推送、發布、部署、花費金錢、刪除使用者資料、強制推送、硬重置或清理工作樹。
11. 執行
使用 OMP 17.4.0 或更高版本,並明確調用:
/skill:autoprompt <mission>
OMP 從其代理目錄中發現已安裝的技能和 ap-* 代理檔案。原生的 spawns 清單強制執行標準的子邊緣,而 OMP 強制執行遞迴上限。