Skip to content
Back to search

afu-llm-todo

Afu · LLM Todo: turn an Obsidian inbox into a living wiki, then into todo cards for this week.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/learnprompt--afu-llm-todo/badge.svg)](/listings/learnprompt--afu-llm-todo)

HTML

<a href="/listings/learnprompt--afu-llm-todo"><img src="/api/listings/learnprompt--afu-llm-todo/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "afu-llm-todo",
  3. "owner": { "name": "LearnPrompt", "url": "https://github.com/LearnPrompt" },
  4. "metadata": { "description": "Marketplace hosting the Afu LLM-Todo plugin." },
  5. "plugins": [
  6. {
  7. "name": "afu-llm-todo",
  8. "description": "管家阿福 · Afu — LLM Todo for Obsidian agents。站在 Vault 门口的管家:先把收件箱材料整理成 Wiki,再把 Wiki 里长出来的判断变成可排进日历的待办卡。Inbox -> Wiki -> Todo Card -> Calendar。",
  9. "version": "1.0.0",
  10. "author": { "name": "LearnPrompt", "url": "https://github.com/LearnPrompt" },
  11. "source": "./",
  12. "category": "productivity",
  13. "homepage": "https://github.com/LearnPrompt/afu-llm-todo"
  14. }
  15. ]
  16. }
