Files
jiu/.claude/commands/todo.md
T
wangjia e124ed7c65 feat(todo): 新增 /todo slash command,支持 add/done/list/reopen/rm
- todo/todo.json:结构化 JSON 真相源(id/标题/重要度3级/平台标签/版本)
- todo/todo.mjs:Node 零依赖单文件 CLI,写操作自动重渲染 HTML
- todo/todo.html:重新设计布局(未完成置顶/已完成置底/sticky 筛选栏)
- .claude/commands/todo.md:/todo slash command
- CLAUDE.md:追加 TODO 管理规范(唯一真相源、完成即标记、禁止使用其它 todo 工具)

旧 todo.html 备份为 todo.legacy.html;存量 6 条待办已导入 todo.json

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-08 01:31:41 +08:00

2.1 KiB
Raw Blame History

description, argument-hint, model, allowed-tools
description argument-hint model allowed-tools
项目 TODO 管理(list / add / done / reopen / rm list | add <描述> | done <id> [version] | reopen <id> | rm <id> claude-sonnet-4-6 Bash, Read

管理项目 todo/todo.json 待办清单,所有写操作会自动重渲染 todo/todo.html

重要规则:所有待办项必须通过本命令管理,禁止使用其它 todo 工具(TaskCreate/TodoWrite 等)。


根据 $ARGUMENTS 分派,缺省等同 list

list(或无参数)

运行以下命令并将终端 summary 转述给用户,同时提示 HTML 路径便于浏览:

node todo/todo.mjs list

add <描述>

$ARGUMENTS 去掉首词 add 后的内容解析为待办描述,推断:

  • --title:核心一句话标题(简洁,去掉平台/类别信息)
  • --levelhigh(阻断/紧急)/ mid(重要,默认)/ low(一般/优化)
    • 关键词「紧急」「阻断」「必须」「严重」→ high;「重要」「需要」→ mid;其余 → low
  • --tags:从描述推断平台/类别,可多个逗号分隔,常用值:前端,后端,Web,mac,Windows,Android,iOS,数据库,CI/CD,文档
  • --desc:补充说明(可选,如有具体文件/路径/上下文则填入)

然后运行:

node todo/todo.mjs add --title "..." --level mid --tags "前端,Web" --desc "..."

转述:「已添加 #id [级别] 标题 标签」,并显示 summary。

done [version]

$ARGUMENTS 提取 id(数字)和可选 version(格式 vX.Y.Z):

  • 有 versionnode todo/todo.mjs done <id> --version <version>
  • 无 versionnode todo/todo.mjs done <id>(脚本自动用 git describe --tags --abbrev=0

转述:「#id 标记完成,记入版本 vX.Y.Z」,并显示 summary。

reopen

node todo/todo.mjs reopen <id>

转述「#id 已重新开启」。

rm

node todo/todo.mjs rm <id>

转述「#id 已删除」。


所有命令完成后,在终端显示来自脚本的完整 summary(共/未完成/已完成及分级列表)。