课程模板合集

AI 编程课·教学物料包·模板

适配课程：courses/02-ai-coding/course.md（M1-M5 模块，L3 七天 + L4 加量七天） 用途：L3 学员第 1 天开课前下发；L4 在 L3 基础上复用并扩展（第二产品 / 工程化 / 作品集） 使用方式：学员直接复制 Markdown → 飞书 / Notion / GitHub 填写，导师按模板逐项打钩验收 维护规则：每期开课前由助教迭代一次；学员真实填写案例经脱敏后可作为下期教学样例

一、需求文档模板（PRD-Lite）

适用：D2·第 3 课时《M2.2 需求文档：结构化模板》+ D8·第 3 课时「复用第一产品需求文档」 使用说明：五段式 + 用户故事表 + 优先级是骨架；「不做什么」一栏必填，是砍 MVP 的依据。

# [产品名] 需求文档 v[版本号]

## 1. 目标用户
- 主要用户：[具体人群 1 段话，如 "25-35 岁自由职业者，每天接 3-5 个临时项目"]
- 次要用户：[如有]
- 用户没说的痛：[用户日常抱怨但没人解决的事]
- 用户以为的痛：[用户口头说但付费意愿弱的"伪痛"]

## 2. 核心功能（V1 ≤ 5 个 / L4 第二产品 ≤ 4 个）
| # | 功能名 | 用户故事 | 验收标准 | 优先级 |
|---|--------|----------|----------|--------|
| 1 | [动词 + 对象] | 作为 [角色]，我想要 [功能]，以便 [价值] | [可测：输入 → 输出] | P0 |
| 2 | ... | ... | ... | P1 |
| 3 | ... | ... | ... | P2 |
| 4 | ... | ... | ... | P2 |
| 5 | ... | ... | ... | P2 |

## 3. 边界清单（必须写）
- 边界 A：[什么情况必须做]
- 边界 B：[什么情况必须做]
- 边界 C：[什么情况必须做]

## 4. 不做什么（与边界同样重要）
- 不做 [功能 X]，理由 [用户量太小 / 不是核心 / 推迟到 V2]
- 不做 [功能 Y]，理由 [...]
- 不做 [功能 Z]，理由 [...]

## 5. 验收标准（产品级）
- [ ] 核心路径：从打开到完成 ≤ [N] 步
- [ ] 首屏加载 ≤ [N] 秒（移动 4G）
- [ ] 错误场景：每类错误都有用户可见提示
- [ ] 数据：核心流程跑通 X 条假数据
- [ ] 兼容：[Chrome 最新版 / Safari 最新版 / 微信内置]

## 6. 评审修改清单（AI 评审输出）
- 高优：[必须改]
- 中优：[应该改]
- 低优：[可改可不改]

二、技术方案模板

适用：D2·第 5-6 课时「技术选型 / 部署 / 成本」+ D8·第 4 课时「复用 vs 新选决策表」 使用说明：四块结构 + 决策表 + 成本测算；「复用 vs 新选」是 L4 加量天核心增量。

# [产品名] 技术方案 v[版本号]

## 1. 形态选型
| 选项 | 适合场景 | 优势 | 劣势 | 本产品决策 |
|------|----------|------|------|-----------|
| 网页 | SEO / 工具 / 验证想法 | 开发最快 / 无审核 | 用户停留短 | |
| PWA | 工具类 / 离线场景 | 可安装 / 跨平台 | iOS 体验一般 | |
| 小程序 | 国内 C 端 / 微信生态 | 获客成本低 | 受平台约束 | |
| App | 高频 / 重交互 | 体验最佳 | 审核 / 启动成本 | |

决策 + 3 条理由：[ ... ]

## 2. 技术栈
| 层 | 选型 | 版本 | 选型理由 |
|----|------|------|----------|
| 前端框架 | Next.js / Vue / ... | [锁定近 1 年稳定版] | |
| UI 库 | shadcn / Ant Design / ... | | |
| 后端 | Node.js / Python / BFF | | |
| 数据库 | Supabase / 腾讯云开发 / ... | | |
| 鉴权 | Supabase Auth / Clerk | | |
| 部署 | Vercel / Zeabur / Cloudflare | | |
| AI 能力 | 直接调 API / Coze / Dify | | |

