掌事秘书

技能文档

---
name: aiweko-memory-reports
title: 掌事秘书
category: 办公效率
description: 一键为工作空间搭建本地三层记忆体系（用户级记忆、项目长记忆、每日流水日志），并固化任务完成自动追加流水的习惯。纯本地文件初始化，不联网、不创建自动化、不读凭证。当用户请求「搭建工作记忆体系」「初始化工作日志」「帮我记住工作上下文」「搭建记忆和汇报系统」时触发。
---

# 掌事秘书 · 个人记忆与汇报体系

帮用户在自己的工作空间建立一套**可持续运转的记忆与汇报系统**，核心是三件事：

1. **三层记忆体系** —— 让 AI 跨会话记住用户偏好与项目背景。
2. **任务自动日志** —— 每次完成实质工作，自动向当日流水日志追加记录。
3. **可选自动日/周/月报** —— 按 `references/automations.md` 单独创建定时任务，固定时间汇总流水日志生成汇报文件。

整套系统可跨工作空间复用，纯本地文件 + 可选定时自动化，不联网、不读凭证。

---

## 零门槛启动（安装者必读）

安装后**不需要你手动粘贴任何路径**。在你正在用的工作空间里，直接用自然语言说一句即可触发本技能：

- 「帮我搭建工作记忆体系」
- 「初始化我的工作日志 / 每日流水」
- 「给我的工作空间装上记忆和汇报」

Agent 会**解析你当前所在工作空间的绝对路径**，并把它显式传给初始化脚本（`--workspace <绝对路径>`，不依赖脚本默认的当前目录，避免初始化到错误位置；不联网、不读凭证），然后用大白话告诉你做了什么、下一步能干什么。整个过程你只需说一句话。

> 「零门槛」指**你不用手动粘贴路径**，不是「脚本不需要路径」。Agent 必须解析当前工作空间绝对路径并显式传入，切勿依赖 `os.getcwd()` 默认值——否则 Agent 执行时若当前目录不是用户工作空间，会初始化到错误目录。

> 日 / 周 / 月报自动化**默认不自动创建**（需你主动说「创建我的日报自动化」之类）。这是有意为之：避免未经确认的定时任务，也更利于上架审核。

---

## 一、三层记忆结构

| 层级 | 位置 | 内容 | 写入规则 |
|---|---|---|---|
| 用户级长期记忆 | `~/.workbuddy/MEMORY.md` | 用户偏好、协作习惯、通用工作准则 | 长期稳定，谨慎改 |
| 项目长记忆 | `<工作空间>/.workbuddy/memory/MEMORY.md` | 该工作区长期背景、结构约定 | 重要事实沉淀，可演化 |
| 每日流水日志 | `<工作空间>/.workbuddy/memory/YYYY-MM-DD.md` | 当天完成的实质工作流水 | **append-only，只加不改** |

**联动关键**：日/周/月报自动化读取流水日志汇总。不写流水，汇报就空。所以「自动日志」与「自动汇报」是一套，必须同时建。

---

## 二、执行流程（Agent 照做 · 即装即用默认）

> **默认模式 = 单工作空间即装即用**：在用户当前工作空间跑一次初始化即可，报告落在本空间 `outputs/汇报/`，打开当前空间就能看，无需新建文件夹、无需在 UI 手动「打开文件夹作为工作空间」。多空间集中汇总的进阶玩法见文末「五、可选高级模式：汇报中枢」。

### 步骤 1 · 初始化目录与记忆文件
运行自带脚本。**必须显式传入当前工作空间绝对路径**（Agent 解析当前工作空间路径后传入，不要依赖脚本的 `os.getcwd()` 默认值——否则 Agent 执行时当前目录可能不是用户工作空间，导致初始化到错误目录）：
```bash
python3 <本技能目录>/scripts/setup_memory.py --workspace "<当前工作空间绝对路径>"
```
- `<本技能目录>` = 本 SKILL.md 所在目录；解析其 `scripts/setup_memory.py` 的绝对路径运行即可。
- 脚本只创建缺失的文件，已存在则跳过，**幂等安全**，可放心直接运行（想先看将要创建什么，可加 `--dry-run`）。
- 脚本会创建：标准目录（inbox/processing/outputs/汇报/archive/backup/automation）、项目记忆 MEMORY.md、reports-state.md（结构化状态字段）、sync-state.md、用户级 MEMORY.md（若不存在）。
- **项目记忆 MEMORY.md 会自动写入「会话级汇报补偿规则」**（完整规则见 `references/automations.md` 文末同名章节）。该规则在每次会话开始时随记忆注入上下文，Agent 据此主动补齐因关机/睡眠/定时未触发而错过的日/周/月报——这是比定时 automation 更可靠的兜底。

