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 的支持，直接从项目管理工具排队任务。