Todo Accelerator

To-Do Accelerator

Collaborative task management between users and AI 代理s. 代理s pick up tasks, work on them, deliver 结果s, and 更新 进度 — functioning as teammates with the user. The Obsidian Kanban board serves as the 分享d communication channel.

设置up

检查: If todo-accelerator-config.yaml exists in the 代理's workspace → ready to use. If not → follow initialization.md in this directory (one-time process).

Working Scenarios Scenario 代理 Action User describes a new task or bookmarks a topic Ask for missing detAIls (tar获取s, requirements, priority) → 添加-todo 代理 heartbeat event Call work-on-todo → process the returned prompt → commit when done or blocked User asks to handle a specific task Call 列出-pending → confirm with user → work-on-todo --name "..." → commit Commands

Base command (referred to as below):

python3 <技能-dir>/scripts/todo.py --config /todo-accelerator-config.yaml

Replace <技能-dir> with the absolute path to this 技能's directory, and with the 代理's workspace directory.

添加-todo

创建 a new to-do with a companion note, 添加ed under "Ideas".

添加-todo --name "title" [--tar获取s "outcome1" "outcome2"] [--requirements "req1" "req2"] [--priority N] [--allow-sub代理 | --no-allow-sub代理] [--as签名ed-代理 "代理-id"]

Example:

添加-todo --name "Re搜索 AutoRe搜索" --tar获取s "Summary of features and 设置up 图形界面de" --requirements "Read the README" "Try 运行ning the demo" "Write up findings" --priority 1

Do not guess parameters. If the user hasn't specified tar获取s or requirements, ask them:

"What outcome do you expect from this?" "Are there specific sub-tasks or questions to 添加ress?" "Should this be prioritized? (0 = normal, higher = more urgent)" work-on-todo

Pick up the highest-priority to-do from Ideas and prepare it for processing.

work-on-todo work-on-todo --name "specific todo"

Example:

work-on-todo --name "Re搜索 AutoRe搜索"

Behavior:

Without --name: auto-selects by priority (highest first, random among ties) With --name: works on that specific to-do (confirm exact name with user first) If the selected to-do has no un检查ed requirements → moves it to 审阅中 and skips (no action needed) Otherwise → moves card from Ideas to 推进中, increments iteration count, and returns a structured prompt

After work-on-todo returns, follow the instructions in references/processing-work-on-todo.md.

commit

检查 off completed requirements and finalize the current round of work.

commit --name "todo name" --completed "requirement 1" "requirement 2"

Example:

commit --name "Re搜索 AutoRe搜索" --completed "Read the README" "Try 运行ning the demo"

Each --completed string must exactly match an un检查ed requirement in the note's "What's More" section. If any string doesn't match, the script returns an error with the remAIning un检查ed requirements — re-examine and pass the exact strings.

The script moves the card to 审阅中 after committing.

列出-pending

列出 all to-dos under "Ideas" with their priority levels.

列出-pending

Example:

列出-pending

Note Structure

Each to-do has a companion .md note. For YAML frontmatter properties, see references/note-yaml-properties.md.

Section Purpose How to 更新 What's More Requirements 检查列出 (- [ ] / - [x]) Managed via commit command Tar获取 Final 结果s and deliverables Write directly in the note Investigation and Problems Ongoing findings, 进度 notes, obstacles Write directly in the note Case Studies

See references/case-study.md for detAIled usage examples covering the full lifecycle.