FreePublished on GitHub

afu-llm-todo

管家阿福(Afu)——把 Obsidian 收件箱变成活的 Wiki,再变成本周待办卡和周历:Inbox -> Wiki -> Todo Card -> Calendar 一条线。本地优先,Markdown 是唯一真源,收件箱原文不改写,导入/排期/作废/编译全部写操作日志可回滚。

触发词包括但不限于:整理我的 Obsidian 收件箱、每天提醒我处理 Obsidian 收件箱、inbox 清零、把这批资料编译成 Wiki、从笔记生成本周待办、待办卡排进周历、阿福帮我理一下 vault。即使用户只是说"我的 Obsidian 堆了一堆没处理的东西",也应该触发。

不要用于:不涉及 Obsidian/Markdown vault 的普通待办管理(用一般 todo 工具);改写、润色、总结笔记原文(阿福只整理位置,不动原文);Notion 等非 Markdown 知识库。

The English summary is being prepared. Showing the original description.

LearnPrompt/afu-llm-todo

Works withNotion Obsidian

See how to install

Files included (145)

SKILL.md3.2 KB
.claude-plugin/marketplace.json736 B
.gitignore269 B
deepseek-client.mjs4.3 KB
docs/api.md3.3 KB
docs/assets/afu-demo-poster.png230.4 KB
docs/assets/afu-demo-workspace.png354.0 KB
docs/assets/afu-demo.mp424.8 MB
docs/assets/afu-hero.png1.9 MB
docs/assets/afu-logo-butler-crystal.svg1.7 KB
docs/assets/afu-logo-inbox-alchemy.svg1.7 KB
docs/assets/afu-logo-wiki-calendar.svg2.1 KB
docs/assets/brand-directions.md2.1 KB
docs/config.md3.6 KB
docs/credits.md465 B
docs/launch/clawhub.md1.2 KB
docs/launch/demo-script.md1019 B
docs/launch/social.md1.2 KB
docs/mobile-quick.md2.3 KB
docs/yc-main-change-record-2026-07-01.md5.7 KB
examples/general-vault/00_收件箱/2026-06-26/01 QuickNotes Ideas Daily 应该怎么分流.md322 B
examples/general-vault/00_收件箱/2026-06-26/02 学习资料 Topics 和课程笔记怎么避免重复.md354 B
examples/general-vault/00_收件箱/2026-06-26/03 项目总览怎么变成求职行动.md261 B
examples/general-vault/00_收件箱/2026-06-26/04 YC_Info 什么该进长期资料.md318 B
examples/general-vault/00_收件箱/2026-06-26/05 两周规划怎么转成阿福行动卡片.md309 B
examples/general-vault/00_收件箱/2026-06-26/06 求职 JD 和项目证据怎么整理.md269 B
examples/general-vault/00_收件箱/2026-06-26/07 课程笔记提炼成 Topic 的具体例子.md264 B
examples/general-vault/00_收件箱/2026-06-26/08 QuickNotes 每周清空 SOP.md273 B
examples/general-vault/00_收件箱/2026-06-26/09 YC_Info 的隐私边界和长期上下文.md281 B
examples/general-vault/00_收件箱/2026-06-26/10 项目补全清单到作品集素材.md284 B
examples/general-vault/00_收件箱/2026-06-26/11 每日运动和恢复计划怎么落地.md271 B
examples/general-vault/00_收件箱/2026-06-26/12 工作日深度工作时段怎么保护.md243 B
examples/general-vault/00_收件箱/2026-06-26/13 作业截止日前怎么拆分提交步骤.md257 B
examples/general-vault/00_收件箱/2026-06-26/14 项目规划从愿望清单变成交付里程碑.md238 B
examples/general-vault/00_收件箱/2026-06-26/15 家务和生活补给怎么做成周循环.md250 B
examples/general-vault/00_收件箱/2026-06-26/16 每周复盘如何变成下一周三件事.md243 B
examples/general-vault/00_收件箱/2026-06-26/17 健康饮食和外卖控制怎么做成可执行规则.md248 B
examples/general-vault/00_收件箱/2026-06-26/18 财务账单和订阅检查怎么避免漏项.md257 B
examples/general-vault/00_收件箱/2026-06-26/19 社交关系跟进怎么温和排进日历.md260 B
examples/general-vault/00_收件箱/2026-06-26/20 作品集发布前检查清单怎么拆任务.md273 B
examples/general-vault/30_整理Wiki/index.md614 B
examples/general-vault/30_整理Wiki/log.md96 B
examples/general-vault/40_行动卡片/【选题】15 家务和生活补给怎么做成周循环.md1.7 KB
examples/general-vault/40_行动卡片/【选题】17 健康饮食和外卖控制怎么做成可执行规则.md1.7 KB
examples/general-vault/40_行动卡片/【选题】18 财务账单和订阅检查怎么避免漏项.md1.7 KB
examples/general-vault/40_行动卡片/【选题】19 社交关系跟进怎么温和排进日历.md1.8 KB
examples/general-vault/40_行动卡片/【选题】20 作品集发布前检查清单怎么拆任务.md1.8 KB
examples/general-vault/40_行动卡片/README.md132 B
examples/general-vault/99_系统/topic-planner-log/2026-06-26.md3.3 KB
examples/general-vault/99_系统/topic-planner-log/2026-07-01.md14.6 KB
examples/general-vault/99_系统/归档/行动卡片/README.md77 B
examples/general-vault/使用计划和连接说明.md10.5 KB
examples/general-vault/读我-这个GeneralVault怎么玩.md1.3 KB
examples/sample-vault/00_收件箱/2026-05-04/AI 浏览器开始接管资料整理.md351 B
examples/sample-vault/00_收件箱/2026-05-04/Karpathy LLM Wiki 热度继续扩散.md319 B
examples/sample-vault/00_收件箱/2026-05-04/内容创作者的收件箱不是垃圾堆.md276 B
examples/sample-vault/15_自媒体/选题库/README.md53 B
examples/sample-vault/30_研究/内容Wiki/index.md150 B
examples/sample-vault/30_研究/内容Wiki/log.md60 B
examples/sample-vault/99_系统/归档/选题占位/README.md56 B
examples/study-vault/00_收件箱/2026-06-29/01 期中考试复习范围.md250 B
examples/study-vault/00_收件箱/2026-06-29/02 作业二提交前检查.md239 B
examples/study-vault/00_收件箱/2026-06-29/03 每日复习计划.md231 B
examples/study-vault/00_收件箱/2026-06-29/04 错题整理和概念回填.md234 B
examples/study-vault/00_收件箱/2026-06-29/05 公式和定义速记.md233 B
examples/study-vault/00_收件箱/2026-06-29/06 论文阅读和课堂展示.md225 B
examples/study-vault/00_收件箱/2026-06-29/07 实验报告数据检查.md212 B
examples/study-vault/00_收件箱/2026-06-29/08 考前一天轻量复盘.md230 B
examples/study-vault/30_整理Wiki/index.md201 B
examples/study-vault/30_整理Wiki/log.md70 B
examples/study-vault/40_行动卡片/README.md86 B
examples/study-vault/99_系统/归档/行动卡片/README.md62 B
examples/study-vault/读我-这个StudyVault怎么玩.md511 B
examples/Vault切换说明.md3.1 KB
examples/weekend-vault/00_收件箱/2026-06-28/01 周末朋友聚餐怎么安排.md244 B
examples/weekend-vault/00_收件箱/2026-06-28/02 周末补觉和运动怎么平衡.md219 B
examples/weekend-vault/00_收件箱/2026-06-28/03 城市展览和电影二选一.md242 B
examples/weekend-vault/00_收件箱/2026-06-28/04 周末家里简单整理.md220 B
examples/weekend-vault/00_收件箱/2026-06-28/05 周末新餐厅收藏清单.md226 B
examples/weekend-vault/00_收件箱/2026-06-28/06 周日晚上轻复盘.md237 B
examples/weekend-vault/00_收件箱/2026-06-28/07 给自己安排半天无计划时间.md221 B
examples/weekend-vault/00_收件箱/2026-06-28/08 周末购物和生活补给.md239 B
examples/weekend-vault/30_整理Wiki/index.md213 B
examples/weekend-vault/30_整理Wiki/log.md70 B
examples/weekend-vault/40_行动卡片/README.md77 B
examples/weekend-vault/99_系统/归档/行动卡片/README.md62 B
examples/weekend-vault/读我-这个WeekendVault怎么玩.md499 B
inbox-import.mjs10.8 KB
LICENSE1.0 KB
macos-calendar.mjs9.6 KB
native-directory-picker.mjs3.6 KB
operation-log.mjs1.6 KB
package-lock.json187 B
package.json370 B
public/afu-mascot.png309.9 KB
public/app.js137.0 KB
public/index.html32.6 KB
public/quick-icon-180.png51.2 KB
public/quick-icon-192.png57.7 KB
public/quick-icon-512.png332.3 KB
public/quick-icon-master.png928.6 KB
public/quick-manifest.webmanifest609 B
public/quick-sw.js1.4 KB
public/quick-utils.mjs8.1 KB
public/quick.css22.7 KB
public/quick.html10.9 KB
public/quick.js36.8 KB
public/styles.css40.4 KB
README_EN.md3.4 KB
README.md7.4 KB
README.zh-CN.md123 B
scripts/afu.sh2.5 KB
scripts/reset-demo.mjs3.0 KB
scripts/start-topic-planner-launchagent.sh406 B
scripts/start-topic-planner.sh334 B
scripts/verify-config.mjs1.9 KB
scripts/wiki-compile-packet.sh234 B
server.mjs133.8 KB
tests/deepseek-client.test.mjs3.3 KB
tests/external-events.test.mjs10.2 KB
tests/helpers/lark-stub.mjs1.2 KB
tests/helpers/spawn-server.mjs4.4 KB
tests/inbox-import.test.mjs8.1 KB
tests/inbox-server.test.mjs8.3 KB
tests/lark-calendars.test.mjs3.2 KB
tests/macos-calendar.test.mjs6.7 KB
tests/native-directory-picker.test.mjs3.2 KB
tests/quick-planner-utils.test.mjs6.1 KB
tests/server-calendar-sync.test.mjs10.3 KB
tests/server-lark-voting.test.mjs19.4 KB
tests/server-schedule.test.mjs9.0 KB
tests/threads-fetch.test.mjs7.7 KB
tests/topic-planner-config.test.mjs11.1 KB
tests/topic-utils.test.mjs1.6 KB
tests/topics-complete.test.mjs4.6 KB
tests/topics-day.test.mjs3.1 KB
tests/topics-dispose-batch.test.mjs3.2 KB
tests/topics-disposition.test.mjs1.4 KB
tests/topics-merge.test.mjs5.9 KB
tests/wiki-mode.test.mjs3.6 KB
threads-fetch.mjs12.8 KB
topic-planner-config.mjs10.8 KB
topic-planner.config.json.example1.3 KB
topic-utils.mjs614 B
wiki-mode.mjs9.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Afu · LLM Todo

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

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

