用途：在会话过程中捕获、列出、更新或归档待办事项，适合记录当前任务之外、值得稍后处理的问题。
主要能力：基于 Markdown 文件管理待办，默认目录为 docs/todos/，归档项进入 docs/todos/done/。项目可在 CLAUDE.md 中覆盖默认配置，例如指定 directory 与 statuses（open、in-progress、blocked、done、wont-fix）。技能目录中的 todo.sh 会自动读取 CLAUDE.md 的 ## Todos 配置。
使用方式：所有操作统一使用 ~/.claude/skills/managing-todos/todo.sh，它会校验状态与优先级、设置正确的创建日期并遵循 CLAUDE.md 覆盖项。常用命令包括：todo.sh create -t "Fix hardcoded URL" -p high --tags "refactor,config" -d "Move API URL to env var"；todo.sh list；todo.sh list -s open -p high；todo.sh list --tag frontend；todo.sh update "hardcoded-url" -s in-progress；todo.sh archive "hardcoded-url"。无参数运行可查看完整用法。文件匹配为部分匹配，例如 "hardcoded-url" 可匹配 2026-03-25-fix-hardcoded-url.md。
文件格式：文件名为 YYYY-MM-DD-short-description.md，由脚本自动生成；frontmatter 包含 status、priority、created、tags。
限制与注意：自动检测到值得记录的待办时，必须先询问用户是否创建，不得静默创建；仅当用户明确说“todo: fix X later”之类指令时才可跳过确认。常见错误包括不用脚本创建待办、自动检测时不询问、以及用删除代替 todo.sh archive 来归档。