todo
Capture a mid-development TODO via "/todo <idea>". Reads a pending-context JSON file left by the UserPromptSubmit hook, asks clarifying questions if the idea is vague, then spawns a background Claude worker in tmux that scans git context and writes the final numbered TODO file. Use when user says "/todo", "park this idea", "save this for later", or "add a todo".
- License 许可
- GPL-3.0
- 所属仓库
- matkatmusic/jot
- 最近更新
- 2026-05-23
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- todo
- description
- Capture a mid-development TODO via "/todo <idea>". Reads a pending-context JSON file left by the UserPromptSubmit hook, asks clarifying questions if the idea is vague, then spawns a background Claude worker in tmux that scans git context and writes the final numbered TODO file. Use when user says "/todo", "park this idea", "save this for later", or "add a todo".
- argument-hint
- <idea>
02 资源文件 17
- 脚本scripts/assets/permissions.default.json675 B
- 脚本scripts/assets/permissions.default.json.sha25665 B
- 脚本scripts/assets/todo-instructions.md3.0 KB
- 脚本scripts/scan-open-todos.sh468 B
- 脚本scripts/todo-launcher.sh6.6 KB
- 脚本scripts/todo-orchestrator.sh287 B
- 脚本scripts/todo-session-end.sh490 B
- 脚本scripts/todo-session-start.sh1.3 KB
- 脚本scripts/todo-state-lib.sh234 B
- 脚本scripts/todo-stop.sh2.0 KB
- 脚本scripts/todo.sh2.8 KB
- 脚本tests/hook-ignores-other-prompts-test.sh1.5 KB
- 脚本tests/hook-mktemp-pending-test.sh2.1 KB
- 脚本tests/hook-not-git-repo-test.sh1.1 KB
- 脚本tests/hook-writes-pending-test.sh2.5 KB
- 脚本tests/instructions-template-renders-test.sh1.6 KB
- 脚本tests/namespace-roundtrip-test.sh1.6 KB
03 SKILL.md 正文
/todo — Idea Parking Lot
You are the foreground claude that received a /todo prompt. The UserPromptSubmit hook has written a pending-context file — you must read it, optionally clarify, then invoke the launcher.
Step 1 — Load pending context
Use the Glob tool (NOT Bash ls) to find files matching Todos/.todo-state/pending-*.json. Glob sorts by modification time (newest first), so to pick the oldest you want the last entry in the Glob result. If only one file matches, use it.
Read that one file with the Read tool. It contains:
session_id,transcript_path,cwd,repo_root,idea,timestamp,todo_plugin_root,todo_scripts_dir,pending_file
Why oldest-first: the hook uses mktemp for a per-invocation unique name so same-session reruns never collide. Oldest-first matches FIFO order of user invocations.
If no pending file exists, reply todo: no pending context — rerun /todo <idea> and stop.
Step 2 — Clarify if vague
Inspect the idea field. If it is empty, or clearly underspecified (examples of vague: "fix that thing", "do the thing", "clean up stuff", "add a feature"), use AskUserQuestion with 1–3 targeted questions. Sample questions:
- "Which feature, file, or system does this TODO affect?"
- "Is this a bug fix, new behavior, refactor, or something else?"
- "Is there a specific function, branch, or ticket this relates to?"
Stop asking as soon as the user signals enough detail. Do NOT over-ask.
If the idea was already clear (contains a verb, a noun, and enough specificity for an implementer to start), skip this step entirely.
Merge the clarification answers (if any) into a single refined idea string.
Step 3 — Launch the background worker
Invoke the launcher via Bash — this is the only Bash call this skill needs:
bash <todo_scripts_dir>/todo-launcher.sh <session_id> <refined_idea> <pending_file>
Substitute the actual todo_scripts_dir, session_id, and pending_file values from the pending JSON; pass the refined idea as the second argument (quote it). The launcher:
- writes
Todos/<timestamp>_input.txtwith the full context block, - spawns a per-invocation tmux pane with the background Claude worker,
- deletes the pending file after a successful spawn — you do NOT need to clean up.
Capture the launcher's stdout — it prints the absolute path of the input.txt it wrote.
Step 4 — Reply
Reply in exactly one line (no preamble, no headers):
[todo] captured in <input_file_path> — background worker writing final TODO file
Rules
- NEVER write the final TODO file yourself — the background worker does that.
- NEVER call
emit_blockor any hook-output JSON. - Do NOT use
Bash lsorBash rmin this skill — useGlobfor Step 1 and let the launcher handle cleanup. - If the user cancels clarification (answers with "cancel" or "nevermind"), still call the launcher with the original idea so the pending file is cleaned up, then reply
[todo] cancelled. - Do NOT source or call
$CLAUDE_PLUGIN_ROOT— always resolve scripts viatodo_scripts_dirfrom the pending JSON (other plugins may have set a different value in the shell env).
04 同仓库更多 Skills
todo-list
Show all open TODOs from the project's Todos/ folder with ID, title, date, and branch. Use when user says "/todo-list", "show my todos", "what todos are open", or "list todos".
todo-clean
Clean up stale TODOs by comparing each open TODO against git history since its creation timestamp. Asks before marking each as done. Use when user says "/todo-clean", "clean up todos", "check for resolved todos", or "prune stale todos".
plate
暂无简介
jot
Capture a mid-development idea via "/jot <idea>" without losing focus. Writes idea + git state, open TODOs, and recent conversation context to Todos/{timestamp}_input.txt; a background Claude (persistent per project in tmux) converts it into a proper TODO file — all without interrupting your current conversation.
debate
Multi-agent debate (Claude + Gemini + Codex) in tmux. Agents independently analyze, cross-critique, then synthesize. Use when user types "/debate <topic>".
debate-retry
Resume the most recent incomplete debate invoked from this conversation.