# Afu LLM Todo

> 管家阿福(Afu)——把 Obsidian 收件箱变成活的 Wiki,再变成本周待办卡和周历:Inbox -> Wiki -> Todo Card -> Calendar 一条线。本地优先,Markdown 是唯一真源,收件箱原文不改写,导入/排期/作废/编译全部写操作日志可回滚。 触发词包括但不限于:整理我的 Obsidian 收件箱、每天提醒我处理 Obsidian 收件箱、inbox 清零、把这批资料编译成 Wiki、从笔记生成本周待办、待办卡排进周历、阿福帮我理一下 vault。 即使用户只是说"我的 Obsidian 堆了一堆没处理的东西",也应该触发。 不要用于:不涉及 Obsidian/Markdown vault 的普通待办管理(用一般 todo 工具);改写、润色、总结笔记原文(阿福只整理位置,不动原文);Notion 等非 Markdown 知识库。

- Skill: `learnprompt/afu-llm-todo` (Agent Skill, multi-file: 19 files)
- Install (CLI): `npx skillmds@latest add learnprompt/afu-llm-todo`
- Raw SKILL.md: https://api.skillmd.com/api/skills/learnprompt/afu-llm-todo/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: learnprompt (https://skillmd.com/u/learnprompt)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/learnprompt/afu-llm-todo

---

# Afu · LLM Todo

管家阿福是给 Obsidian Agent 用的 Skill。

它处理的不是普通任务清单，而是这条链路：

```text
Inbox -> Wiki -> Todo Card -> Calendar
```

## 什么时候用

- 用户想整理 Obsidian 收件箱。
- 用户想把一批资料先编译成 Markdown Wiki。
- 用户想从 Wiki 里生成本周待办卡。
- 用户想用本地网页 UI 把待办卡排进周历。

## 工作原则

- 不要求用户使用固定 Vault 目录。
- 先确认收件箱、Wiki、待办卡三个位置。
- Markdown 是唯一真源，不引入外部数据库。
- 第一版不强制外部 LLM API Key。
- 收件箱原文不改写。
- 导入、排期、作废、Wiki 编译都写操作日志。

## Agent 工作流

1. 读取或询问用户的 Vault 根目录。
2. 确认三个目录：收件箱、Wiki、待办卡。
3. 扫描收件箱素材，形成当前批次。
4. 生成 Wiki ingest packet。
5. 从 Wiki 或 packet 中生成 Todo Card。
6. 用户确认后写入待办卡目录。
7. 如需排期，启动本地 UI 或调用排期 API。

## 每日收件箱提醒

当用户要求每天提醒处理 Obsidian 收件箱时，不要只发一句空提醒。按 Afu 的轻量巡检做：

1. 先按当前日期严格盘点今日新增内容；优先检查 `00_收件箱/YYYY-MM-DD/` 这类日期目录，不要只依赖文件修改时间。
2. 不要把历史残留或候选池说成今天的新收件箱；日期目录、修改时间、自动投递报告要分开说明。
3. 再单独列 backlog：收件箱残留、最近批次、待判断、重复或敏感命名线索。
4. 只有今日新增或用户要求处理 backlog 时，才从材料中挑 3-5 个最值得处理的候选，并说明为什么今天值得看。
5. 给每个候选建议下一步：保留在 inbox、编译进 Wiki、生成 Todo Card、或等待用户判断。
6. 没有用户确认时，不删除、不移动、不改写收件箱原文。
7. 输出要能直接变成当天的处理清单；如果没有今日新增，也明确写“今日无新增收件箱处理项”，并把 backlog 标为“历史待处理”。

## 本地 UI

```bash
npm run demo:reset
npm run demo
```

打开：

```bash
open http://localhost:4317
```

## 回滚

操作日志位于：

```text
99_系统/topic-planner-log/YYYY-MM-DD.md
```

误生成的 Markdown 可以根据日志路径删除，或用 Git、iCloud、Time Machine 回滚。