# 日报格式规范

## 文件名

`daily-reports/<git-username>/YYYY-MM-DD.md`

## 必须包含的章节（按顺序）

```markdown
# 📅 YYYY-MM-DD 日报 · {username}

## 概览
{1 句话总结，包含 当日最高产出价值 + 最大事故/教训（如有）}

## 一、产出（按价值排序）

按 emoji 标签分类：
- 🔴 **P0/重大修复**：影响生产 / 合规 / 数据完整性
- 🟡 **P1/重要功能**：新功能、重要 bug 修复、能力补全
- 🟢 **P2/常规**：小改进、文档维护
- 🛠 **基础设施 / 工具**：脚本、调试配置、CI、本地工具
- 📝 **文档 / 配置**：纯 docs / config 改动

每条产出包含：
- 一句话标题（动词开头）
- **根因/背景**（如果是 bug 修复）：1-2 行
- **方案**：具体改了什么，带文件链接 [path:line](path#Lline)
- **影响范围**：量化（"覆盖 11 处 where 子句"、"3 个文件 +57 -38"）

## 二、今日合入的 PR

如果有，用表格：
| PR | 标题 | 状态 | 备注 |
|---|---|---|---|

如果没有 PR 活动：写 "（今日无 PR 合入）"，不省略章节。

## 三、Git 活动

```
{commit hash} | {time} | {message}
+{files} files changed, +{add} -{del}
```

如果今日无 commit：写 "（今日改动尚未提交，见第七节"未提交改动"）"

## 四、Claude session 摘要

按 session 列出主要话题，每个 session 用 1 句话概括聚焦点：
- session {short-id}: {一句话主题}（{N} 个对话回合）

不要逐字罗列每个 Q/A，只提炼**主题**和**关键决策**。

## 五、事故 & 教训（仅在有时显示）

如果今天 .learnings/ERRORS/ 下有新增 ERR 文件，必须单独章节列出：

### ⚠️ ERR-YYYYMMDD-XXX: {简短标题}

- **现象**：1 行
- **根因**：1-2 行
- **缓解**：1 行
- **教训**：1 行
- 详见 [.learnings/ERRORS/ERR-YYYYMMDD-XXX.md](.learnings/ERRORS/ERR-YYYYMMDD-XXX.md)

如果今日无错误，**整个章节省略**（不要写"今日无错误"占位）。

## 六、新增 learnings

列出今日 .learnings/ 下的新文件（包括 ERRORS/）：

| 文件 | 类型 | 适用场景 |
|---|---|---|
| [{name}](.learnings/{name}.md) | feedback/project/reference/error | {一句话} |

如果无新增 learnings：省略章节。

## 七、未提交改动

```
{git status -s 的输出}
```

后面跟一段判断：
- 如果改动多但没拆 PR → 提示"建议拆分 PR"
- 如果只是临时调试改动 → 提示"建议清理或暂存"

## 八、待决策 / 明日计划

从对话中识别"待..."、"需要..."、"明天..."、用户提出但未推进的事项。
列点，每点说明：
- 决策内容
- 阻塞原因（如果有）
- 预估优先级

如果今天工作完整收尾、无悬挂事项：写"无明确悬挂"。
```

## 风格规则

1. **链接化所有引用**：PR 号 → Gitea 链接；commit hash → 不强制；文件路径 → markdown 链接 `[path](path)` 或带行号 `[path:42](path#L42)`
2. **量化优先**：能给数字就给数字
3. **去重**：commit 章节说过的不要在产出章节再说一遍（产出章节的关注点是"价值"，commit 章节的关注点是"动作清单"）
4. **不写过程**：装依赖、跑脚本、看了哪个文件等过程细节不写
5. **保留对话原话**：第四节 session 摘要直接引用用户的原话作为话题，不要改写
6. **不写"今天无 X"占位**：哪个章节没数据就省略，让日报更精炼

## 反例（不要这样写）

❌ "今天打开了 audit.service.ts，分析了 region 字段的处理逻辑，发现了一个潜在的 bug..."
✅ "修复审计 region 大小写不匹配（11 处 where 子句改为 mode: 'insensitive'）"

❌ "通过深入分析，我们发现并解决了多个问题"
✅ "修复 11 处查询、清理 5 个 debugger 语句、补 1 个数据 seed"

❌ "今天没有出错，一切顺利"（占位废话）
✅ 整个"事故"章节省略