nrslib/takt

TAKT Agent Koordination Topology - Define how AI agents coordinate, where humans intervene, and what gets recorded — in YAML

它解決了什麼問題

TAKT 的設計目的是停止對 AI 程式編寫代理人的「保姆式」監督。它針對常見的問題——代理人忘記指示、污染自己的上下文,或在長時間的開發任務中跳過關鍵的審查步驟——提供解決方案。與其依賴單一代理人來管理複雜流程,TAKT 從外部強制執行結構化、可重複的開發工作流程。

它如何運作

TAKT 是一個 CLI 工具,使用 YAML 定義的工作流程協調多個 AI 代理人。它將開發過程拆分為明確的步驟(例如規劃、實作、審查與修正),每個步驟都指派特定的角色、權限與轉換規則。

主要技術機制包括:

  • Isolated Worktrees:任務在獨立的 Git worktree 中執行,避免污染主工作目錄。
  • Workflow Engine:基於 YAML 的系統,管理步驟之間的轉換(例如將失敗的審查重新導回實作步驟)。
  • Provider Agnostic:協調多種 AI 供應商,如 Claude Code、Cursor、GitHub Copilot CLI,以及基於 SDK 的選項如 Codex 與 OpenCode。
  • Auto-routing:可選功能,根據成本、效能或推理需求,將特定工作流程步驟自動路由至最適合的模型。

目標使用者

TAKT 適用於使用 AI 程式編寫代理人完成大量工作,且希望從臨時提示轉向專業、可重現的軟體工程流程的開發者。也適合想將 AI 代理人整合至 CI/CD 流程(例如透過 GitHub Actions)之團隊。

重點特色

  • Declarative Workflows:在 YAML 中定義完整的開發迴圈(Plan $\rightarrow$ Implement $\rightarrow$ Review $\rightarrow$ Fix)。
  • Context Management:透過僅提供每個代理人其角色所需的資訊,防止上下文膨脹。
  • Multi-Agent Coordination:支援多種 CLI 與 SDK 為基礎的 AI 代理人,作為可互換的供應商。
  • Traceability:為每個步驟保留日誌與報告,確保從任務到 Pull Request 的路徑可審計。
  • Integration:內建對 GitHub 與 GitLab Issue 的支援,直接從專案管理工具排程任務。