## 3. 部署方案
- 域名：[example.com / 子域名]
- HTTPS：Let's Encrypt / Cloudflare
- CI：GitHub push → 自动部署
- 环境变量：[列出全部 Key 名，不写真值]

## 4. 成本测算（按月）
| 项 | 单价 | 用量 | 小计 |
|----|------|------|------|
| 域名 | [年付折月] | 1 | |
| Vercel | 免费 / Pro | | |
| Supabase | 免费 / Pro | | |
| 大模型 API | [按 1000 次/月起算] | | |
| Cloudflare | 免费 | | |
| **月合计** | | | [元] |

## 5. 风险清单
| 风险 | 概率 | 影响 | 兜底方案 |
|------|------|------|----------|
| API Key 泄露 | 中 | 高 | 后端代理 + 环境变量 |
| 大模型 API 涨价 | 中 | 中 | 缓存 + 多模型备份 |
| Supabase 配额超限 | 低 | 中 | 升级或迁移 |
| 用户数据合规 | 低 | 高 | 不存敏感字段 + 用户协议 |

## 6. 复用 vs 新选决策表（L4 加量天专用）
| 维度 | 第一产品已有 | 第二产品选择 | 理由 |
|------|-------------|-------------|------|
| UI 组件库 | shadcn | 复用 / 换库 | |
| 提示词库 | 50 条 | 复用 + 新增 | |
| 部署流水线 | Vercel | 复用 / 升级 | |
| Supabase | p1 项目 | **新建 p2 项目** | 隔离硬性要求 |
| 域名 | a.com | 独立 b.com | 品牌独立 |
| 大模型 Key | sk-p1-xxx | **新建 sk-p2-xxx** | 配额独立 + 风险隔离 |

三、产品开发日志模板

适用：D1-D7 全程（每日 17:30 前提交）+ D8-D14 双产品并行 使用说明：单日一页；卡点必填（含报错原文）；AI 求助记录要附「提问公式」原文，便于复盘。

# 开发日志 · [产品代号 P1/P2] · [YYYY-MM-DD] · D[天数]

## 今日任务（来自昨日计划）
1. [ ]
2. [ ]
3. [ ]

## 完成项
- [x] [具体功能 / commit 链接]
- [x] [具体功能 / commit 链接]

## 卡点（最关键！必填）
- 卡点 1：[报错原文 / 现象]
  - 已尝试：[1 / 2 / 3]
  - 当前状态：[未解 / 已解 / 已绕开]
  - 求助：[导师 1v1 / 群里 / AI]

## AI 求助记录（每个提问记录一次）
| # | 我的提问（完整公式） | AI 回复要点 | 是否采纳 |
|---|---------------------|------------|----------|
| 1 | "我做了 X，期望 Y，实际 Z，完整报错 W。环境是 Next.js 14 + Supabase。" | [...] | 是 / 否 / 部分 |

## 明日计划
1. [ ]
2. [ ]
3. [ ]

四、每日站会 3 行日报模板

适用：每日 17:30 前群内提交；L3 1 个产品 / L4 双产品各 1 行 使用说明：3 行定式，零废话；卡点必须可识别，导师当晚合并共性问题。

L3 单产品版

【D2 日报 / 张三】
1. 今日完成：需求文档 v1 + Supabase 项目初始化 + 登录页骨架（commit abc1234）
2. 卡点：用 Cursor 改组件样式时，AI 改了 3 次仍和设计稿有色差（rgba 值不一致）
3. 明日计划：完成首页 UI + 跑通邮箱魔法链接登录

L4 双产品版

