Communitygithub.com

Renn-Labs/Looptimal

Looptimal — 將目標轉化為已交付、已驗證的成果:密封的驗收套件、正確的循環、兵棋推演通過、領域專家執行(製作者 != 檢查者),以及一個獨立的驗證器。內含循環設計精靈(前身為 LoopPrint)。

Looptimal 是什麼?

Looptimal 是一個為 AI 代理(如 Claude Code, Cursor, Codex)設計的專業技能,旨在將模糊目標轉化為可證明、可驗證的交付成果。它的核心原則是「製作者不等於檢查者」(Maker != Checker),透過一個 8 階段的管道來運作:從框架化(Frame)、分析(Analyze)、設計循環(Design-loop)、規劃(Plan)、模擬(Simulate),到最終由獨立的驗證器(Verifier)重新執行密封的驗收套件來確認成果,而非依賴代理自身的「綠色」聲明。此技能特別適合非瑣碎、需要多領域專業知識或需要嚴格驗證的工作,例如需要領域專家執行和獨立驗證的任務。它也提供了一個「設計快徑」(design fast-path),讓使用者只需產出循環藍圖,無需完整編排。Looptimal 支援多種模式,包括一次性交付(single-pass)、有界迭代(mission/goal-run)和循環模式(recurring loop),並透過決策關卡(Decision Gate)在開始實質工作前判斷最適合的路徑,避免資源浪費。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add Renn-Labs/Looptimal

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Looptimal — 成果編排器

將目標轉化為已交付、已驗證的成果:密封驗收標準、選擇或拒絕正確的循環、兵棋推演計畫、由領域專家執行,並在完成時由一個獨立的驗證器根據即時狀態重新執行密封套件來把關 — 絕不依賴自我報告的 GREEN。

循環設計精靈(前身為獨立的 LoopPrint)已嵌入為第 2 階段:設計循環。當您只需要循環藍圖而無需成果編排時,它也可以作為 design 快徑執行。

使用時機

  • 觸發詞:"looptimal", "/looptimal", "run an outcome loop", "orchestrate this objective to done", "plan and ship this goal"。
  • 一個非瑣碎的目標,其中「完成」必須針對即時狀態證明,而不是由執行工作的代理自行斷言。
  • 需要能力清單、共識計劃以及製作者 ≠ 檢查者(在成果層級)的多領域工作。
  • 重複性、監督性、棘輪性或編排模式 — 在設計循環確認這確實是一個循環之後。
  • 您希望在自主執行之前,透過模擬(Simulate)來兵棋推演計劃。
  • 一個單一、非瑣碎的目標,您希望交付一次並針對即時狀態證明。如果需要有限制的迭代,請將其設定為任務/目標運行;如果一次謹慎的傳遞就足夠,請使用單次傳遞模式(請參閱下方的模式分叉)。

使用設計快徑的時機

  • 觸發詞:"design a loop", "build a loop", "new loop", "loop wizard",或是一個模糊的重複性任務需要自動化。
  • 您只需要一個循環藍圖(規範 + 產出物)— 無需成果編排。
  • 直接跳到第 2 階段(決策關卡 → 精靈 → 產出物生成)並停止。

何時不應使用

  • 瑣碎的一次性回答、快速編輯或對話式問題 → 直接做好一次即可,無需工具。(一個實質的一次性目標您仍然希望證明 — 不是瑣碎,只是不重複 — 應導向任務/目標運行或下方的單次傳遞,而不是完全跳過 Looptimal 的理由。)
  • 無交付義務的分析 → 直接回答或使用 esat。
  • 不可逆轉、涉及重大判斷且在沒有人願意把關 GO 閘門的動作 → 建議採用有人工把關的流程。
  • 後設循環("run Looptimal to verify Looptimal", "auto-merge when Looptimal says GREEN")→ 設計循環必須拒絕。
  • 僅有症狀的成功指標,而無行為結果預言機 → 重新框架化或拒絕。

