Appearance
一页速查表（万能模板 · 调试公式 · 验收清单）
定位：把培训最常用的三件事压到一页，随时可查。与 prompt-cards.md 配套，并可对照课件页码。
一、万能模板七要素（P25）
| 要素 | 必填 | 作用 |
|---|---|---|
| 角色 | 推荐 | 让 AI 进入专家模式 |
| 背景 | 必填 | 提供上下文信息 |
| 任务 | 必填 | 说清楚要做什么 |
| 要求 | 推荐 | 明确成功标准（要什么） |
| 约束 | 推荐 | 划定边界，防止"加戏"（不要什么） |
| 格式 | 视情况 | 指定输出形式 |
| 示例 | 可选 | 用例子教 AI 你想要什么 |
填写顺序：先任务 → 再背景 → 后约束。
两条铁律（P26）：
- 一次只改一类问题
- 改动边界说清楚——"只改这一处，别动布局""先不要新增模块"
二、调试公式（P36-P37）
完整日志 + 操作步骤 + 预期结果 = 快速解决方案可直接复制（公式示例）：
text
我运行 pnpm dev 启动项目，终端报错：[完整错误日志]
我预期的结果是：开发服务器正常启动，能在 localhost:3000 访问。
帮我分析并修复这个问题。| 你给的信息 | 节省的轮数 |
|---|---|
| 只说"报错了" | +2 轮 |
| 给最后一行日志 | +1 轮 |
| 给完整日志 | 0 轮 |
循环修复（2-3 轮解决是常态）：
可直接复制（循环修复追问）：
text
按你的方法改了，现在出现新的错误：[新错误日志]
请继续分析。三、三条验收清单
练习 1 · Hello 页面（P18/P20）
- [ ] 代码区出现 HTML
- [ ] 文件区出现文件
- [ ] 预览区（或浏览器）显示蓝色居中文字
- [ ] 举手示意
练习 2 · 名片页（P29，三轮微调）
- [ ] 第一轮：修明显错误（名字/布局错位/链接不可点）
- [ ] 第二轮：调风格（改主色/调间距，提示"不要新增模块"）
- [ ] 第三轮：小幅细化（按钮文案、间距）
练习 3 · 待办清单（P32，逐项打勾才算完成）
- [ ] 双击
index.html打开，有输入框、添加按钮和计数 - [ ] 添加 3 条任务 → 计数显示"还有 3 件事没做"
- [ ] 勾选 1 条 → 出现删除线，计数变 2
- [ ] 双击任务文字 → 可修改并保存
- [ ] 删除 1 条 → 列表少一条，计数正确
- [ ] 刷新浏览器 → 未完成任务仍在（localStorage 生效）
迭代后新增：重要任务红色圆点标记、"清除已完成"按钮。
四、更深入的排查（进阶）
→ 详见课后阅读材料《进阶指南》（./advanced-marching-guide）
五、常见概念（随手记）
| 概念 | 一句话 | 类比 |
|---|---|---|
| Agent IDE | AI 装进编程环境的工具 | 整车 |
| Token | 处理/计费最小字块 | 油钱 |
| LLM API | 按量付费调用模型 | 加油站 |
| MCP | 给 AI 外接工具的协议 | USB-C |
| Skills | 可安装的标准作业流程包 | 技能包 |
| Context | AI 一次能看见的全部信息 | 文件箱 |
| Harness | IDE 内包裹 LLM 的执行框架 | 底盘仪表盘 |