【D9 日报 / 张三 · P1】
1. 今日完成：列表分页 + 错误兜底 5 类 + commit ef5678901
2. 卡点：大模型 API 偶发超时，已加 3s timeout + 1 次重试
【D9 日报 / 张三 · P2】
1. 今日完成：RAG 知识库切片策略调整（按段落）+ 检索命中率自测
2. 卡点：Coze 工具调用链路超过 5 步，需拆分 Agent
3. 明日计划：P1 接 Supabase RLS / P2 完成 Agent 兜底降级

五、上线检查清单

适用：D6·第 4 课时 + D10·第 6 课时「双产品自查清单」 使用说明：四大类全打钩才能上线；「未通过」项必须当晚修复，不许带病过夜。

# 上线检查清单 · [产品名] · [YYYY-MM-DD]

## A. 功能（核心路径）
- [ ] A1 核心路径全跑通（端到端，不分步）
- [ ] A2 至少 1 位非开发者真实用户成功使用
- [ ] A3 错误路径每类都有用户可见提示（不白屏）
- [ ] A4 数据：刷新后还在
- [ ] A5 自测报告提交到 GitHub

## B. 性能
- [ ] B1 首屏 ≤ 3 秒（移动 4G / Chrome DevTools 节流）
- [ ] B2 LCP ≤ 2.5s（最大内容绘制）
- [ ] B3 没有 N+1 查询（数据列表 ≤ 200ms）
- [ ] B4 图片都有 width + height（无 CLS）
- [ ] B5 关键路径已加 cache 控制

## C. 安全
- [ ] C1 API Key 不在前端代码（grep 不到）
- [ ] C2 API Key 不在 git 历史（git log -p 搜不到）
- [ ] C3 API Key 不在群消息 / 截图
- [ ] C4 鉴权开启（Supabase RLS / 后端校验）
- [ ] C5 HTTPS 全站启用（含 www / 非 www）
- [ ] C6 部署平台环境变量已配置（不是本地 .env）
- [ ] C7 CORS / CSP 配置正确（按 web/security 规则）

## D. 隐私合规
- [ ] D1 用户协议 / 隐私政策上线并可点开
- [ ] D2 AIGC 内容已显式标识（如有 AI 生成：角标 / 文字说明 / 元数据）
- [ ] D3 不存身份证 / 银行卡 / 健康数据
- [ ] D4 数据最小化：只存业务必需字段
- [ ] D5 数据库已备份（Supabase 自动 + 手动导出）
- [ ] D6 域名备案（如服务器在国内）

## E. 双产品隔离（L4 专用）
- [ ] E1 两个产品的 Supabase 项目独立
- [ ] E2 两个产品的域名独立 / 子域名独立
- [ ] E3 两个产品的 API Key 独立
- [ ] E4 两个产品互不串数据 / cookie / 跳转
- [ ] E5 隔离自测报告提交

六、提示词库（三层表达法 · 20 场景化模板）

适用：D1·第 7 课时 + 全程（学员可在线维护个人提示词库） 使用说明：三层 = 目标（What / For Whom）+ 约束（Stack / Limit / Edge）+ 验收（Done Means / Test）；每场景直接复制套用。

通用三层结构

【目标】为 [目标用户] 做 [功能/产物]，解决 [具体问题]
【约束】技术栈 [栈名 + 版本]；不要 [明确禁止]；性能 [具体指标]
【验收】怎么算完成：[可测标准]；边界情况：[至少列 3 个]

20 条场景化模板（按课程模块分组）

M1 工具与认知

  1. 让 AI 翻译一行陌生代码

    【目标】把这段代码用 [人类语言] 解释给 [角色] 听，重点说它做了什么、为什么这样写
【约束】不要修改原代码；解释 ≤ 200 字；用类比
【验收】我能用 1 句话复述它的作用

  2. 让 AI 选工具栈

    【目标】为 [产品方向] 选 [前端框架 / 数据库 / 部署平台]，输出对比表
【约束】只对比 3 个候选；每列含学习成本 / 部署速度 / 国内访问 / 费用
【验收】表里能直接圈出推荐项 + 1 句话理由

  3. 让 AI 写第一个 commit message

    【目标】根据本次 diff 写 commit message（英文）