操作規則(請先閱讀)

  • 這是一個技能,不是角色或模式。以一行啟動語句開始,然後執行工作。
  • 檢查點把關:框架化 → 分析 → 設計循環/路由 → 規劃 → 在每個檢查點模擬以獲得簡短狀態。在模擬後未經明確的人類 GO — 或者在單次傳遞模式中,取代分析/設計循環/規劃/模擬檢查點的輕量事前分析之後(請參閱下方的模式分叉)— 絕不開始執行。
  • 絕不自動執行不可逆操作:生產環境部署、發送、付款、憑證輪換、資料刪除 — 僅在動作前有人工把關。
  • 與平台解耦:從 ./.looptimal/profile.yaml → ~/.looptimal/profile.yaml → scripts/looptimal-detect.py → 通用預設值解析綁定。合約:references/agent-foundry.md。

啟動語句範例:

  • 完整管道:"Looptimal — 將此目標框架化為一個密封的成果循環。"
  • 設計快徑:"Looptimal — 為此循環制定藍圖。"
  • 單次傳遞:"Looptimal — 對此進行一次驗證通過,無需循環。"
  • 裸調用(無目標):僅問一個問題 — "完成時,哪個成果應為真?" — 然後進入下方的模式分叉。
  • 目標已給定:用一句話確認,然後進入下方的模式分叉。

模式分叉(在框架化之前 — 問一次,成本低)

Looptimal 的循環價值判斷是決策關卡(下方精靈的第 1 步)— 但今天它只在第 2 階段深處觸發,在框架化和分析已經執行之後。改為在任何這些工作開始之前決定形狀:

  • 措辭已明確 — 跳過問題:
    • 設計快徑觸發詞("design a loop", "build a loop", "blueprint", "loop wizard")→ 直接進入第 2 階段。
    • 明確的一次性語言,同時排除有用的重試("single pass", "one careful pass", "no retry loop needed")→ 直接進入單次傳遞。
    • 明確的一次性交付語言,可能涉及驗證器/重試工作("one-shot", "just do X once", "build/fix/ship this once")→ 完整管道,以便決策關卡可以選擇任務/目標運行 vs 單次傳遞。
    • 明確的重複/節奏語言("nightly", "every PR", "keep this fresh", "ongoing")→ 直接進入完整管道。
  • 否則 — 在進入第 0 階段之前,問一個結構化的、三個選項的問題:
    1. 一次性完成並證明 — 一個單一的驗證成果,沒有有用的重試循環 → 單次傳遞。
    2. 執行任務或建立循環 — 要么是有界限的(一個任務/目標運行,迭代直到一個關卡,然後停止 — 錯誤修復、規範符合性、一次性建置)要么是重複性的(按排程/觸發器無限期運行)→ 完整管道(第 0 階段 → 1 → 2;決策關卡選擇路線/原型 — 任務 / 重複 / 監督 / 持久棘輪 / 編排、任務/目標運行或硬拒絕)。
    3. 僅產生循環藍圖 → 設計快徑(僅第 2 階段)。

這將決策關卡已經做出的相同循環價值判斷,作為使用者自己的判斷,提前且低成本地提出,而不是只有在分析、設計循環和規劃已經花費在錯誤形狀上之後才能到達(無論選擇何種模式,框架化都會執行,所以它永遠不會浪費)。如果第 0/1 階段的證據後來與選擇的模式矛盾 — 一個「單次傳遞」目標反而明顯需要重複或迭代直到一個關卡,或者一個「重複系統」未通過決策關卡 — 則清楚說明並讓使用者重新導向。絕不要默默地覆蓋他們的選擇;也絕不要默默地遵從證據不支持的模式。

解析綁定(第 0 階段前導)

python3 scripts/looptimal-detect.py          # 探測標記;建議設定檔
# 或讀取 ./.looptimal/profile.yaml → ~/.looptimal/profile.yaml

