文档与知识管理习惯

文档价值的重新定义
├── ✗ 旧认知：代码写完了补文档（为了交差）
├── ✓ 新认知：写码前写文档（为了设计）：
│   ├── 暴露设计缺陷（写清楚时发现漏洞）
│   ├── 让接口设计更简洁（想清楚再写）
│   └── 减少方向不明确的内耗（写完就知道要做什么）
└── 结论：文档先行 = 低成本试错 + 高质量设计

功能设计文档（写码前 30 分钟）
┌────────────────────────────────┐
│ 功能：订单导出                    │
│ 1. 解决什么痛点：运营手动导出 1000+ 订单到 Excel 耗时 2 小时   │
│ 2. 接口怎么调用：GET /api/orders/export?status=PAYING         │
│ 3. 传入什么：status 筛选 + dateRange 时间范围                 │
│ 4. 吐出什么：Excel 文件（列：订单号/金额/状态/时间/用户）       │
│ 5. 边缘情况：空数据返回空表头 Excel / 超大数据量走异步任务      │
│    / 并发导出限制 5 次/分钟                                    │
└────────────────────────────────┘
→ 写完这 5 个问题，代码结构已经清晰（甚至发现 2 个设计漏洞）

边做边记三要点
├── ① 随手记：任务/待办/跟进议题记在随时能看到的地方
│   ├── 不记脑子里（会忘）
│   └── 不记微信聊天里（会淹没）
├── ② 看板化：任务卡片带四要素
│   ├── 创建时间 / 负责人 / 截止日期 / 状态标签
│   └── 工具：看板（板栗/Trello/Notion）或轻量清单
└── ③ 周五即周报：看板拉出来就是周报草稿（零成本）

每日记录最小闭环（3 分钟）
├── 开工：今日 3 件事（优先级 TOP3）
├── 进行中：完成的打勾 + 卡住的标注原因
├── 收工：明日 3 件事预告 + 遗留问题
└── 周末：看板 = 周报 + 周复盘原料
→ 成本 3 分钟/天，收益：周报 10 分钟 + 复盘有据 + 进度可视化

单人晨会日志模板（3 行）
┌────────────────────────────────────┐
│ 2026-08-04 晨会                     │
│ 1. 昨天干完：订单导出 API + 单元测试（8 个用例全绿）│
│ 2. 今天盯死：退款幂等改造（下午 4 点前完成并提评审）  │
│ 3. 潜在隐患：支付网关联调还没确认环境，今天上午要催  │
└────────────────────────────────────┘

周报 = 记录的自然产物（不是写作任务）
├── ✗ 错误姿势：周五下午憋 2 小时回忆这周干了什么
├── ✓ 正确姿势：每天 3 分钟记录 → 周五拉取看板
│    → 补充价值说明 → 10 分钟完成
└── 周报结构：
    ├── 本周完成（从看板勾选完成项）
    ├── 下周计划（从待办池挑 TOP3）
    ├── 风险与阻塞（晨会日志里的隐患汇总）
    └── 需要支持（向协作方要资源的清单）

周报质量对照
├── ✗「本周写了订单模块、修复了 3 个 bug、开了几个会」
├── ✓「本周完成订单导出功能（已上线，运营导出耗时从 2h → 10s）；
│       修复 3 个线上 bug（均为边界条件，已补测试）；
│       下周：退款幂等改造 + 支付网关联调；
│       风险：联调环境未就绪，需要运维本周内提供」

个人知识管理系统
├── ① 统一工具：一个主力笔记工具（Notion/Obsidian/语雀）
├── ② 清晰分类：按领域/项目/时间三维标签
├── ③ 可搜索结构：标题规范（[BUG] / [方案] / [学习] 前缀）
├── ④ 三类必记内容：
│   ├── Bug 复现步骤 + 根因 + 修复方案
│   ├── 技术决策的原因（为什么选 A 不选 B）
│   └── 审查中获得的最佳反馈
└── ⑤ 定期整理：每周整理一次「本周收获」归档

知识管理闭环
├── 输入：工作中踩坑/决策/新知识（随时记）
├── 处理：每周整理归档（标签/分类/去重）
├── 输出：周复盘引用 / 技术分享 / 团队知识库
└── 复利：知识库越用越值钱——「人肉问答」变「知识库问答」