To-Do Accelerator

Collaborative task management between users and AI Agents. Agents pick up tasks, work on them, deliver results, and update progress — functioning as teammates with the user. The Obsidian Kanban board serves as the shared communication channel.

Setup

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

Working Scenarios

Commands

Base command (referred to as <CMD> below):

python3 <skill-dir>/scripts/todo.py --config <workspace>/todo-accelerator-config.yaml

Replace <skill-dir> with the absolute path to this skill's directory, and <workspace> with the agent's workspace directory.

add-todo

Create a new to-do with a companion note, added under "Ideas".

<CMD> add-todo --name "title" [--targets "outcome1" "outcome2"] [--requirements "req1" "req2"] [--priority N] [--allow-subagent | --no-allow-subagent] [--assigned-agent "agent-id"]

Example:

<CMD> add-todo --name "Research AutoResearch" --targets "Summary of features and setup guide" --requirements "Read the README" "Try running the demo" "Write up findings" --priority 1

Do not guess parameters. If the user hasn't specified targets or requirements, ask them:

• "What outcome do you expect from this?"
• "Are there specific sub-tasks or questions to address?"
• "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.

<CMD> work-on-todo
<CMD> work-on-todo --name "specific todo"

Example:

<CMD> work-on-todo --name "Research AutoResearch"

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 unchecked 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

Check off completed requirements and finalize the current round of work.

<CMD> commit --name "todo name" --completed "requirement 1" "requirement 2"

Example:

<CMD> commit --name "Research AutoResearch" --completed "Read the README" "Try running the demo"

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

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

list-pending

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

<CMD> list-pending

Example:

<CMD> list-pending

Note Structure

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

Case Studies

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