名称: ctx-添加任务 描述: “添加任务。当识别到后续工作或将复杂工作分解为子任务时使用。” 允许工具: Bash(ctx:*)
向 TASKS.md 添加一个任务。
记录前
三个问题——如果任何答案为“否”,则不要记录:
- “这是可操作的吗?” → 如果是模糊的愿望,请先澄清
- “其他人知道该做什么吗?” → 如果不知道,请添加更多细节
- “这在其他地方有跟踪吗?” → 如果是,请不要重复
任务应描述要做什么以及为什么,而不仅仅是一个主题。
何时使用
- 在会话期间识别出后续工作时
- 将复杂任务分解为子任务时
- 当用户提到应该被跟踪的事情时
何时不使用
- 没有明确范围的模糊想法(先讨论,然后添加)
- 已完成的工作(改为标记现有任务为完成)
- 可以立即完成的一行修复(直接做)
收集信息
如果用户只提供了一个主题,请询问:
- “具体需要发生什么?” → 界定工作范围
- “为什么这很重要?” → 捕捉动机
- “这是高、中还是低优先级?” → 设置优先级
执行
ctx add task "任务描述" [--priority high|medium|low] [--section "阶段 N"]
放置位置:如果没有 --section,任务将插入到 TASKS.md 中第一个未勾选的任务之前。仅在需要特定部分(例如 --section "维护")时使用 --section。
示例——具体且可操作:
ctx add task "向 ctx agent 添加 --cooldown 标志,以在时间窗口内抑制重复输出。使用每个会话的 tombstone 文件进行隔离。" --priority medium
示例——包含原因上下文:
ctx add task "调查 ctx init 覆盖 .context/ 文件中用户生成内容的问题。提交 a9df9dd 清除了 DECISIONS.md 中的 18 项决策。需要防护措施以防止重新初始化破坏用户数据。" --priority high
示例——范围明确的子任务:
ctx add task "当博客文章数量达到 15+ 时,添加基于主题的导航" --priority low
错误示例(过于浅显):
ctx add task "修复错误" # 什么错误?在哪里?
ctx add task "提高性能" # 什么性能?如何提高?
ctx add task "身份验证" # 这是一个主题,不是任务
质量检查清单
记录前,请验证:
- [ ] 任务以动词开头(添加、修复、实现、调查、更新)
- [ ] 不熟悉该会话的人也可以据此行动
- [ ] 不是 TASKS.md 中现有任务的重复(先检查)
- [ ] 如果用户表示紧急,已设置优先级
确认任务已添加。