---
name: todo-plan
description: "Create and append plan blocks to TODO.md when the user asks for a plan or mentions plan/计划/TODO/待办; auto-merge or split related tasks."
---

# TODO Plan Writer

## Trigger guard

- Only run if the user message explicitly contains one of: `plan`, `计划`, `TODO`, `待办`.

## Output target

- Append plan blocks to `TODO.md` (at file end).
- Do not modify other files.

## Planning rules

- Use create-plan style reasoning: intent -> scope -> action items; include validation/risks when relevant.
- Title: concise "module + action" (2-6 words or 6-12 chars).
- Multiple tasks:
  - Merge into one Plan if same module/goal.
  - Split if different modules/goals.

## Formatting rules

- Use the template below verbatim.
- Always keep a blank line after the `## Plan: ...` header.
- Keep existing TODO.md English structure and indentation.
- Use `[ ]` for each action item line.
- If notes are not obvious, use `- TBD`.
- Line endings: LF.

## Plan template

```md
## Plan: <title>

- Goal: <one-line objective>
- Scope:
  - In: <what is included>
  - Out: <what is excluded>
- Actions:
  [ ] <action item>
  [ ] <action item>
- Notes:
  - <tests / observations / constraints>
```