### 步骤 2 · 建立自动日志习惯
在 SKILL 记忆机制里固化：每次完成实质工作，向 `<工作空间>/.workbuddy/memory/YYYY-MM-DD.md`（当天日期文件）追加一条，格式：
```
- HH:MM 做了什么 → 产出物路径
```
（这条规则由 Agent 在每次任务收尾时自动执行，无需用户操作。）

### 步骤 3 · 提示用户可继续创建自动汇报
如果用户需要定时日报 / 周报 / 月报，读取 `references/automations.md`，按其中配置用 `automation_update(mode="create")` 创建。本技能包本身**不自动创建自动化**，以降低安全扫描风险。
- 前 3 个（日/周/月报）可直接创建，`cwds` **填单一工作空间路径 = 当前工作空间**（默认即装即用）。切勿把多个工作空间都填进 `cwds`，否则报告会按相对路径写进每个空间、同名文件分散到多处。（仅当启用文末「汇报中枢」高级模式时，此处才改填中枢单空间。）
- 第 4 个（产出物同步知识库）需用户先在连接器授权知识库后再建，未授权前不得创建。

### 步骤 4 · 向用户说明后续动作（用大白话，别甩术语）
交付后用以下友好模板向用户总结（按实际微调）：

```
✅ 已为你搭好本地记忆体系（就在你当前的工作空间）
· 已建好目录和记忆文件
· 以后我每完成一件实质工作，会自动往「每日流水日志」记一笔
· 想看定期汇报？说一句「创建我的日报/周报/月报自动化」即可（可选）
· 汇报文件会出现在：outputs/汇报/ ，随时打开看
```

- 三层记忆文件已就位，后续由 Agent 在每次任务收尾自动追加流水。
- 若需要定时汇报，可按 `references/automations.md` 创建自动化。
- 汇报文件将落在 `outputs/汇报/`，可随时查看。

---

## 三、红线（必须遵守）

- 不读凭证、不联网、不调用外部 API（除非用户明确授权知识库连接器）。
- 自动化 `cwds` 必须指向用户真实工作空间，不得照抄示例。
- 不创建未授权的自动化；第 4 个同步任务需用户确认连接器后再建。
- 流水日志只追加不改；记忆文件谨慎修改，不删用户既有内容。

## 四、适用范围

适用于任何想持续沉淀工作、自动汇总汇报的用户。配置与提示词已通用化，不含任何内部体系标识。

## 五、可选高级模式：汇报中枢（多空间集中）

> ⚠️ **非即装即用**：本模式需手动新建文件夹、在平台界面里「打开文件夹作为工作空间」开户、并改用户级 `~/.workbuddy/MEMORY.md`。**普通用户不需要**，默认走上面第二节即可。仅当你**同时用多个工作空间、且希望日/周/月报汇成一处**时才启用。

**为什么需要**：报告的"分散 / 同名覆盖"问题，根因在数据源分散——每个空间各记各的流水日志。只改报告落盘路径仍会得到多份无法汇总的小结。中枢模式的关键是**先把流水日志集中到一个固定工作空间**，报告自然汇成一份。