README.md · README · 189 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 管家阿福 · Afu
  2. **中文** | [English](README_EN.md)
  3. > LLM Todo for Obsidian agents
  4. >
  5. > Inbox -> Wiki -> Todo Card -> Calendar
  6. [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-afu--llm--todo-blueviolet)](SKILL.md)
  7. [![skills.sh](https://skills.sh/b/LearnPrompt/afu-llm-todo)](https://skills.sh/LearnPrompt/afu-llm-todo)
  8. [![Release](https://img.shields.io/github/v/release/LearnPrompt/afu-llm-todo)](https://github.com/LearnPrompt/afu-llm-todo/releases)
  9. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  10. > **Fork 改动记录:** [个人 fork 相对上游 v1.3.4 的完整差异](docs/yc-main-change-record-2026-07-01.md)
  11. ![Afu hero](docs/assets/afu-hero.png)
  12. ## 演示视频
  13. [![Afu 演示视频](docs/assets/afu-demo-poster.png)](https://github.com/LearnPrompt/afu-llm-todo/releases/download/demo-video-v1/afu-demo.mp4)
  14. <sub>▲ 点击海报播放演示视频(GitHub README 不渲染外链 video 标签,所以用海报直链)</sub>
  15. 事情是这样的。
  16. 我自己的 Obsidian 里,收件箱经常不是没有东西,是东西太多了。网页、帖子、论文、灵感、项目记录,全都在里面。真要开始做事的时候,反而会卡住。
  17. 普通 Todo 只能催你一声,告诉你还有一件事没做。
  18. 但很多时候,真正难的不是执行,是先从一堆材料里判断,哪几件事值得进入这周。
  19. 所以才有了管家阿福。
  20. 它不是来替代 Obsidian 的,也不是又一个任务管理器。它更像站在 Vault 门口的管家,先把收件箱里的材料整理成 Wiki,再把 Wiki 里已经长出来的判断,变成可以排进日历的待办卡。
  21. ```text
  22. Inbox -> Wiki -> Todo Card -> Calendar
  23. ```
  24. ## 安装给 Agent 用
  25. 如果你的 Agent 支持 Skill 安装,优先用这个方式:
  26. ```bash
  27. npx skills add LearnPrompt/afu-llm-todo
  28. ```
  29. 安装后,把需求直接交给 Agent:
  30. ```text
  31. 用管家阿福整理我的 Obsidian 收件箱,先编译 Wiki,再给我生成这周的待办卡。
  32. ```
  33. ## 触发方式
  34. 装完之后,这些话都能唤醒阿福:
  35. - "整理我的 Obsidian 收件箱"
  36. - "每天提醒我处理 Obsidian 收件箱"
  37. - "把 inbox 这批资料编译成 Wiki"
  38. - "从 Wiki 给我生成这周的待办卡"
  39. - "把待办卡排进周历"
  40. - 甚至只是:"我的 Obsidian 堆了一堆没处理的东西"
  41. 它不会接的活(免得抢错戏):非 Obsidian 的普通待办清单、改写润色你的笔记原文、Notion 类非 Markdown 知识库。
  42. ## 每日提醒怎么用
  43. 阿福也适合做一个很轻的每日收件箱提醒。
  44. ```text
  45. 每天 23:30 提醒我处理 Obsidian 收件箱。先检查 `00_收件箱/YYYY-MM-DD/` 这个当天日期目录,再看今天修改的自动投递和候选选题;不要只靠文件修改时间,也不要把历史残留说成今日新增。如果今天没有新增,就明确告诉我。再单独列出历史 backlog,挑 3-5 个最值得处理的候选,说明它们应该保留、编译进 Wiki、生成待办卡,还是先等我判断。没有我确认时,不要删除、移动或改写原文。
  46. ```
  47. 它不只是喊你“该整理了”,而是每天把 inbox 里最该动的几件事捞出来,让你从判断开始,不是从翻箱倒柜开始。
  48. ## 想先看 UI
  49. Demo 跑在 sample vault 里,你自己的笔记先原地不动。
  50. ```bash
  51. git clone https://github.com/LearnPrompt/afu-llm-todo.git
  52. cd afu-llm-todo
  53. npm install
  54. npm run demo:reset
  55. npm run demo
  56. ```
  57. 打开:
  58. ```bash
  59. open http://localhost:4317
  60. ```
  61. 你会看到三条 sample 素材。把它们送进 Wiki,生成待办卡,再拖进周排期。
  62. 手机上快速判断和排期,打开:
  63. ```bash
  64. open http://localhost:4317/quick
  65. ```
  66. `/quick` 提供今天、明天、日期选择、稍后和拒绝动作;排期结果继续写回同一份 Markdown 数据。手机需与运行 Afu 的 Mac 位于同一网络或 Tailnet。
  67. ## 不需要跟我一模一样的 Vault,你可以随便改
  68. 默认 sample vault 用的是这几个目录:
  69. ```text
  70. 00_收件箱
  71. 30_研究/内容Wiki
  72. 15_自媒体/选题库
  73. ```
  74. 但这只是示例。
  75. 你自己的 Vault 可以叫别的名字。阿福真正需要知道的只有三个位置:
  76. - 粗素材在哪里
  77. - Wiki 写到哪里
  78. - 待办卡写到哪里
  79. 剩下的路径,都可以在配置里改。Markdown 还在你的本地,阿福只是帮 Agent 找到入口和写回位置。
  80. ## 工作原理
  81. 阿福不是直接把收件箱里的每条东西都变成任务。
  82. 它先做一次中间整理。
  83. ```text
  84. Inbox
  85. -> Wiki packet
  86. -> Markdown Wiki
  87. -> Todo Card
  88. -> Calendar
  89. ```
  90. 这一步很关键。
  91. 因为收件箱里的东西通常是乱的。一个链接里可能只有半个观点,一段摘录里可能只有一个线索,一个项目记录里可能藏着真正要做的下一步。
  92. 阿福会先把这些材料放进 Wiki 语境里,让 Agent 有地方沉淀判断。等 Wiki 里已经能看出方向了,再生成待办卡。
  93. 所以它不是在帮你多列几个任务。
  94. 它是在帮你把资料变成能动起来的东西。
  95. ## 安全边界
  96. 阿福是管家,不是主人:
  97. - **收件箱原文永不改写**——它只移动、归档、编译,不动你写的字;
  98. - **只写三类位置**:Wiki 目录、待办卡目录、操作日志;不碰 vault 里其他任何文件;
  99. - **每一步落日志**:导入、排期、作废、Wiki 编译都有记录,出错可以照日志回滚;
  100. - **写入前确认**:待办卡入库需要你点头,不会先斩后奏;
  101. - **本地优先**:Markdown 是唯一真源,不引入外部数据库,第一版不强制外部 LLM API Key。
  102. ## 背后故事
  103. 这个项目一开始不是为了发布。
  104. 它只是我自己在 Obsidian 前面补的一层小工具。因为我真的经常遇到一个问题,收件箱里明明有很多好东西,但每次要排这一周的时候,还是得从头翻一遍。
  105. 翻着翻着就累了。
  106. 后来 Karpathy 提到 LLM Wiki,我一下子觉得这个方向很对。资料不应该永远躺在收件箱里,也不应该每次都靠临时搜索重新理解一遍。更好的方式,是让 Agent 把它们整理成一个会生长的 Wiki。
  107. 参考:<https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f>
  108. 再往前走一步,Wiki 不应该只是被查询。
  109. 它应该长出行动。
  110. 这就是 Afu。
  111. ---
  112. <div align="center">
  113. **更多好用 Skill · More Skills** → [learnprompt.pro/skills](https://learnprompt.pro/skills/)
  114. [鲁班·Skill打磨](https://github.com/LearnPrompt/luban-skill) · [庖丁·博主蒸馏](https://github.com/LearnPrompt/paoding-skill) · [蔡伦·对话造纸](https://github.com/LearnPrompt/cailun-skill) · [阿福·LLM Todo](https://github.com/LearnPrompt/afu-llm-todo) · [愚公·Loop工程](https://github.com/LearnPrompt/loop-engineering) · [搭子·结对开发](https://github.com/LearnPrompt/partner-skill) · [AI雷达·零API资讯](https://github.com/LearnPrompt/ai-news-radar)
  115. [淘金小镇·ClawHub日榜](https://github.com/LearnPrompt/skillrush-town) · [Irasutoya·正文配图](https://github.com/LearnPrompt/carl-irasutoya-illustrations) · [Humanize PPT·演讲系统](https://github.com/LearnPrompt/humanize-ppt) · [CC Harness·六件套](https://github.com/LearnPrompt/cc-harness-skills) · [微信读书教练](https://github.com/LearnPrompt/carl-weread) · [X Article发布](https://github.com/LearnPrompt/x-article-publisher-skill)
  116. <sub>**[LearnPrompt](https://github.com/LearnPrompt) 出品** · 公众号「卡尔的AI沃茨」 · [X @aiwarts](https://x.com/aiwarts)</sub>
  117. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.