todo

Manage ./TODO.md (project root by default). Supports read and write via a single command — the caller passes a natural-language description as $ARGUMENTS; branch on intent.

• No arguments → read-only rendering (see "Read mode" below).
• With arguments → infer intent (add / complete / delete / update) from the natural-language description and edit ./TODO.md accordingly (see "Write mode" below).

---

TODO.md format (authoritative)

Every item has live metadata (always-fresh one-liner + at most one next reminder) plus an append-at-top history log of dated progress entries in reverse chronological order.

Active item:

- [ ] Item title
  - 备注：one-line summary of current state + next action
  - 提醒：MM/DD/YYYY or 每天

  - MM/DD：latest update

  - MM/DD：earlier update

Completed item:

- [x] Item title
  - 备注：final-state one-liner
  - 完成：MM/DD/YYYY

  - MM/DD：history entry

Core rules:

• Dates use MM/DD/YYYY.
• Titles stay short; detail goes in - 备注： (live one-liner) and history entries.
• - 备注： is live, not append-only. Rewrite it on every update so it reflects "current state + next action" in a single sentence. Old context is preserved by the history log below, not by stacking context inside 备注.
• At most one - 提醒： per item, pointing to the next actionable date. When a reminder becomes moot (passed, superseded by newer info, no longer relevant), replace it with the next one — or delete it if nothing's pending. Never accumulate multiple 提醒 lines.
• History entries (- MM/DD：...) go in reverse chronological order — newest directly under the metadata lines, older ones below, separated by blank lines. Never overwrite or reorder existing entries.
• Preserve quoted content (emails, Slack messages, replies) with > blockquotes inside the relevant history entry.
• No emphasis noise: avoid **bold**, ~~strikethrough~~, italics. Plain prose only.
• Do not use a separate - 状态：... field — status folds into - 备注：.
• Group items under ## <category> headers (e.g. 财务/报销, 工作/沟通, 生活/杂务, 每月固定, 每年固定). Pick the best fit; if none obvious, create a new one or put under ## 杂项.
• If TODO.md does not exist, create it with a minimal header and the relevant category.

---