opentag 是做什麼的?
OpenTag 將工作區中的提及(例如 @opentag 修正這個問題)轉換為可審計的代理執行任務。使用此技能可幫助使用者設定從工作區事件到調度器、本地執行器、執行引擎與回呼的完整路徑。
路由請求
僅根據使用者所需的路徑閱讀對應的參考文件:
- 本地煙霧測試或首次設定:
references/local-echo.md - GitHub Issue 或 PR 提及:
references/github-setup.md - Slack 應用提及:
references/slack-setup.md - 真實程式碼執行或 PR 建立:
references/codex-runner.md - 執行失敗、缺少回呼、任務被拒絕或驗證錯誤:
references/troubleshooting.md
如果使用者詢問多個路徑,請先設定並驗證最小的可用循環,然後再加入下一個轉接器。
運作規則
- 除非使用者已有可運作的調度器與執行器,否則優先使用本地 echo 循環,而非正式代理或即時回呼。
- 保持明確的設定:不要憑空發明儲存庫擁有者、儲存庫名稱、檢出路徑、權杖、Slack ID 或調度器 URL。
- 不要加入備援行為。缺少必要值時應停止設定,並清楚列出缺少的項目。
- 將
opentagd視為本地執行權威。它只能聲明其設定檔中列出的儲存庫。 - 使用
echo進行非破壞性煙霧測試,僅在使用者需要真實程式碼執行時才使用codex。 - 分層證明:調度器健康檢查、執行器註冊、儲存庫或 Slack 繫結、任務建立、Daemon 執行、以及回呼傳遞。
設定工作流程
-
識別目標循環。 完成條件:一個循環被命名為
local-echo、github、slack或codex-runner。 -
收集必要資訊。 完成條件:答案包含所有缺失的值,或所有必要值皆已備齊。
-
撰寫或更新最小設定檔。 完成條件:設定檔僅包含所選循環需要的欄位,並使用使用者的真實儲存庫/頻道/檢出路徑。
-
在建立任務之前先註冊繫結。 完成條件:執行器已註冊、儲存庫已繫結,且當 Slack 在範圍內時 Slack 頻道也已繫結。
-
驗證一次真實的執行。 完成條件:該執行可透過調度器看到、具有審計事件,並且以完成狀態結束,或因特定錯誤而失敗。
-
回報結果。 完成條件:告訴使用者設定了哪些內容、哪個指令證明了設定有效,以及還有哪些部分未設定。
指令預設值
除非專案已變更,否則使用以下預設值:
- 調度器應用:
pnpm --filter @opentag/dispatcher-app dev - 本地 Daemon 應用:
pnpm --filter @opentag/opentagd dev -- <command> - Slack Events 應用:
pnpm --filter @opentag/slack-events dev - 調度器 URL:
http://localhost:3030 - Slack Events URL 路徑:
/slack/events - 範例執行負載:
examples/github-to-echo/run.example.json
在此儲存庫中執行套件指令之前,請使用 Node 22.x 並視需要安裝相依套件。