# Pi Session Summarizer

> 提取指定时间范围内所有 pi agent session 记录，按项目分类整理为结构化 markdown 文档，保存到当前工作目录。用于定期回顾、进度汇总、工作记录归档。

- Skill: `dawnmoon1542/pi-session-summarizer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dawnmoon1542/pi-session-summarizer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dawnmoon1542/pi-session-summarizer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: DawnMoon1542 (https://skillmd.com/u/dawnmoon1542)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/dawnmoon1542/pi-session-summarizer

---


# PI Agent Session 汇总器

## 概述

从 `~/.pi/agent/sessions` 目录读取指定时间范围内的所有 JSONL session 文件，提取每个 session 的第一条用户消息（即任务描述），按项目/目录分组整理，输出为带分类目录的 Markdown 文档。

## 输入参数

用户需要提供时间范围：

- **开始日期**：格式 `YYYY-MM-DD`，必填
- **结束日期**：格式 `YYYY-MM-DD`，必填

## 输出

在当前工作目录生成 `pi-sessions-summary-<开始日期>-<结束日期>.md`，包含：

1. 统计摘要（总 session 数、涉及项目数、时间跨度、最活跃项目）
2. 按项目分组的任务列表，每个任务标注时间和简述
3. 关键主题的归纳总结

## 执行流程

### 步骤 1：运行提取脚本

使用 skill 目录下提供的 `extract-sessions.py` 脚本：

```bash
uv run <skill-dir>/extract-sessions.py --from <开始日期> --to <结束日期>
```

脚本默认会：
- 扫描 `~/.pi/agent/sessions` 下的所有子目录和 `*.jsonl` 文件
- 根据文件名中的时间戳过滤指定范围内的 session
- 提取每个 session 的第一条 `role: "user"` 消息
- 按 session 所属目录（即项目/上下文）分组
- 输出结构化 JSON 到 stdout

选项：

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `--from` | 开始日期 YYYY-MM-DD | 必填 |
| `--to` | 结束日期 YYYY-MM-DD | 必填 |
| `--sessions-dir` | sessions 根目录 | `~/.pi/agent/sessions` |
| `--output` | 输出 JSON 文件路径 | stdout |

### 步骤 2：分析并编写 MD 文档

读取步骤 1 输出的 JSON 数据，按以下结构编写 Markdown 文档：

```markdown
# PI Agent 工作记录汇总

> 时间范围：YYYY-MM-DD ~ YYYY-MM-DD

## 统计摘要

| 指标 | 数值 |
|------|------|
| 总 session 数 | N |
| 涉及项目/目录数 | N |
| 最活跃项目 | 名称(N sessions) |

## 一、项目名

| 时间 | 任务 |
|------|------|
| MM-DD HH:MM | 任务简述 |

## 二、项目名

...
```

分类原则：

1. 将 session 按 `cwd`（工作目录）合并归类，同一项目不同子目录合并
2. 项目分组按 session 数量降序排列
3. 每个 session 取截断后的首条用户消息作为任务简述（超过 80 字截断加 `...`）
4. 同一项目内按时间顺序排列

### 步骤 3：归纳关键主题

在文档末尾添加关键主题归纳，将相似任务合并为一句总结，按领域分点列出。

## 注意事项

- `subagents.jsonl` 文件自动排除
- 仅提取 `type: "message"` 且 `role: "user"` 的第一条消息
- 若某 session 无 user 消息，记录为"（无用户消息）"
- 提取脚本已内嵌在 skill 目录下，执行前无需额外安装依赖