课程导论与全景路线图 (Syllabus)

⏱ 预计阅读 6 分钟 更新于 2026/4/13

欢迎来到未来的编程方式。这不是教你如何使用 ChatGPT 写算法题的普通课程，而是教你如何建立、武装和管理一个完全由 Agent（智能代理）驱动的虚拟开发团队。

我们将从 0 到 1 打造一个真实的、跨端的**「双向同步时间块与日历管理系统」。你不需要自己去写那些繁琐的增删改查，你的工作将转变为首席架构师和产品主理人**。

路线图总览 / The 30-Episode Syllabus

Phase 1: 基建与思维重塑 (Infrastructure & Mindset)

  • Ep 01: [起心动念（人类视角的 One-Pager）]：Agent 并不是通灵师，你必须学会如何书写极简但极具约束力的 Intent One-Pager，作为项目火种。
  • Ep 02: [Antigravity 环境准备]：搭建项目的物理空壳与多仓结构，理解为什么系统需要明确的作用域和工具边界。
  • Ep 03: [灵魂植入 GEMINI.md]：编写 Agentic 时代的“汉谟拉比法典”。不准抹除旧逻辑、禁止自作聪明的过度设计。
  • Ep 04: [技能引擎 using-superpowers]：解析强制拦截机制。让 AI 在敲下第一行代码前，必须查阅本地的手册。
  • Ep 05: [物理外挂 planning-with-files]：突破大模型 Token 极限的唯一法则——磁盘记忆（task_plan.md, findings.md)。
  • Ep 06: [生成系统的第一条流水线]：创建 .agents/workflows/ 基础逻辑。

Phase 2: 由 Agent 驱动的架构设计 (Agent-Driven Architecture)

  • Ep 07: [人机辩论与 PRD 裂变]：把 One-Pager 给 Agent，让带有“怀疑者”人格的架构师帮你预见系统坑点。
  • Ep 08: [数据库选型压测]：让 Agent 自己写调查报告放入 findings.md，由你拍板决定（如选择 Prisma）。
  • Ep 09: [Schema 设计自动化]：创建 database-migration.md，指挥系统生成 User/Task/Event 模型。
  • Ep 10: [难点预研：Google Calendar OAuth]：利用系统的研究工具收集 API 规范，避免开发到一半发现限制。
  • Ep 11: [大兵团作战：任务拆解]：让 Agent 自动把宏大 PRD 翻译为 task_plan.md 里的 30 个 [ ] 编码动作。

Phase 3: 无测试不写码 (TDD Workflows)

  • Ep 12: [重构 TDD 的黄金规则]：为什么在 Agent 时代，测试即是护栏。如果不写测试，整个 codebase 会在三秒内崩塌。
  • Ep 13: [配置 test-driven-development 技能]：建立红绿重构（Red-Green-Refactor）的 AI 工作流。
  • Ep 14: [本地时间管理算法之战]：第一行代码！验证你的 Agent 如何在不断的报错中寻找出路。
  • Ep 15: [三振出局 (3-Strike) 兜底协议]：教你分析 Agent 是如何在 3 次失败后把执行权交还给你的。
  • Ep 16: [外部接口 Mock 极简道]：隔离测试，保证日历功能在本地也能跑。

Phase 4: 第三方业务决战 (External Integrations)

  • Ep 17: [OAuth 2.0 实现的安全审计]：不用靠脸猜，让 Agent 通过安全检查单进行代码生成。
  • Ep 18: [编写双向同步的心智模型]：日历应用最大的天坑：数据冲突修复。由 Agent 执笔并由你审批的“仲裁逻辑”。
  • Ep 19: [Webhook 集成]：接入实时变更事件，建立异步队列机制兜底。
  • Ep 20: [系统级代码清洗 (Refactoring)]：项目达到 2 万行时，教你如何圈出烂代码区域，让 AI 安全清洗。
  • Ep 21: [复杂数据的 Adapter 模式]：将 Google 混杂的日历对象抹平为项目的统一 Event。

Phase 5: 自动化质保与交付闭环 (Autonomous E2E & Delivery)

  • Ep 22: [E2E 测试游戏规则]：设置 e2e-testing.md，在无头浏览器中启动自动化点击测试。
  • Ep 23: [像人类一样写 Playwright]：Agent 如何分析 DOM，如何验证页面的成功弹窗。
  • Ep 24: [注入末日断言机制]：断网/服务器挂掉等异常下系统表现的断言编写。
  • Ep 25: [赛博评审员机制 requesting-code-review.md]：上线前触发“坏脾气” Senior Agent 进行代码痛批。
  • Ep 26: [标准化的 bug-fix.md 流程]：缺陷修复的唯一正确姿势：重现测试 -> 改代码 -> 同步文档。
  • Ep 27: [前端性能与打包诊断]：利用 Agent 运行脚本收集指标并实施组件拆分。
  • Ep 28: [自动化的 conventional commits]：教 Agent 主动推代码 (git push workflow)。
  • Ep 29: [会话归档 session-archive.md]：如何优雅地把你今天工作的进度归档交接给你明天的自己。
  • Ep 30: [毕业季：团队交接模式]：当项目上线后，如何写 README 以及让系统进入低成本的运维巡检期。

作者寄语： 不要自己手敲业务逻辑。克制你的手。你的任务仅仅是指挥“交响乐”。在下一期中，我们将从最核心的起点开始：你脑子里的“那个点子”该怎么写？