企业官网建设流程全解析

Agent Teams Lite 已正式宣布归档，官方推荐迁移到下一代项目gentle-ai。这是一份 gentle-ai 完整迁移指南：先讲清楚 Agent Teams Lite 为什么归档、两者的核心功能对比，再带你 3 步完成一键迁移。Agent Teams Lite 是一套零依赖、纯 Markdown 的 SDD（Spec-Driven Development，规格驱动开发）多智能体框架，由 1 个 orchestrator 编排 9 个专职 sub-agents，支持 Claude Code、OpenCode、Cursor 等主流 AI 编程助手。

一、30 秒回顾：Agent Teams Lite 是什么？🧩

Agent Teams Lite 的核心思想是：别只让一个 AI 从头写到尾，而是用「编排者 + 专职子代理」分工协作。每个阶段由一个全新上下文的 sub-agent 执行，产物（proposal、spec、design、tasks）持久化存储，最后归档为审计轨迹。

完整的阶段契约与结果信封（result envelope）规范见 docs/sub-agents.md，系统架构与依赖图见 docs/architecture.md。

二、为什么归档？官方给出的 4 个原因 📦

很多人以为归档是因为项目被弃坑，其实恰恰相反——gentle-ai 就是 Agent Teams Lite 的「正式继任者」，归档是为了终结「双轨维护」的混乱。README 中给出了明确解释：

1. 双分发渠道难以维护Agent Teams Lite 靠 shell 脚本分发，而 gentle-ai 是 Go 二进制。过去每次修改一个 skill、orchestrator 或资源文件，都要在两个渠道手动复制一遍。
2. 单一事实来源（One Source of Truth）gentle-ai 把所有资源直接嵌入二进制，与 release 版本绑定，不再需要两边同步。
3. 原子化更新brew upgrade gentle-ai && gentle-ai sync一条命令刷新所有配置。
4. 零漂移（No Drift）gentle-ai 采用基于标记（marker-based）的注入方式——更新时替换过期内容，而不是像旧脚本那样不断追加重复段落。

额外的关键增量：Engram 跨会话记忆协议会被自动注入到每个 agent 的 prompt 中，子代理的「记忆」不再依赖手工配置。

💡 一个值得注意的细节：Agent Teams Lite 的最后一个版本 v4.4.1 就是一次「Gentle-AI Parity Sync」——把 compact rules、go-testing、skill-creator等能力全部与 gentle-ai 对齐（见 docs/changelog.md）。如果你一直在用 v4.4.1，迁移到 gentle-ai 几乎是无缝的。

三、功能对比：gentle-ai 比 Agent Teams Lite 多了什么 📊

根据官方对比表（源自 README.md）：

简单总结：SDD 核心工作流两者一致，gentle-ai 赢在安装体验、更新机制和持久记忆上。

支持的 8 个 AI 编程助手

四、gentle-ai 一键迁移步骤（3 步完成）🚀

步骤 1：安装 gentle-ai

brew install gentleman-programming/tap/gentle-ai

步骤 2：运行安装

gentle-ai install

就这两条命令。gentle-ai 会自动完成以下全部工作：

• ✅ 检测你已安装的 AI 编程工具
• ✅ 安装全部 SDD skills
• ✅ 配置 MCP 服务器（Context7 等）
• ✅ 注入 SDD orchestrator 编排指令
• ✅ 设置 Engram 持久记忆

步骤 3：验证

打开 Claude Code（或其他已支持的助手），输入/sdd-init，能识别命令即代表迁移成功。

已装过 Agent Teams Lite？原地升级即可 ⬆️

这是迁移指南里最让人安心的一点：不需要先卸载旧版本。直接运行gentle-ai install，它会：

1. 检测你现有的 Agent Teams Lite 安装（skills、orchestrator 配置、MCP 服务器）
2. 原地升级为 gentle-ai 管理的格式
3. 所有配置被迁移到基于标记（marker-based sections）的管理区块中，未来每次 sync 都能平滑更新而不产生重复内容

作为对照，Agent Teams Lite 时代的安装方式是通过 scripts/setup.sh 这类 shell 脚本（./scripts/setup.sh --all），手动处理各工具的 skills 目录与 prompt 注入——这正是 gentle-ai 用二进制分发想彻底解决的痛点，安装细节可参考 docs/installation.md。

五、迁移检查清单：确认一切正常 ✅

迁移完成后，建议花 2 分钟核对以下 4 项：

关于持久化的 4 种模式（engram/openspec/hybrid/none）以及如何解析，见 docs/persistence.md；Delta Specs 合并进主 Spec 的归档循环原理见 docs/concepts.md。

六、归档后的仓库还能用吗？🗄️

能，但定位变了：

• 不再接收新功能和 bug 修复——所有开发已转移到 gentle-ai
• 代码完整保留，仅供参考（Apache 2.0 许可）
• 你已有的 SDD 产物不受影响：归档目录openspec/changes/archive/YYYY-MM-DD-{change-name}/本身就是一条只增不改的审计轨迹，这是 skills/sdd-archive/SKILL.md 明确保证的

如果只是想查阅文档或借鉴其中的 SDD 模式，可以克隆仓库本地阅读：

git clone https://gitcode.com/gh_mirrors/ag/agent-teams-lite

值得留存的参考资料包括：Token 经济学分析（docs/token-economics.md，讲清了「为什么委托子代理比内联执行省 token」）、15 个技能文件（skills/）、以及各助手的编排器配置样例（examples/）。

七、常见问题 FAQ ❓

Q1：迁移会丢我现有的 SDD 数据吗？不会。gentle-ai install是原地升级，项目里的openspec/目录、归档记录和 Engram 记忆都会保留，只是配置区块被纳入 gentle-ai 的标记化管理。

Q2：迁移后日常使用方式有变化吗？基本没有。/sdd-init、/sdd-new、/sdd-apply、/sdd-archive等命令体系一脉相承，子代理契约（status、executive_summary、artifacts 等字段，见 skills/_shared/sdd-phase-common.md）保持一致。你会额外获得 Engram 记忆、Context7 文档 MCP 和自动更新。

Q3：为什么非要迁移，继续用 Agent Teams Lite 不行吗？能继续用，但它已归档、不再有维护。而 gentle-ai 的自动更新 + 备份回滚机制意味着：以后升级工具链，你不需要再关心「脚本会不会把我的配置追加成两份」这种问题。

小结：Agent Teams Lite 的归档不是终点，而是 SDD 多智能体工作流的升级点——用 2 条命令迁到 gentle-ai，核心工作流不变，却换来了自动更新、持久记忆和 8 个助手的开箱即用。早迁移一天，早省心一天。🎯

延伸阅读：README.md · docs/architecture.md · docs/changelog.md · CONTRIBUTING.md