提供 state_dir, dispatch.maker, dispatch.checker, verifier.default, 可選 banner。通用預設值:loops/<slug>/, shell 驗證器。


8 階段管道

階段名稱工作參考
0框架化將目標轉化為一個雜湊固定的、密封的驗收套件。每個標準斷言一個成果(而不是症狀)並綁定一個領域成果預言機。輸入對製作者不可寫入。產出 acceptance-suite.yaml + acceptance-suite.sha256。references/pipeline.md
1分析產出能力清單和本地能力就緒清單:領域、整合圖、風險、依賴項、可用的技能/插件/連接器/MCP/代理/資料。當風險需要三模型壓力測試時,將深度定義工作委派給 esat。references/pipeline.md
2設計循環 / 路由執行循環設計精靈或路由目標。選擇原型 — 任務(有限交付)、重複(排程新鮮度)、監督(在護欄內自主)、持久棘輪(每次傳遞嚴格改善一個成果指標)、編排(多參與者/多儲存庫)、任務/目標運行、單次傳遞 — 或僅在硬性無驗證器/後設循環/僅症狀情況下拒絕。references/pipeline.md
3規劃建立共識任務圖:節點、依賴項、每個任務的接受鉤子(繫結到密封套件)、爆炸半徑標籤、回滾說明。references/pipeline.md
4模擬將循環向前滾動 N 步;事前分析失敗模式(獎勵駭客、靜默失敗、部分完成、環境漂移);強化計劃。呈現發現以及對密封套件的任何差異(重新雜湊 + 使用者確認)。references/pipeline.md
—人類 GO明確批准執行。呈現最高風險、不可逆操作和未解決的依賴項。無 GO → 不執行。references/pipeline.md
5執行根據綁定設定檔啟動動態領域專家子代理。在迭代關卡,製作者 ≠ 檢查者。可恢復、冪等的步驟;針對部分失敗的回滾路徑。對不可逆操作進行動作前把關。references/pipeline.md
6驗證成果一個獨立的檢查者根據即時狀態重新執行密封的套件。忽略循環自我報告的 GREEN。在證據包上把關。references/pipeline.md
7持久化寫入持久狀態:目標雜湊、套件雜湊、成功/失敗情況、預言機結果、修復分類、恢復指針、下次運行的經驗教訓。references/pipeline.md

階段轉換(預設)

  • 0 → 1:密封套件存在,每個標準都有一個預言機,雜湊已記錄。
  • 1 → 2:能力清單涵蓋所有物質領域、整合邊緣和本地能力就緒度。
  • 2 → 3:已選擇原型或任務路線(或已發出硬拒絕,並提供誠實的替代方案)。
  • 3 → 4:任務圖是無環的,每個節點掛鉤到一個套件標準,安全限制已設定。
  • 4 → GO:模擬報告已交付;計劃已強化;不可逆操作已標記。
  • GO → 5:明確的人類批准已捕獲在狀態中。
  • 5 → 6:製作者宣布迭代完成 — 僅供參考;檢查者擁有真相。
  • 6 → 7:證據包為 GREEN;否則為 FAIL,附帶修復分類和恢復指針。

恢復

如果 state_dir 下存在先前的運行,且目標雜湊匹配,則從最後一個未完成的階段恢復。如果目標發生實質變化,則重新框架化(新的套件雜湊)。未經新的設計循環/路由,絕不跨越硬拒絕恢復。


第 2 階段 — 設計循環 / 路由精靈

精靈強制執行四個原子,運行路由決策關卡,然後分支。可重用循環路線產生完整的 LoopPrint 產出物包。任務/目標運行路線產出 route.md + 一個任務包(第 3 階段後的 mission.yaml)並繼續到第 3 階段規劃,而無需可重用循環支架。單次傳遞路線產出 route.md 加上輕量事前分析,並遵循單次傳遞降級路徑。它位於完整管道的第 2 階段,也可以作為 design 快徑獨立運行。