【约束】conventional commits 格式；type ∈ feat/fix/refactor/docs/test/chore；≤ 72 字
【验收】我能看懂这次改动的核心目的

M2 需求与方案

  1. 让 AI 评审需求文档

    【目标】扮演严格的 PM，评审附件需求文档，挑出所有漏洞
【约束】严格挑刺，不要夸；每条意见含修改建议；按高优 / 中优 / 低优分级
【验收】产出修改清单，≥ 10 条

  2. 让 AI 生成建表 SQL

    【目标】根据 [实体清单 + 关系] 生成 PostgreSQL 建表 SQL
【约束】每张表含 uuid 主键 + created_at/updated_at；字段必填/默认值/索引都要标；金额用 numeric 不用 float
【验收】SQL 能直接复制到 Supabase SQL Editor 跑通；外键 + 索引都建好

  3. 让 AI 做技术选型决策表

    【目标】为 [功能] 选 [技术方案]，输出 3 选 1 决策表
【约束】每个候选含：实现成本 / 学习曲线 / 社区活跃度 / 长期维护
【验收】推荐 1 个 + 3 条理由，可直接放进技术方案文档

  4. 让 AI 估算月度运营成本

    【目标】估算 [产品名] 月度运营成本
【约束】按 [N] 月活 / [M] 千次 API 调用 / 数据库 [X] GB 算；列出每个服务商单价
【验收】合计金额 + 1 张表 + 3 条降本建议

M3 开发与联调

  1. 让 AI 把功能拆成子任务

    【目标】把 [功能名] 拆成 5 个独立可验证的子任务
【约束】按用户路径排序；每个子任务含「输入 / 处理 / 输出 / 验收」
【验收】每个子任务 ≤ 半天工作量；可单独 commit

  2. 让 AI 写组件

    【目标】实现 [组件名] 组件（React/Vue）
【约束】TypeScript；props 含类型；≤ 200 行；含 loading / empty / error 三态
【验收】复制即用 + 改 props 名不报错

  3. 让 AI 同时给 3 种实现方案

    【目标】为 [业务逻辑] 同时给 3 种实现：保守 / 平衡 / 激进
【约束】每种含：思路 / 代码骨架 / 适用场景 / 风险
【验收】我能自己选 1 个，并说出为什么

  4. 让 AI 改样式不动逻辑

    【目标】把当前 [页面] 改成 [目标风格]
【约束】只改样式文件 / className，不动 JS 逻辑；动效只用 transform/opacity
【验收】dev diff 只动 CSS / className 行

  5. 让 AI 加错误兜底

    【目标】给 [功能] 补全 5 类边缘情况兜底：空数据 / 超长输入 / 网络失败 / 重复操作 / 并发
【约束】每类错误必须用户可见提示，不能只 console.log；后端有日志
【验收】5 类场景各跑 1 次都不白屏

  6. 让 AI 接大模型 API

    【目标】接入 [模型名] 聊天 API，含流式响应（SSE）
【约束】Key 走环境变量 + 后端代理，绝不写前端；超时 30s；失败有兜底
【验收】前端打字机效果跑通；Key 不在前端 bundle

  7. 让 AI 写测试用例

    【目标】为 [功能] 生成 ≥ 10 条测试用例
【约束】含场景 / 输入 / 预期 / 优先级 P0/P1/P2；含 happy path + 边界
【验收】AI 容易漏业务细节，必须人工 review

  8. 让 AI 写测试代码

    【目标】把上述用例表转成 Vitest / Playwright 测试代码
【约束】每个用例独立 it；断言明确；mock 外部依赖
【验收】跑通 0 fail

M4 部署与上线

  1. 让 AI 写部署步骤

    【目标】把 [项目] 部署到 [Vercel / Zeabur]，输出 5 步清单
【约束】含环境变量清单（不含真值）；含 build 命令；含部署后冒烟测试 3 项
【验收】新学员照着做 30 分钟内能上线

  2. 让 AI 写上线公告

    【目标】为 [产品名] 写一段上线朋友圈文案（≤ 100 字）
