lee-to/aif-handoff
Autonomous Kanban board where AI agents plan, implement, and review your tasks — fully hands-off.
AIF Handoff – 自主 AI 驱动的看板
它是什么 – 一个基于 Web 的看板，让大语言模型代理无需人工干预即可规划、实施和审查面向代码的任务。该系统构建于开源 AI Factory 框架之上，并使用可插拔的运行时适配器，支持 Claude、OpenAI Codex、OpenRouter 和 OpenCode。
核心理念 – 任务通过固定流水线（待办 → 规划 → 实施 → 审查 → 完成）流转。在每个阶段，专门的 AI 子代理（或单个“技能”函数）生成工件、运行质量检查，并可自动循环返工，直到满足收敛条件。当收敛失败时，任务将移交给人工进行手动审查。
主要特性（如 README 中所述）
- 完全自主流水线 – 创建任务后，AI 即可规划、编写代码并审查。
- 看板 UI – 支持拖放的看板，通过 WebSocket 实时更新。
- 模块化运行时 – 可按项目或任务切换 Claude、Codex、OpenRouter 或 OpenCode，无需更改编排逻辑。
- 子代理编排 – 专门的协调器负责规划、实施和审查（以及安全旁路）。
- 分层感知执行 – 实施阶段计算依赖层，并在可能时并行运行工作进程。
- 自愈 – 心跳和看门狗自动恢复卡住的代理。
- 人工参与选项 – 批准计划、请求更改，或完全无人值守运行。
- 参与者模式 – 可选的本地用户账户，支持基于角色的任务所有权。
- GitHub 集成 – 导入问题、创建隔离的拉取请求，并要求每个任务由人工合并 PR。
- 模型上下文协议（MCP）同步 – 与其他 AIF 工具进行双向任务同步。
架构概览
packages/
├─ shared/ # 类型、常量、日志器
├─ runtime/ # 注册表和适配器（Claude、Codex 等）
├─ data/ # SQLite 访问（drizzle-orm）
├─ api/ # Hono REST + WebSocket 服务器（端口 3009）
├─ web/ # React + Vite UI（端口 5180）
└─ agent/ # 协调器 + 子代理编排
代理 每 30 秒轮询一次，分派适当的子代理，并通过心跳跟踪任务活跃度。自动审查可运行两种策略（full_re_review 或 closure_first），并在收敛失败时停止，将任务标记为 manualReviewRequired=true。
快速开始（快速启动）
不使用 Docker
git clone https://github.com/lee-to/aif-handoff.git
cd aif-handoff
nvm use # Node 20.19+ 或 22.12+
cp .env.example .env
npm install
npm run init # 初始数据库设置
npm run dev # 启动 API、Web UI 和后台代理
如果切换 Node 版本，请重新构建原生 better-sqlite3 二进制文件： npm rebuild better-sqlite3。
使用 Docker
git clone https://github.com/lee-to/aif-handoff.git && cd aif-handoff
cp .env.example .env
mkdir -p projects # 用于创建项目的主机目录
docker compose up --build # 启动 API、UI、代理（+ 可选 MCP）
# 在容器内认证 Claude
docker compose exec agent claude login
docker compose restart agent
Docker 处理 Codex SDK/CLI 安装；您可以通过 CODEX_VERSION 覆盖版本。
运行时提供程序
| 提供程序 | 传输选项 |
|---|---|
| Claude (Anthropic) | SDK（直接 Agent SDK）– 风险：可能违反 Anthropic 条款；更安全的 CLI 传输；通过 ANTHROPIC_API_KEY 的 API 传输。 |
| Codex (OpenAI) | SDK、CLI、App-Server、API |
| OpenRouter | API |
| OpenCode | API |
您可以通过 AIF_RUNTIME_MODULES 环境变量添加自定义适配器。 |
执行模式
| 模式 | AGENT_USE_SUBAGENTS |
行为 |
|---|---|---|
| 子代理（true） | 每个流水线阶段通过专门的协调器代理运行，迭代直到满足质量标准。更高的 token 使用量，更高的质量。 | |
| 技能（false – 默认） | 阶段是单个 AIF 技能调用（/aif-plan、/aif-implement 等）。更快，token 成本更低；可选的 Improve/Verify 步骤增加额外检查。 |
谁可能使用这个？
- 希望尝试端到端 AI 生成代码而无需编写样板编排的团队。
- 探索自主软件开发流水线的研究人员。
- 寻找由 LLM 驱动的“设置后不管”任务板的独立开发者。
许可证与社区
该仓库是开源的（Lee-to 项目典型的 MIT/Apache 风格），并依赖于同样开源的 AI Factory 框架。欢迎通过 GitHub 提交问题、功能请求和贡献。
底线： AIF Handoff 是一个真正的、生产级项目，演示了如何结合多个 LLM 提供程序、模块化运行时适配器和看板 UI，创建无人值守的软件开发流水线。
相关
- 项目
- 项目
- 项目
- 项目