# Daily Reports

每个开发者的每日工作日报存放目录。

## 目录约定

```
daily-reports/
├── README.md                  # 本文件
├── <git-username>/            # 每个开发者一个子目录
│   └── YYYY-MM-DD.md          # 当天的日报
```

`<git-username>` 自动从 `git config user.email` 推算（`lijian@ff.com` → `lijian`，`hongwei.zhang@ff.com` → `hongwei-zhang`）。

## 怎么生成

跟 Claude Code 说 **"写日报"** 或 **"/daily"**，它会：

1. 跑 `.agents/skills/daily-report/scripts/gather.sh` 拉取今日 git/PR/Claude session 数据
2. 综合数据 + 当前对话上下文，按 [format-spec](../.agents/skills/daily-report/references/format-spec.md) 生成 markdown
3. 覆写 `daily-reports/<your-username>/YYYY-MM-DD.md`

如果想生成历史日报（补登）：跟 Claude 说 "**生成 2026-05-07 的日报**"，脚本会按指定日期工作。

## 怎么提交

日报进 git，但不要每天单独开 PR。建议：

- 攒 1-2 周或随某个功能 PR 顺手提交
- 或走项目现有的 `chore/notes-rolling` 分支模式批量入

## 范围与边界

- **谁写谁的**：每个开发者只写自己目录下的文件，不要改别人的
- **可见性**：仓库内全员可见。需要私密内容请放本机 `.learnings/` 或个人笔记，不要放这里
- **日报 vs learnings 的区别**：
  - 日报回答"今天发生了什么"（时间点视角，按天归档）
  - learnings 回答"以后遇到这种事该怎么办"（场景视角，按主题归档）
- **日报 vs retro 的区别**：
  - 日报是单天 + 单人
  - retro 是多天 + 整团队/整项目维度

## 隐私提醒

由于目录进 git，请避免在日报中包含：
- 密码、API token、密钥
- 客户隐私数据
- 涉及他人评价的个人主观判断（团队同事可能会看到）

如果需要记录这类内容，写到 `.learnings/` 或本机笔记（`.learnings/` 在项目内但不进 git 的部分目录）。