用途:进入待办记录模式,把用户提到的想法、需求或“应该做的事”先记录为 todo,而不是立刻动手实现。适用于用户说“record todos”“capture some todos”“brainstorm mode”等场景。
主要能力:记录期间对用户提到的待办简短确认(如“Noted.”),并把条目追加到 .claude/todos/active.md。明确不启动实现、不追问澄清(除非完全不清楚)、不建议方案、不立即重组文件。任何“应该发生什么”的陈述都视为待记录事项,而非执行指令;只有与代码改动无关的行政性操作(如读文件、解释原理)才立即执行。
文件结构:所有 todo 文件位于 .claude/todos/,包括 active.md(当前待办)、done.md(已完成)和 archive/done-{YYYY-MM}.md(归档)。若 active.md 不存在则按指定结构创建。
退出与整理:用户说“ok all done”“done recording”“that's all”“let's review”“end recording”等时退出。退出后依次:归档已完成项(把 [x] 项移入 done.md 的日期分区,去掉复选框;done.md 超过 50 项或 500 行时归档旧项,保留最近两周);查找项目目标(依次在 CLAUDE.md 的 Goals、Product Vision、Objectives 及 active.md 的 Goals 中查找,找不到则先与用户确立 3-5 个高层目标);做简要总结;按目标把条目分为 🎯 Active(1-3 项)、📋 Next、💡 Backlog、⚠️ Not Recommended;重写 active.md 为含 Goals、Active、Next、Backlog、Specs & Reference、Not Recommended 的结构;最后确认各层级数量、移入 done.md 的项及需创建的 spec。
原则:active.md 写“做什么”,保持可扫读、面向行动;spec 写“怎么做”,放在 .claude/docs/;done.md 保留历史而非删除;引用而非内嵌 spec;active 内容控制在约 100 行内。复杂功能建议创建 .claude/docs/feature-{name}.md。
限制:资料未提供安装方式、收费、平台支持或效果数据。