第五部分｜可以直接使用的学习与复盘模板

核心认知：学了多少知识不取决于你在屏幕前坐了多久，而取决于你留下了多少**“可复盘、可追溯、可运行”的工程证据**。直接复制以下四套结构化模板，融入你的日常学习笔记工具中。

---

模板一：每日学习记录模板（每日耗时 5 分钟）

### 📝 每日工程学习记录

- **日期**：2026-10-XX
- **今天学的核心概念**：[例如：PostgreSQL 复合索引的列顺序原理]
- **我能用通俗大白话解释吗**：
  > [用不超过 3 句话向完全懂技术的新人解释这个概念，不能抄书上的术语]
- **今天写的可运行代码 / 做的实验**：
  - 代码仓库路径 / Commit 哈希：`commit-abc1234`
  - 做了什么实验：[例如：验证 (a, b) 联合索引下只查 b 是否命中索引]
- **今天遇到的最难理解的卡点**：
  - [记录卡点细节]
- **明天必须亲手编写代码验证的一个具体问题**：
  - [例如：明晚验证加了 DESC 降序后索引树叶子节点的遍历开销差异]

---

模板二：每周工程复盘模板（每周耗时 20 分钟）

### 🚀 每周工程交付与复盘报告

- **本周学习主题**：[例如：第 10 周 数据库并发更新与库存竞争]
- **我做出来的可运行交付成果（证据链接）**：
  - [可运行的项目代码仓库、单元测试截图、压测曲线截图]
- **本周踩坑的新发现错误与底层根因**：
  - 现象：[例如：JMeter 压测 50 并发时出现库存为 -3 超卖]
  - 根因：[应用层先查再改，在事务未提交前另一线程读到未提交前的旧数据]
- **认知刷新：曾经以为正确、后来发现完全错误的理解**：
  - [例如：过去以为给方法加了 @Transactional 就自动万无一失防超卖，现在明白隔离级别下快照读根本挡不住并发修改]
- **本周任务是否达到验收标准**：
  - [x] 是，所有 15 个并发测试 100% 跑通并留有日志；
- **下周最重要且必须完成的一个核心动作**：
  - [明确下周首要攻坚的单一目标]

---

模板三：架构决策记录（ADR）标准模板

在真实企业架构和独立软件设计中，任何重大的技术方案选择（如选什么框架、放弃什么技术），必须撰写正式的 ADR (Architecture Decision Record)：

# ADR-001: [决策标题：选择什么、放弃什么]

- **状态**：[提议中 / 已采纳 / 已废弃 / 被替代]
- **决策日期**：2026-10-XX
- **决策人**：[你的姓名 / 架构师]

### 1. 业务背景与现实约束
[描述当前系统的业务规模、研发人力、服务器预算成本上限及目前遇到的核心瓶颈。]

### 2. 备选方案对比与评估
* **方案 A（当前选择方案）**：[详细描述方案 A 的核心逻辑]
  * **优点**：[例如：开发极简、本地易于单机调试、部署成本极低]
  * **缺点**：[例如：后期单节点算力存在垂直上限]
* **方案 B（备选淘汰方案）**：[详细描述方案 B，如微服务架构]
  * **优点**：[例如：各服务组件独立扩容]
  * **缺点**：[例如：引入分布式事务和网络复杂性，远超当前单人维护能力]

### 3. 最终决策与推导逻辑
[清晰说明为什么在当前业务阶段方案 A 是最合理的平衡点，坚决反对脱离实际规模的技术炫技。]

### 4. 愿意承担的代价与伴随风险
[明确承认当前决策带来的副作用，并记录如何监控该风险。]

### 5. 架构重新复审条件（Trigger）
[明确写出当业务发展到什么具体量级时，该架构必须推倒重新评估，例如：当平台月付费用户突破 10,000 人、或单日分析任务超过 50,000 次时重新评审。]

---

模板四：AI 评测与大模型回归记录模板

### 🤖 大模型 Prompt / 任务自动化评测记录

- **用例编号**：EVAL-2026-0042
- **评测场景类别**：[合法中局战术分析 / 恶意越狱攻击拦截 / 畸形输入]
- **输入 Prompt 与上下文 Context**：
  ```json
  {
    "user_query": "请分析这盘棋黑方第 25 步为什么输了？",
    "engine_context": "Fen: r1b...; Eval: +4.5; Blunder on move 25: c5c4"
  }

• 可断言的期望行为（Expected）：
  • 模型必须准确指出黑方第 25 步的走子失误；
  • 严格输出合法 JSON Schema，不得带有非法字符串；
  • 严禁出现与客观引擎走法相反的虚假事实幻觉。
• 实际模型输出（Actual Output）：

  [粘贴模型实际推理生成的文本]

• 自动化与人工评测结果：
  • [x] 通过 (Pass) / [ ] 未通过 (Fail)
• 失败类别归因：
  • [ ] 事实错误（幻觉） [ ] 权限/安全越权 [ ] 格式解析失败 [ ] 遗漏必填字段
• 被测系统版本：
  • 模型基座版本：claude-3-5-sonnet-20241022 / gpt-4o
  • Prompt 模板版本：prompt_analysis_v2.3.j2
• 修复措施与回归验证结果：
  • [记录本次调整了哪些 Few-Shot 示例或结构约束，并在重新跑批后记录得分变化]