【约束】含：解决谁的什么问题 / 一句话差异化 / 链接
【验收】不发完没人问"这是什么"

M5 工程化 / 作品集 / 变现

  1. 让 AI 写作品集 README

    【目标】把 [项目] 写成作品集 README（中文）
【约束】七段式：简介 / 核心功能（截图）/ 技术栈 / 架构图（Mermaid）/ 踩坑与解决 / 演示视频 / 上线链接
【验收】招聘方 1 分钟看完能讲清这个项目

  2. 让 AI 改简历项目段

    【目标】把简历中 [项目名] 一段按 STAR 重写
【约束】S 情境 / T 任务 / A 行动 / R 结果；结果必含数据（用户数 / 留存 / 上线时间）
【验收】面试官扫一眼能问出"具体怎么做的"

  3. 让 AI 评审变现思路

    【目标】为 [产品名] 评审 4 种变现路径：订阅 / 买断 / 广告 / 服务化
【约束】每种评估：用户付费意愿 / 复购率 / 与产品形态匹配度；推荐 1 种
【验收】我能在 1 句话里说清为什么选这个

七、路演评审表

适用：D7·第 6 课时「学员轮流 3 分钟」+ D14·第 2-3 课时「5 分钟综合演示」 使用说明：四维（L3）/ 五维（L4）；去掉最高最低取平均；评语必须具体到项目。

# 路演评审表 · [学员名] · [期数] · [日期]

| 维度 | 1 分 | 2 分 | 3 分 | 4 分 | 5 分 | 评分 |
|------|------|------|------|------|------|------|
| **需求真实性** | 自嗨 / 无用户 | 假设用户 | 模糊人群 | 具体人群 + 真实痛点 | 已验证付费意愿 | ☐ |
| **完成度** | 仅骨架 | 单功能跑通 | 核心路径通 | 多功能 + 边缘兜底 | 上线 + 内测 ≥ 3 人 | ☐ |
| **体验/演示** | 念稿 / 截图 | 静态展示 | 真链接 + 1 操作 | 真链接 + 流畅演示 | 现场氛围 + 备用方案 | ☐ |
| **技术方案** | 未思考 | 单层架构 | 含选型理由 | 含决策表 + 成本 | 含复用 + 工程化亮点 | ☐ |
| **工程化亮点**（L4 专用） | 无 | 用了 1 个工具 | 加了 MCP / RAG / Agent 任一 | 含架构图 + 代码片段 | 完整可复用 + 已沉淀到 snippets | ☐ |

**综合分**：[去掉最高最低后平均]

**评语（必须具体）**
- 1 个优点：[具体到项目 / 行为 / 现场表现]
- 1 个改进点：[具体到「下次如何做得更好」]

八、报错求助模板（AI Debugger 提问公式卡）

适用：D5·第 2-3 课时「报错阅读法 + 提问公式训练」 使用说明：四件套（背景 / 目标 / 已尝试 / 报错）+ 卡死 30 分钟立刻举手

【报错全文】
[完整复制报错，不要只截半屏]

【背景】
- 我在做什么功能：[一句话]
- 我的环境：[Node 20 / Next.js 14 / Supabase / 浏览器 Chrome 120]
- 触发步骤：[点击 X 按钮 → 输入 Y → 点 Z]

【期望 vs 实际】
- 期望：[应该发生什么]
- 实际：[实际发生什么]

【已尝试】（按时间顺序）
1. 搜了 [关键词]，没找到
2. 试了 [方法 A]，结果 [B]
3. 试了 [方法 C]，结果 [D]

【希望 AI 帮我】
- [ ] 解释报错原因
- [ ] 给修复方向（不给完整代码）
- [ ] 给可运行的最小修复

如果信息不够，请反问我，不要猜。

3 个反面教材（学员常踩）

  1. ❌ “报错了，帮我看看” → ✅ 补全四件套
  2. ❌ 一次性贴 5 个报错 → ✅ 一次只问一个
  3. ❌ 只说”AI 不行” → ✅ 必须先说自己尝试过

