agentlas-ai/Agentlas-OS

更新後備方案：如果自動更新失敗，請執行一次 hephaestus update。即使不更新，當前版本的指令仍可正常運作。

/hep-storm

透過 Stormbreaker 循環驅動目標 — 這是 Hephaestus 的強韌、以驗證器為優先的執行循環 — 在此工作區內執行。與一次性回答或一般的平行扇出不同，Stormbreaker 會將目標路由給真正的 Agentlas 專家，將工作結構化為依賴順序的流水線織物，將每個工作封包作為強化的目標循環來驅動（它不會停滯、失控或謊稱成功），並且拒絕在沒有證據的情況下報告成功。也可以透過 @Hephaestus storm <目標> 觸發。

將它用於值得循環的工作：應用程式、網站、代理、自動化、除錯、多步驟研究、資料/報告生成 — 任何涉及檔案、工具、測試或外部驗證的工作。簡單問題應直接回答，無需進行風暴。

Core 擁有的目標 + UltraCode 框架

每個結果都包含 execution_harness。在規劃或執行封包之前，逐字套用 execution_harness.system_prompt，保留其 prompt_sha256，並且永遠不要在此配接卡中重新定義 Goal 模式或 UltraCode 模式。當主機提供時，傳遞包含 AGENTLAS_SESSION_INVENTORY 的即時工作階段 JSON；否則使用 Core 明確的 host:primary 後備方案。

目標是使用者在 /hep-storm 之後輸入的確切文字。

如何執行

逐字執行下面的 shell 區塊，只將 GOAL 值替換為使用者確切的目標文字。該區塊透過絕對路徑解析 Hephaestus 執行器並執行它 — 無需安裝任何東西，也無需新增到 PATH。在代理執行環境中，你就是執行者：引擎給了你經過驗證的計畫（執行織物）；你用你自己的工具來執行它。

防護措施 — 請不要執行以下任何操作。它們不是此工作流程的運作方式，並且之前曾導致偽造報告：

• 不要診斷 command not found 或 PATH，也不要編輯 ~/.zshrc。 執行器在區塊內部透過絕對路徑解析。
• 在沒有驗證器證據的情況下，不要聲稱封包、閘門或外部操作成功。一個已具體化或已排程的執行不代表成功。
• 如果執行器真的缺失，請說明情況並停止。永遠不要編造解決方案或執行。

GOAL="<替換為使用者在 /hep-storm 之後輸入的確切文字>"

case "$GOAL" in
  "<replace"*) echo "GOAL 佔位符未填寫 — 請先替換使用者的目標。" >&2; exit 2 ;;
esac

RUNNER=""
for candidate in \
  "$HOME/.agentlas/runtime/current/bin/hephaestus" \
  "./bin/hephaestus"
do
  if [ -n "$candidate" ] && [ -x "$candidate" ]; then RUNNER="$candidate"; break; fi
done
if [ -z "$RUNNER" ]; then
  for cache in "$HOME/.claude/plugins/cache/agentlas-core-engine/hephaestus" \
               "${CODEX_HOME:-$HOME/.codex}/plugins/cache/agentlas-core-engine/hephaestus"; do
    newest="$(ls -d "$cache"/*/bin/hephaestus 2>/dev/null | sort -V | tail -1)"
    if [ -n "$newest" ] && [ -x "$newest" ]; then RUNNER="$newest"; break; fi
  done
fi
[ -n "$RUNNER" ] || { echo "未找到 Hephaestus 執行環境。請先執行安裝程式。" >&2; exit 1; }
if [ "${HEPHAESTUS_AUTH_AUTOPOPUP:-1}" != "0" ]; then
  "$RUNNER" auth ensure >/dev/null 2>&1 || true
fi
# 為此目標路由 + 具體化流水線織物。沒有 --executor-command：
# 主機模型（你）原生執行每個封包。--research-evidence 使用 Research Engine 收據為計劃/研究封包提供依據。
FABRIC="$("$RUNNER" hep-storm "$GOAL" --research-evidence --runtime "${AGENTLAS_HOST_RUNTIME:-terminal}")"
printf '%s\n' "$FABRIC"

根據路由決策行動

讀取 route_decision.action（或 route_action）並分支 — Stormbreaker 僅為流水線自動具體化完整的織物；其他動作仍然啟動風暴，只是使用路由器選擇的勞動力：

