AIF Handoff：代码开发的自主代理

自主开发代理：AIF Handoff 如何取代手动工作流程

在界面中创建任务，合上笔记本电脑——几分钟后，Telegram 通知到来，PR 已准备就绪。这不是科幻，而是由 AIF Handoff 驱动的现实：一个建立在 AI Factory 之上的自主代理系统，与任何 LLM 工具（如 Claude Code 或 Cursor）兼容。其核心是上下文管理、迭代规划，以及基于补丁的自学习。

为什么经典“凭感觉编程”无法扩展

大多数开发者在使用 LLM 时会经历三个阶段：

• 抽奖——一个提示，寄希望于运气。模型生成看似合理但无法运行的代码，因为缺少项目上下文。每次查询都从零开始，没有先前决策的历史。
• “资深开发者提示”——像“你是一位拥有 15 年经验的高级开发者”这样的指令。它们改变了回应语气，但没有提升质量。模型假装自信，而不是真正胜任。
• 手动工作流程——你自己组装上下文：复制文件、指定约束、逐一运行命令。结果有所改善，但过程仍然费力且易出错，因为容易遗漏上下文。

关键洞见：LLM 无法读心。它们只处理你提供的内容。上下文越精确完整，输出越可预测。例如：

差：

Implement JWT auth using best practices

好：

Here's AuthService (code), here's how sessions are stored (code), here's middleware (code).
Need to add refresh token. Use Laravel Sanctum, no changes allowed.
Here's the test that must pass.

在第二种情况下，模型的想象空间被最小化。成功由具体标准衡量，而不是模糊的“最佳实践”。

AI Factory 如何系统化上下文管理

AI Factory 是一个 CLI 工具和技能生态系统，能为任何编码代理自动管理上下文。安装后（npm install -g ai-factory && ai-factory init），它会扫描项目、识别技术栈，并创建结构：

your-project/
├── .claude/
│   └── skills/           ← markdown files with agent instructions
├── .ai-factory/
│   ├── DESCRIPTION.md    ← project description, stack, architecture
│   ├── PLAN.md           ← current plan
│   ├── patches/          ← self-learning patches
│   └── evolutions/       ← skill evolution logs
└── .ai-factory.json

技能不是通用建议，而是具体指令：“在这个项目中如何精确创建计划”、“认证变更需要修改哪些文件”。关键命令：

• /aif—初始化会话上下文
• /aif-plan—创建计划和 git 分支
• /aif-implement—执行任务并使用检查点提交
• /aif-fix—修复 bug + 创建自学习补丁
• /aif-evolve—分析补丁并更新技能
• /aif-verify—对照计划检查结果

自学习持续进行：每次 /aif-fix 保存补丁，/aif-evolve 从中发现模式以适应技能。在每次 /aif-implement 前，代理会读取所有累积补丁——系统即使不显式调用 evolve 也能学习。

AIF Handoff：人类在环中，而非环内

AI Factory 解决了上下文问题，但仍需手动启动命令。AIF Handoff 移除这最后一层障碍——它是一个带有看板板的 Web 应用，完全自动化代理管道：

Backlog → Planning → Plan Ready → Implementing → Review → Done

你在 UI 中创建任务——系统通过 WebSocket 推动状态变化。内部，专属协调器处理工作：

• plan-coordinator—不仅仅生成计划，还通过 plan-polisher 迭代优化，直到满足质量标准。
• implement-coordinator—分析任务依赖，并在安全的独立 git worktree 中启动并行工作者。
• review-sidecar + security-sidecar—并发检查代码是否符合计划以及是否存在漏洞（XSS、SQL 注入、数据泄露）。借助 MCP Playwright，它们运行浏览器测试。

如果审查发现问题，任务会自动重试——但有严格的迭代限制，以避免一夜之间耗尽你的全部令牌预算。

人类在环中 ≠ 人类在环内

• 人类在环内：你每步都干预。最大控制，最低速度。
• 人类在环中：你设置任务和标准——系统自主运行。你批准或拒绝最终结果。这就是 Handoff 的工作方式。

两种执行模式：

• Subagents（默认）—完整管道，包括迭代优化、并行工作者和质量 sidecar。质量更高，成本更高。
• Skills—通过核心 AI Factory 命令单次执行。更快、更便宜，适合简单任务。

设置与双向同步

启动 Handoff：

git clone https://github.com/lee-to/aif-handoff
cd aif-handoff
npm install
npm run init
npm run dev

或通过 Docker（推荐）：

docker compose up

它启动三个服务：API（Hono + WebSocket）、Web（React UI）和 Agent（协调器）。首次运行需要 Claude Code OAuth。配置在 .env 中：

AI_LANGUAGE=ru                  # agent language
MAX_REVIEW_ITERATIONS=3         # review iteration limit
AGENT_USE_SUBAGENTS=true        # execution mode
TELEGRAM_BOT_TOKEN=...          # for notifications
TELEGRAM_CHAT_ID=...

Handoff 和 AI Factory 通过 MCP 双向同步。在 Handoff 中启动任务，切换到直接 Claude Code 工作——变更会自动反映在看板板上。任何兼容 MCP 的代理均可加入。

与 Paperclip 的区别及其他特性

Paperclip 为营销、内容、SEO 编排代理。它处理文本和信息流。AIF Handoff 专为开发打造：它了解你的技术栈、验证代码（而非文本）、使用 git worktree 隔离工作者，并从项目特定补丁中学习。

关键点：

• 上下文 > 提示。更具体的输入 = 更稳定的输出。
• 通过补丁自学习（/aif-fix → /aif-evolve）—项目适应的关键。
• 人类在环中委托例行工作，同时保留最终控制。
• 并行工作者和迭代审查提升质量，但需令牌限制。
• 双向同步让你在 Handoff 和直接代理工作间自由切换。

技术栈：Node.js + TypeScript（Turborepo）、SQLite（drizzle-orm）、Hono API、React + TailwindCSS、node-cron。测试覆盖率 >70%，ESLint 守护层保护。路线图：JetBrains 插件和 CI/CD 集成。

— Editorial Team