九、项目作品集结构模板

适用：D13·第 2-4 课时「3 个项目 README」+ D13·第 8 课时「作品集 v1 提交」 使用说明：七段式 README + Mermaid 架构图 + 演示视频；L3 至少 1 个项目，L4 至少 3 个。

# [项目名] · 作品集 README

> 一句话说清：[面向 X 用户，解决 Y 问题的 Z 产品]

## 1. 项目简介（≤ 3 段）
- 第一段：用户痛点 + 一句话解决方案
- 第二段：与同类产品的差异化（1 句话）
- 第三段：上线状态（域名 + 访问量 + 用户反馈）

## 2. 核心功能（截图 + 列表）
### 功能 1：[动词 + 对象]
![截图位 1：桌面端](screenshot/desktop-1.png)
![截图位 2：移动端](screenshot/mobile-1.png)
### 功能 2：...
### 功能 3：...

## 3. 技术栈
| 层 | 选型 | 理由 |
|----|------|------|
| 前端 | | |
| 后端 | | |
| 数据库 | | |
| 部署 | | |
| AI 能力 | | |

## 4. 架构图（Mermaid）
```mermaid
graph LR
  A[用户] --> B[前端]
  B --> C[后端 BFF]
  C --> D[Supabase]
  C --> E[大模型 API]

5. 踩坑与解决（L4 差异化点）

# 问题 排查过程 最终方案 反思
1
2
3

6. 演示视频

7. 上线链接 + GitHub

十、学员结业证言收集表

适用：D14·第 4 课时「评委合议 + 证言收集」+ 后续宣传 使用说明：1 句话证言 + 1 张工作照 + 授权勾选三件齐；授权必填，未勾选不公开。

# 学员结业证言收集表 · [期数] · [YYYY-MM-DD]

## 基本信息
- 姓名（公开名 / 昵称）：[ ]
- 期数 / 日期：[第 X 期 / YYYY-MM-DD]
- 1 分钟自我介绍（用于校友页）：[ ]

## 证言
### 1 句话证言（≤ 50 字，用于海报）
"[ ]"

### 做了什么产品
- 产品名：[ ]
- 一句话：[ ]
- 上线链接：[ ]

### 收获（按重要性排 ≥ 3 条）
1. [ ]
2. [ ]
3. [ ]

### 上线链接 / GitHub
- 产品：[ ]
- GitHub：[ ]

## 授权（必勾选，未勾选视为不公开）
- [ ] 授权将我的 1 句话证言用于课程官方宣传（官网 / 公众号 / 朋友圈）
- [ ] 授权将我的工作照用于课程官方宣传
- [ ] 授权将我的产品上线链接 + 截图用于课程官方宣传
- [ ] 授权匿名（仅展示证言，不展示姓名）

## 拍摄清单（助教必填）
- [ ] 1 张工作照（学员在机前操作产品）
- [ ] 1 张作品集截图（个人主页）
- [ ] 1 段 30 秒语音 / 视频证言

附录·模板使用约定

模板 L3 用 L4 用 提交位置
1. 需求文档 D2 第 3 课时 D8 第 3 课时（第二产品） 飞书 / GitHub
2. 技术方案 D2 第 6 课时 D8 第 4 课时 飞书 / GitHub
3. 开发日志 D1-D7 每日 D8-D14 每日（P1/P2 各一） GitHub Issue #P1- / #P2-
4. 每日站会 D1-D7 群内 D8-D14 群内（双产品各一） 学员群
5. 上线检查清单 D6 第 4 课时 D10 第 6 课时（双产品版） GitHub
6. 提示词库 全程 全程 + 沉淀到 ai-coding-snippets 飞书 / GitHub
7. 路演评审表 D7 第 6 课时 D14 第 2-3 课时 飞书空间
8. 报错求助模板 D5 第 2-3 课时 D5 + D9-D14 学员群 / 1v1
9. 作品集模板 D13 D13 GitHub Profile / 个人主页
10. 证言收集表 D7 结营 D14 结业 助教收集归档