mcpField
A
afu-llm-todo

afu-llm-todo

github.com/learnpromptProductivity8863 installsUpdated 7w ago
Repository

About afu-llm-todo

Afu · LLM Todo is a skill for Obsidian Agent that turns inbox materials into Markdown Wiki pages and Todo Cards, with optional calendar scheduling through a local UI or API. It uses Markdown as the sole source of truth and logs operations.

Key features

  1. 01Inbox-to-Wiki-to-Todo workflow
  2. 02Vault folder discovery
  3. 03Todo Card generation with confirmation
  4. 04Calendar scheduling via local UI or API
  5. 05Operation logs for changes

Use cases

  1. 01Organizing an Obsidian inbox
  2. 02Compiling source materials into Markdown Wiki
  3. 03Creating weekly Todo Cards from a Wiki
  4. 04Scheduling Todo Cards on a calendar

Install

Copy the command and run it in a terminal.

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

After installing, type/afu-llm-todoin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

LICENSE
README.zh-CN.md
README_EN.md
.gitignore
deepseek-client.mjs
README.md
.claude-plugin/
marketplace.json
docs/
api.md
config.md
credits.md
yc-main-change-record-2026-07-01.md
mobile-quick.md
docs/assets/
brand-directions.md
docs/launch/
clawhub.md
demo-script.md
social.md
examples/
Vault切换说明.md
examples/general-vault/00_收件箱/2026-06-26/
02 学习资料 Topics 和课程笔记怎么避免重复.md
01 QuickNotes Ideas Daily 应该怎么分流.md
04 YC_Info 什么该进长期资料.md
03 项目总览怎么变成求职行动.md
06 求职 JD 和项目证据怎么整理.md
05 两周规划怎么转成阿福行动卡片.md
09 YC_Info 的隐私边界和长期上下文.md
08 QuickNotes 每周清空 SOP.md
10 项目补全清单到作品集素材.md
07 课程笔记提炼成 Topic 的具体例子.md
12 工作日深度工作时段怎么保护.md
11 每日运动和恢复计划怎么落地.md
13 作业截止日前怎么拆分提交步骤.md

Details

From the project README

Afu · LLM Todo

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

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

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

npm run demo:reset
npm run demo

打开:

open http://localhost:4317

回滚

操作日志位于:

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

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

Comments

Markdown supported