**落地 4 步**：
1. **建中枢并开户**：新建一个固定文件夹作汇报中枢（如 `~/reports-hub`），运行 `setup_memory.py --workspace <中枢>` 初始化一次；然后在平台客户端用「打开文件夹作为工作空间 / + 添加空间」把该文件夹开户（否则它不会显示在侧边栏空间列表——建文件夹 ≠ 自动注册为空间）。
2. **集中流水日志**：在用户级 `~/.workbuddy/MEMORY.md`（跨所有工作空间共享）加一条规则——所有工作空间完成实质工作后，流水日志统一追加到 `<中枢>/.workbuddy/memory/YYYY-MM-DD.md`，**不再写当前工作空间的 memory**。这是对「默认仅限当前工作空间」的 deliberate 例外，仅限流水日志这一类。
3. **单空间 automation**：按 `references/automations.md` 创建日 / 周 / 月报 automation 时，`cwds` **只填中枢单空间**，报告落到中枢 `outputs/汇报/`。
4. **验证显示**：开户后侧边栏应出现中枢空间，点开即见 `outputs/汇报/`。

**收益**：单一数据源 → 报告可跨空间合并；同名文件不再分散；打开中枢空间即可看全部日 / 周 / 月报。
**注意**：中枢 `reports-state.md` 初次为「未生成」时，首个周期（下周一 / 每月 1 号）会自动生成一份「合并各空间日志」的历史报告，属整合红利，非 bug。

---

## 六、会话级汇报补偿（核心兜底 · 摆脱开关机/定时脆弱性）

定时 automation（日/周/月报）只是「准点锦上添花」。真正的兜底是**会话级补偿**：只要用户打开任意会话，Agent 自动读 `reports-state.md`，把因关机/睡眠/未触发而错过的日/周/月报**一次性补齐**（可补多天），靠去重字段保证不重复。

- 完整规则见 `references/automations.md` 文末「会话级汇报补偿规则」（含日/周/月各自基线、遍历与跨年回滚算法）。
- 该规则由 `setup_memory.py` 写入工作空间的项目 `MEMORY.md`，会话开始时随记忆注入，Agent 据此主动执行。
- **日报昨日门控**：补偿在 `当前时间 < 07:00` 时不碰昨天（target 临时改为前天），避免在昨日尚未闭合时锁定不完整报告；≥07:00 才生成昨日日报。周/月报覆盖的是已结束的过去周期，任意时刻都可补，无此门控。
- **无产出不堆空报告**：某日/周/月没有任何工作日记时，不生成报告文件、只推进 `reports-state` 状态，避免空报告堆积。
- 边界：补偿依赖「用户总会再打开会话」——连续多日完全不开时，那些日报挂账，下次打开一次性补齐（符合预期）。

## 七、常见问题 FAQ（排错指引）

| 问题 | 原因 | 怎么办 |
|---|---|---|
| 跑脚本报「没有写入权限」 | 工作空间目录只读，或你在该目录无写权限 | 换一个你有写权限的目录作工作空间，或检查目录属性是否只读 |
| 报「磁盘空间不足 / 无法创建目录」 | 磁盘满，或路径含非法字符 | 清理磁盘，或换一个普通中英文路径的工作空间 |
| 日报 / 周报 / 月报是空的 | 还没写流水日志，或自动化 `cwds` 没指向正确空间 | 先让 Agent 完成一些工作（会自动记流水），再触发汇报；检查 automation 的 `cwds` 是否为当前空间 |
| 想改汇报生成的时间 | 默认：日报次日 07:00（覆盖昨日）、周报周一 07:00（覆盖上周）、月报 1 号 07:00（覆盖上月） | 改 `references/automations.md` 里对应 automation 的 `rrule`，或直接编辑对应 automation。**无需时间门控**：报告覆盖已结束的过去周期，提前触发无害，靠 `reports-state.md` 去重防重复 |
| 关机/睡眠错过了定时，汇报没生成 | 定时 automation 未触发 | **无需担心**：下次打开任意会话，会话级补偿规则自动补齐缺失的日/周/月报（见第六节）。去重字段保证不重复 |
| 某天/某周/某月没干活，为什么没有对应报告文件 | 设计如此：无工作日记的期**不生成报告文件，只推进 `reports-state` 状态**，避免空报告堆积 | 正常现象；如需留痕，日记本身就是记录。状态推进即代表该期「已处理」，去重仍正确 |
| 凌晨打开会话，昨天的日报没出 | 补偿规则在 `当前时间 < 07:00` 时不碰昨天（避免在昨日尚未闭合时锁定不完整报告），target 临时改为前天 | ≥07:00 后再开一次会话、或等 07:00 定时任务，昨日日报即生成 |
| 首次安装后历史日记很多，补偿一次生成了一堆报告 | 补偿从「最早的日记文件」回填全部历史（不再固定只回填 8 天） | 属正常；如不想回填全部，可手动把 `reports-state` 对应字段设为较近的日期后再开会话 |
| 汇报没生成（补偿也没补） | 查：① 项目 `MEMORY.md` 是否含「会话级汇报补偿规则」（setup 应已写入）；② `cwds` 是否指向正确空间；③ `reports-state.md` 去重字段是否被手改；④ 该周期是否真的无工作日记 | 补齐 MEMORY.md 规则或修正 `cwds` 后，下次会话即触发补偿 |
| 用了多个工作空间，报告分散到各处 | 默认即装即用是单空间模式 | 如需集中汇总，启用文末「汇报中枢」高级模式 |
| 知识库同步自动化建不了 | 未授权知识库连接器 | 先在连接器里授权知识库，再让 Agent 创建第 4 个自动化 |
| 重复运行初始化脚本会覆盖我的内容吗 | 不会 | 脚本幂等：已存在的文件自动跳过，只创建缺失项 |

