Skip to content

Todo 管理系统

Todo 系统当前更准确的官方口径,是一个 基于 docs/todos/ 的持久化工作项系统

官网旧版把它写成了一组统一 slash 命令入口,但从当前 skills 真源看,更重要的事实其实是:

  • canonical 路径是 docs/todos/
  • 它面向跨会话、可持久化的工作项
  • todo-create / todo-triage / todo-resolve 是一组 standalone skills

当前 canonical 路径

text
docs/todos/

同时,skills 还会兼容读取旧路径:

  • .context/spec-first/todos/
  • todos/

但新 todo 应写入 canonical 路径。


三个核心 skill

todo-create

用于创建 durable work items,例如:

  • review 残留问题
  • 技术债
  • 需要跨会话跟踪的工作

todo-triage

用于审阅 pending todo,并决定:

  • 批准
  • 跳过
  • 修改后再批准

todo-resolve

用于处理已进入 ready 状态的 todo,并在必要时串联:

  • 实施
  • compound
  • 清理

它和临时任务列表的区别

Todo 系统不是用来替代当前会话里的临时步骤追踪。

更准确的区分是:

  • 会话内临时步骤:用当前宿主的任务/计划工具
  • 跨会话持久工作项:写入 docs/todos/

什么时候适合创建 Todo

适合:

  • 需要跨会话继续做
  • 需要审批或排优先级
  • 不是 5 分钟内就能当场解决的小问题

不适合:

  • 当前就能立刻处理的微小修复
  • 纯会话内的临时执行步骤

与 Review / Compound 的关系

Todo 系统最常见的接入点是:

text
Review
→ 发现残留问题
→ triage
→ resolve
→ 必要时再 Compound

所以它更像“跨会话执行与整理层”,而不是主工作流里的独立阶段。


当前官网不再沿用的旧口径

  • todo-create 等同于统一 /todo-create 命令
  • Todo 系统依赖某个隐藏任务文件
  • Todo 是主工作流中的正式阶段

当前更稳妥的口径是:

  • 它是一组 file-based durable work item skills
  • 真正稳定的真源是 docs/todos/

下一步

MIT Licensed