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/