wangjia
e124ed7c65
- 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>
68 lines
2.1 KiB
Markdown
68 lines
2.1 KiB
Markdown
---
|
||
description: 项目 TODO 管理（list / add / done / reopen / rm）
|
||
argument-hint: "list | add <描述> | done <id> [version] | reopen <id> | rm <id>"
|
||
model: claude-sonnet-4-6
|
||
allowed-tools: Bash, Read
|
||
---
|
||
|
||
管理项目 `todo/todo.json` 待办清单，所有写操作会自动重渲染 `todo/todo.html`。
|
||
|
||
**重要规则**：所有待办项必须通过本命令管理，禁止使用其它 todo 工具（TaskCreate/TodoWrite 等）。
|
||
|
||
---
|
||
|
||
根据 `$ARGUMENTS` 分派，缺省等同 `list`：
|
||
|
||
## list（或无参数）
|
||
|
||
运行以下命令并将终端 summary 转述给用户，同时提示 HTML 路径便于浏览：
|
||
|
||
```bash
|
||
node todo/todo.mjs list
|
||
```
|
||
|
||
## add <描述>
|
||
|
||
将 `$ARGUMENTS` 去掉首词 `add` 后的内容解析为待办描述，推断：
|
||
- `--title`：核心一句话标题（简洁，去掉平台/类别信息）
|
||
- `--level`：`high`（阻断/紧急）/ `mid`（重要，默认）/ `low`（一般/优化）
|
||
- 关键词「紧急」「阻断」「必须」「严重」→ high；「重要」「需要」→ mid；其余 → low
|
||
- `--tags`：从描述推断平台/类别，可多个逗号分隔，常用值：`前端,后端,Web,mac,Windows,Android,iOS,数据库,CI/CD,文档`
|
||
- `--desc`：补充说明（可选，如有具体文件/路径/上下文则填入）
|
||
|
||
然后运行：
|
||
```bash
|
||
node todo/todo.mjs add --title "..." --level mid --tags "前端,Web" --desc "..."
|
||
```
|
||
|
||
转述：「已添加 #id [级别] 标题 标签」，并显示 summary。
|
||
|
||
## done <id> [version]
|
||
|
||
从 `$ARGUMENTS` 提取 id（数字）和可选 version（格式 vX.Y.Z）：
|
||
|
||
- 有 version：`node todo/todo.mjs done <id> --version <version>`
|
||
- 无 version：`node todo/todo.mjs done <id>`（脚本自动用 `git describe --tags --abbrev=0`）
|
||
|
||
转述：「#id 标记完成，记入版本 vX.Y.Z」，并显示 summary。
|
||
|
||
## reopen <id>
|
||
|
||
```bash
|
||
node todo/todo.mjs reopen <id>
|
||
```
|
||
|
||
转述「#id 已重新开启」。
|
||
|
||
## rm <id>
|
||
|
||
```bash
|
||
node todo/todo.mjs rm <id>
|
||
```
|
||
|
||
转述「#id 已删除」。
|
||
|
||
---
|
||
|
||
所有命令完成后，在终端显示来自脚本的完整 summary（共/未完成/已完成及分级列表）。
|