---

## 八、效果示例

**1) 初始化成功后，Agent 给用户的提示（示例）**
```
✅ 已为你搭好本地记忆体系（就在你当前的工作空间）
· 已建好目录和记忆文件
· 以后我每完成一件实质工作，会自动往「每日流水日志」记一笔
· 想看定期汇报？说一句「创建我的日报/周报/月报自动化」即可（可选）
· 汇报文件会出现在：outputs/汇报/ ，随时打开看
```

**2) 一份日报样例（`outputs/汇报/日报-2026-07-16.md`）**
```
# 工作日报 · 2026-07-16

## 今日成果回顾
- 完成三层记忆体系搭建，输出目录与记忆文件就位
- 修复日报提示词流水日志文件名 bug

## 进行中阻塞
- 无

## 待办推进
- 补充 FAQ 与效果示例文档

## 经验沉淀
- 建文件夹 ≠ 自动注册为空间，需在 UI 手动开户
```

**3) 每日流水日志样例（`.workbuddy/memory/2026-07-16.md`）**
```
- 14:30 搭建记忆体系 → 生成 inbox/processing/outputs 等目录与 MEMORY.md
- 15:10 修复日报 prompt 文件名 → reports-state.md 更新
```

> 上面三份样例真实反映了本技能的产出形态：友好提示（用户看得到）、汇报文件（outputs/汇报/）、流水日志（记忆文件）。三者由同一套初始化 + 自动日志机制驱动。

使用说明

# 掌事秘书

一键搭建本地三层记忆体系，让 AI 跨会话记住你的工作上下文，自动生成日/周/月报。

## 使用

在当前工作空间对话中说一句：

```
帮我搭建工作记忆体系
```

Agent 自动完成初始化，无需手动粘贴路径。

## 核心功能

| 模块 | 说明 |
|------|------|
| 三层记忆 | 用户级长期记忆 + 项目长记忆 + 每日流水日志，AI 跨会话不遗忘 |
| 自动日志 | 每次完成工作自动追加流水记录，格式：`HH:MM 做了什么 → 产出物` |
| 自动汇报 | 可选创建日报/周报/月报定时任务；会话级补偿自动补齐错过的汇报 |

## 工作原理

运行 `scripts/setup_memory.py` 在工作空间创建标准目录与记忆文件，纯本地操作，不联网、不读凭证。初始化后 Agent 在每次任务收尾自动追加流水日志。

## 初始化后目录结构

```
<工作空间>/
├── inbox/ processing/ outputs/汇报/ archive/ backup/ automation/
└── .workbuddy/memory/
    ├── MEMORY.md          <- 项目长记忆
    ├── reports-state.md   <- 汇报状态（防重复）
    └── YYYY-MM-DD.md      <- 每日流水日志
```

## 注意事项

- 脚本幂等，重复运行不会覆盖已有内容
- 日/周/月报默认不自动创建，需主动说「创建我的日报自动化」
- 汇报文件位于 `outputs/汇报/`

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。