Community寫作與編輯github.com

amplifthq/opentag

開源的 @agent 提及功能,適用於 Slack 與 GitHub。OpenTag 將被標記的請求路由至 Codex、Claude Code,然後在討論串中回傳結果。

opentag 是什麼?

OpenTag 是一套開源工具,可將 Slack 或 GitHub 中的 @opentag 提及轉換為可審計的 AI 代理執行任務。它透過可設定的路由管道,將觸發事件傳遞給調度器、本地執行器、執行引擎,最後將結果送回原討論串,讓團隊成員無需手動切換工具即可獲得 AI 協助。此技能支援本地 echo 測試(無害驗證)、GitHub Issue/PR 觸發、Slack 頻道提及,以及真實程式碼執行(透過 Codex)。它幫助開發者逐步設定最小可行的執行循環,先以小型測試確認每個環節(調度器健康檢查、執行器註冊、儲存庫繫結、與回呼交付)正常運作,再逐步加入正式代理或通知管道。OpenTag 的設計注重明確配置與無回退原則:缺少必要值時會清楚列出缺失項目,避免隱含假設;並強制將 `opentagd` 視為唯一的本地執行權威,僅執行其設定檔中列出的儲存庫。對於需要將 AI 代理整合至團隊協作流程的開發者來說,這套工具提供了一條清晰、可審計的執行路徑。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add amplifthq/opentag

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

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 執行、以及回呼傳遞。

設定工作流程

  1. 識別目標循環。 完成條件:一個循環被命名為 local-echo、github、slack 或 codex-runner。

  2. 收集必要資訊。 完成條件:答案包含所有缺失的值,或所有必要值皆已備齊。

  3. 撰寫或更新最小設定檔。 完成條件:設定檔僅包含所選循環需要的欄位,並使用使用者的真實儲存庫/頻道/檢出路徑。

  4. 在建立任務之前先註冊繫結。 完成條件:執行器已註冊、儲存庫已繫結,且當 Slack 在範圍內時 Slack 頻道也已繫結。

  5. 驗證一次真實的執行。 完成條件:該執行可透過調度器看到、具有審計事件,並且以完成狀態結束,或因特定錯誤而失敗。

  6. 回報結果。 完成條件:告訴使用者設定了哪些內容、哪個指令證明了設定有效,以及還有哪些部分未設定。

指令預設值

除非專案已變更,否則使用以下預設值:

  • 調度器應用: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 並視需要安裝相依套件。

相關技能