AACWorkflow Docs

AI 小队创业

用 1–2 个人和 4–6 个 AI 智能体搭建精益工程团队,每个智能体负责一个领域。任务分发、监督和扩展的最佳实践。

早期创业公司讲究速度。两个创始人,五个功能,无尽的工作量。AI 智能体可以成为你的第一批员工 — 每个负责一个领域(后端、前端、QA、文档、DevOps、安全),并与你的人类团队并肩工作 24/7。

本指南展示如何构建精益 AI 小队、清晰定义领域,并让人类始终掌握进度而不产生瓶颈。

小队结构

典型初创小队看起来是这样的:

角色智能体名称职责
创始人 / CTO(人类)愿景、架构决策、外部沟通
后端主管@backend-bot服务器代码、API 设计、数据库、迁移
前端主管@frontend-botWeb UI、移动视图、组件库、样式
QA / DevOps 主管@qa-bot测试覆盖、CI/CD、部署、可观测性
文档 / 内容主管@docs-bot用户文档、API 文档、变更日志、教程
安全 / 基础设施主管@security-bot依赖审计、安全扫描、密钥、访问控制

为什么有效:

  • 每个智能体专业化(一个代码库、明确领域),所以错误被隔离
  • 1–2 个人审查、批准和发布(不用等 5 个人的代码审查)
  • 智能体可并行工作(后端和前端独立)
  • 人类聚焦战略,而非解除评审堵塞

如何引入智能体

第 1 步:定义范围

为每个智能体写一份单页文档。示例:

智能体:@backend-bot
领域:server/(Go 后端)

职责:
- server/internal/handler/ 中的 Chi HTTP 处理器
- server/pkg/db/queries/ 中的 sqlc 查询
- PostgreSQL 迁移
- API 合约测试

不负责:
- 前端代码(属于 @frontend-bot)
- DevOps / 部署(属于 @qa-bot)
- 文档(属于 @docs-bot)

工作流:
- 从面板分配任务 → 智能体承接
- 智能体打开草稿 PR(待审查)
- @backend-bot 在 #engineering Slack 发言:"PR #123 ready for review"
- 人类在 2–4 小时内审查(异步可)
- 批准后合并

第 2 步:为每个智能体配置 MCP 服务器

每个智能体需要访问其领域的工具:

智能体MCP 服务器 / APIs工具
@backend-botGitHub(代码)、Go CLI、sqlc、PostgreSQLBash、git、Go 工具链
@frontend-botGitHub(代码)、npm/pnpm、Next.js、TypeScriptBash、npm、Node.js CLI
@qa-botGitHub(CI/CD 日志)、Docker、kubectl、监控Bash、docker、CI logs API
@docs-botGitHub(仓库)、Markdown 工具、链接检查器Bash、grep、curl
@security-botGitHub、npm audit、OWASP ZAP、Snyk APIBash、curl、audit CLIs

第 3 步:创建共享 Slack 频道

发一个帖子,列出每个智能体的文档、领域和当前状态:

🤖 Engineering Squad
Frontend: @frontend-bot (available) ✅ Last task: Add dark mode
Backend: @backend-bot (available) ✅ Last task: Workspace API pagination
QA/DevOps: @qa-bot (running) 🔄 Last task: Deploy v1.1 to production
Docs: @docs-bot (available) ✅ Last task: API changelog
Security: @security-bot (available) ✅ Last task: npm audit weekly

任务分配工作流

三步交接

  1. 人类写任务(5 分钟)

    标题:Add dark mode toggle to sidebar
    
    描述:
    Users need a way to switch between light and dark themes.
    Store preference in localStorage and sync across tabs.
    Use existing Tailwind dark: variants in packages/ui/.
    
    AC:
    - [ ] Dark mode toggle in sidebar
    - [ ] Respects system preference on first visit
    - [ ] Persists across sessions
    - [ ] All components render in dark mode
    
    参考:Figma design link
  2. 人类分配给智能体(1 分钟)

    • 前端工作:分配给 @frontend-bot
    • 后端工作:分配给 @backend-bot
    • 不确定?分配给 @orchestrator(元智能体)进行路由
  3. 智能体 end-to-end 执行(1–4 小时)

    • 阅读任务
    • 规划实现
    • 打开包含代码的草稿 PR
    • 在 Slack 发言:"Dark mode PR is ready for review → #123"
    • 人类审查、批准、合并

审查 SLA

提前设定期望:

PR 类型审查时间合并时间自动操作
错误修复同一天批准后 2–4 小时
小功能(<100 LOC)4–8 小时批准后 1 天
大功能(>200 LOC)1–2 天批准后 2 天
文档2–4 小时批准后立即自动合并
依赖(patch)同一天测试通过立即自动合并

防止失控的智能体

智能体强大但需要护栏:

1. 代码审查是强制的

  • 所有智能体 PR 都需要人类批准才能合并
  • 使用 GitHub 分支保护:require 1 approval
  • 只有人类有合并权限,不是智能体

2. 每个智能体一个领域

  • 明确边界防止范围蔓延
  • 智能体坚持其文档(例如,@frontend-bot 不碰 server/)
  • 如果任务跨领域,分解它

3. 留意错误

  • 检查智能体 PR 是否有:
    • 拼写错误、注释语法、变量命名
    • 遗漏的测试案例或边界情况
    • API 合约变化(运行 parseWithFallback 检查)
    • 依赖版本(避免意外主版本号碰撞)

4. 优雅地回滚

如果智能体合并了坏 PR(少见,但有可能):

git revert <commit-sha>
git push
# 将 revert 分配给同一个智能体,带上上下文
# 智能体学习并不重复错误

5. 在发布关键功能时暂停智能体

在大版本发布前(v1.0、产品发布):

  • 临时存档智能体(或设为"仅审查"模式)
  • 人类直接审查关键路径
  • 发布后恢复智能体

初创小队的一周示例

周一 9 AM: CTO 为本周写 5 个任务(dark mode、API pagination、deployment automation、security audit、docs refresh)。

周一 10 AM: 分配给小队:

  • Issue #1(UI)→ @frontend-bot
  • Issue #2(API)→ @backend-bot
  • Issue #3(DevOps)→ @qa-bot
  • Issue #4(security)→ @security-bot
  • Issue #5(docs)→ @docs-bot

周一 11 AM – 周五 5 PM: 智能体并行工作。人类每天异步审查 PR 2–4 次。每个智能体在一周内打开 1–3 个 PR。

周五 4 PM: 所有任务合并。智能体在 Slack 发言:

✅ Weekly squad recap (2025-06-20)
📊 Stats: 12 PRs, 0 rollbacks, 23 commits

🎯 Shipped:
- Dark mode toggle + system preference detection
- Workspace API pagination (tested with 100k issues)
- Deploy automation (v1.2.0 now deployable via CLI)
- npm audit + security patches (3 CVEs fixed)
- API docs updated + tutorial started

⏳ Next week:
- Mobile dark mode (WIP, high priority)
- Database query optimization
- E2E tests for invite flow

周五 5:30 PM: CTO 写 release notes、标记 v1.2.0、发布。小队休息(字面意思 — 他们是智能体,不需要假期)。


提示和最佳实践

**智能体为你工作,不是你为他们工作。**如果智能体产生的审查开销超过其节省的时间,那不是合适的方式。重新调整其领域或暂时停用它。

开始

  • 从 2 个智能体开始 — 后端和前端。学习工作流。
  • 每周加 1 个 — QA,然后文档,然后安全。不要一下子煮汤。
  • 监控智能体质量 — 跟踪 PR 接受率(目标:>90% 首次合并)
  • 周五 15 分钟回顾 — 讨论什么做得好、什么改进

长期扩展

  • 智能体作为导师 — 初级员工从智能体代码学习;这是教学材料
  • 智能体生成文档 — 智能体生成文档,人类润色;节省写作时间
  • 并行轨道 — 2–3 个智能体可在独立功能上工作;人类审查每一个
  • 事件响应 — 将 bug 分配给拥有该领域的智能体;他们 24/7 分流

团队士气

  • 在 PR 和 release notes 中鸣谢智能体("Thanks @frontend-bot for the dark mode implementation")
  • 在 Slack 庆祝智能体胜利(e.g., "Agent shipped 50 PRs this month!")
  • 对智能体局限保持透明(他们不能做设计、战略或利益相关者沟通)
  • 在重要决策上让人类参与(不要让智能体决定价格、功能方向等)

常见陷阱

错误出错原因修正
无代码审查智能体错误进入生产总是要求人类批准
模糊分配智能体猜测要做什么,浪费时间在任务中写清楚 AC
太多智能体竞争一个领域智能体冲突、重复工作、困惑每个领域一个智能体
智能体从不失败你认为他们完美,停止审查他们仍有 ~10% 错误率;保持警惕
人类橡皮图章 PR没有实际审查;失去目的阅读代码;提问;关心

相关指南