精靈入口

  • 完整管道(從第 2 階段呼叫):目標是第 0 階段的成果。跳到步驟 0.5。
  • 設計快徑(直接調用):以一行啟動語句開始;如果未給定目標,先問一個問題。

步驟 0.5 — 解析綁定

執行 scripts/loopprint-detect.py(或讀取 ./.loopprint/profile.yaml → ~/.loopprint/profile.yaml)以獲取 state_dir, verifier.default, dispatch, marker_path, runner, banner。通用預設值:loops/<slug>/, verify.sh。合約:references/profiles.md。絕不要硬編碼平台慣例。

步驟 1 — 決策關卡(+ 路由)

執行 references/decision-gate.md 中的第 0 層測試:4 個條件 + 30 秒檢查清單。報告路線,每個條件附帶一行推理。重複性仍然是可重用循環攤銷測試,而不是整個編排關卡:非重複但有驗證器支持的工作可以路由到任務/目標運行或單次傳遞。當沒有外部驗證器/人類檢查點、目標是自我指涉/後設循環,或者成功僅是症狀而無行為錨點時,硬拒絕仍然是強制性的。

立即根據所選路線分支:

  • 可重用循環路線: 繼續執行步驟 2-6,固定循環原型/設定檔,生成 loops/<slug>/,並執行 loopprint-lint。
  • 任務/目標運行路線: 不要繼續執行循環設定檔或產出物生成。產出 route.md,包含驅動者、狀態產出物、驗證器、停止/預算、自主程度、就緒差距以及為何不產生可重用循環藍圖;然後繼續到第 3 階段規劃,該階段產出 mission.yaml, task-graph.yaml, execute-scope.yaml, 和 looptimal-lint.txt。
  • 單次驗證傳遞路線: 不要繼續執行循環設定檔或產出物生成。產出 route.md,包含驗證器、狀態產出物、停止、就緒差距以及一個 3 情境輕量事前分析;然後遵循 single-pass 降級路徑,而不是第 3/4 階段。
  • 人類把關工作流程路線: 產出 route.md,包含人類檢查點和外部檢查者,然後僅繼續通過匹配這些關卡的監督路徑。
  • 硬拒絕: 產出 reject.md,包含不可驗證/不安全的理由和誠實的替代方案;停止,除非使用者重新框架化目標。

步驟 2 — 可重用循環目標細化

問 3-5 個有針對性的問題(不要更多):

  1. 明確的目標 — 一句話,可測試。
  2. 重複性/頻率 — 確認可重用循環能夠攤銷成本。
  3. 驗證方法 — 哪個外部信號表明迭代成功?
  4. 不可逆風險 — 什麼不能撤銷?(→ 人類檢查點)
  5. 自主程度 — 完全自主、檢查點把關還是僅模擬運行?

步驟 3 — 可重用循環原始強制

為每個原子強制一個具體值。不要在任何一個模糊的情況下繼續:

  • 目標 — 步驟 2 中的一句話目標。
  • 狀態 — 來自綁定 state_dir 的持久產出物路徑;它記錄了什麼:嘗試日誌、失敗原因、當前假設、上下文。
  • 驗證器 — 確切的外部命令或指定的審閱者。如果唯一提議的檢查是相同的代理自我評估,則拒絕它並找到一個真正的關卡。製作者 ≠ 檢查者。
  • 停止 — 成功標準 以及 一個安全限制(最大迭代次數、權杖/時間預算、明確暫停)。沒有安全限制的循環不能交付。

步驟 4 — 可重用循環設定檔選擇

固定原型的完整設定檔 — 工作模式(來自 references/patterns.md)和驗證器/停止形狀:

  • MORTY — 特定錯誤;驗證器 = 重現測試;最終...

…(為翻譯目的而截斷)

相關技能