• action: "pipeline" — 結果攜帶 execution_fabric（packets、parallel_groups、sessions、resume_policy）、每個封包的 write_scope 和 goal/verifier、一個 pipeline_id、一個 journal 路徑以及 final_gate 標準。在下方「執行 Stormbreaker 循環」中運行完整循環。
• action: "clarify" — 目標不明確。將 clarify_question 與候選清單一起作為一批提出，然後用精煉後的目標重新執行區塊。這是範圍鎖定的模糊性閘門；不要猜測越過它。
• action: "route"（單卡）— 單一代理風暴：借用並運行附加到此專案的那張卡片，然後仍然套用驗證 → 修復 → 最終閘門步驟。
• action: "hub_fallback" / "hub_candidates" — Hub 查詢僅使用了去識別化的關鍵字。如果 execution 區塊列出了 recommended_agents，則按階段順序透過 "$RUNNER" hep-call "<agent>" "<goal>" --project . 借用每個代理並在附加到此儲存庫的情況下運行它們；否則報告候選者並提議使用 /hep-build。
• action: "propose_new" — 沒有合適的方案；提議透過 /hep-build 建立一個。
• action: "refuse" — 解釋 reasons（例如循環防護）並停止。不要繞過它重試。

在織物上執行 Stormbreaker 循環

根據以下協議將目標執行至完成。不要停下來請求確認 — 這是一次強韌執行。僅在目標經過驗證，或你確實被身份驗證、付款、政策、遺失的密鑰/工具或需要使用者批准所阻擋時才停止。

1. 範圍鎖定 — 用一句話重申目標並鎖定它。檢查路由決策的失敗記憶。如果（且僅當）目標過於模糊而無法安全分解，則提出一批 3–5 個問題（不要做什麼 / 最小版本 / 完成訊號 / 依賴項），然後繼續。如果已經很具體，則什麼也別問。
2. 發布合約 — 寫下驗收標準：每個封包和整個目標的具體、可檢查的完成訊號。這些成為循環的停止標準。
3. 計劃鎖定 — 採用織物的 parallel_groups 和 depends_on 排序作為計劃。開啟一個可見的目標分類帳：封包、擁有者、驗證閘門、狀態、恢復點。
4. 行動 — 執行下一個未阻塞的群組。在運行時支援的情況下，並行運行群組中獨立的封包。當封包的 card 指定了 Agentlas 專家時，透過 "$RUNNER" hep-call "<card>" "<goal>" --project . 將其借用並附加到此專案運行，而不是扮演它的角色。將工件寫入每個封包的 write_scope。
5. 驗證 — 一個封包僅在具有可獨立歸因、經過驗證的驗證時才算通過。loop.goal_command 返回 0 退出碼可能結束目標循環，但它不能驗證執行器自身的輸出或自我證明成功。需要一個獨立的驗證器和經過雜湊驗證的工件證據。「它已運行」絕非成功。
6. 有限修復/重試 — 在具體的驗證失敗時，修復並重新執行該封包 — 有界限。遵守目標循環預算：容忍暫時性失敗並進行退避，在連續無進展迭代後將封包標記為 stalled，並且永遠不要超過其迭代次數上限。恢復的運行從日誌繼續，它不會重新啟動。
7. 最終閘門 — 僅當織物的最終閘門清除時（can_report_success），才報告成功。對產出的工件執行證據/安全閘門。

保持可見進度簡潔：嘗試了什麼、驗證了什麼，以及在受阻時確切從哪裡恢復。永遠不要暴露隱藏的推理 — 僅顯示進度、證據、決策和最終狀態。

循環不變量（為何這勝過一次性循環）

• 別中斷（안 끊기게）： 暫時性的封包失敗會被記錄並以退避方式重試，並非致命。只有真正的連續硬性失敗才會停止運行。
• 別失控： 硬性迭代次數上限加上停滯檢測 — 測量到的無進展會將循環停止為 stalled，而不是空轉。
• 堅持到目標完成（될 때까지）： 循環僅在驗證器證明目標達成時才報告 reached_goal。任何單純的「它已運行」都不算數。
• 在強制中斷下存活： 每個封包都是一個日誌步驟，因此被殺死的運行會從日誌恢復其編號，而不是發生衝突或從零重新啟動。

嚴格規則

• 不允許偽造通過。 如果引擎不可用、帳戶/工具/連接器/瀏覽器工作階段缺失，或閘門未執行，請將運行報告為已受阻或未經驗證，並附上確切的下一步 — 永遠不要報告為完成。已排程或已具體化的運行並不能證明外部操作成功。
• 路由器僅選擇代理並獲取 BYOM 套件。實際的工具執行遵循此運行時自身的安全和權限模型。
• 在你的最終訊息中報告 receipt_id、pipeline_id 和 journal 路徑，以便運行可審計且可恢復。

範例

/hep-storm 建立一個功能正常的等待頁面登陸頁面，並帶有經過驗證的註冊流程
/hep-storm 幫我把這個儲存庫的付款錯誤重現到 PoC，修復它，並用回歸測試驗證
@Hephaestus storm 把這個研究問題變成一份有引用證據的報告

---

更新後備方案：如果自動更新失敗，請執行一次 hephaestus update。即使不更新，當前版本的指令仍可正常運作。