Inbox -> Wiki -> Todo Card -> Calendar

什么时候用

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

工作原则

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

Agent 工作流

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

每日收件箱提醒

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

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

本地 UI

npm run demo:reset
npm run demo

打开：

open http://localhost:4317

回滚

操作日志位于：

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

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Report a problem with this skill

Install

Install with a command

npx skills add https://github.com/LearnPrompt/afu-llm-todo --skill afu-llm-todo

Paste it into your terminal and run it (requires Node.js). You can choose which agents to install it for, such as Claude Code or Codex.

Ask your agent

Please install the following Agent Skill.
https://github.com/LearnPrompt/afu-llm-todo

First review SKILL.md and the bundled files and confirm there is nothing suspicious (such as sending data externally or reading credentials). Then place it in ~/.claude/skills/afu-llm-todo/ for Claude Code, or ~/.agents/skills/afu-llm-todo/ for Codex.

Send this text to Claude Code or Codex as is. It checks the contents before installing.

View source on GitHub

Repository: LearnPrompt/afu-llm-todo
Stars: 88
Forks: 9
Category: Data & AI
License: MIT
Original language: Chinese
Last updated: Sep 10, 2026

A skill is a set of instructions and scripts for an agent. cccskills does not guarantee that skills are safe. Review the contents before you install.