代码任务(已替换)
TODO 注释扫描功能已在 v1.53 中移除。以下是取代它的功能,以及你已有任务的去向。
该功能已在 v1.53.0 中移除。 Tasks 按钮不再扫描代码中的
TODO/FIXME注释——它现在会改为打开 Tasks 看板。本页说明了这一变化,以及你原有任务的去向。
Code Tasks 过去是做什么的
Code Tasks 会扫描你的源文件中的标签注释——TODO、FIXME、BUG、HACK、NOTE——并将每一条都变成看板上的一张卡片,与你自己手动输入的任务一起显示。
它只是对你注释的一个只读视图。每次打开都会从相同的注释重新生成相同的卡片,卡片上除了它来源的那条注释之外,没有任何东西能被保留下来。
为什么是移除,而不是升级
扫描出来的任务每次打开都会被重新生成,从不具备持久性。你无法分配它,智能体也无法处理它,你给卡片加的备注会在下一次扫描时消失。新的 Tasks 看板建立在相反的前提之上:任务是仓库中一个真实的 markdown 文件,可以被 diff、被审查,并随分支一起流转。
这两件事无法在同一个看板上同时成立,所以扫描功能被舍弃了。
取代它的是什么
从问题出现的地方捕获——在终端中选中一段堆栈跟踪,或在编辑器中选中几行代码,右键点击,选择 Add task。任务会保留一个指向其来源文件和行号的引用。这直接取代了 "我在阅读代码时发现了问题,想把它记下来" 这种需求。
拆解一个目标——描述一个期望的结果,智能体会为你提出一套任务集,供你编辑和确认。在你确认之前,不会写入任何内容。
分配即派发——选择目标会启动终端、发送任务,并将这次运行绑定到卡片上。这是一条扫描出来的注释永远做不到的事。
你的任务去了哪里
你的手动任务被迁移了,而不是丢失了。 项目首次打开时,.1devtool/manual-tasks.json 中的每一条记录都会变成一个 markdown 任务:
- 描述 → 标题
- 优先级会相应地映射过去
- 标签会被保留为 label
- 文件 / 行号会被保留为引用
旧文件会被重命名为 *.v1.bak,并且永远不会被删除,因此迁移不会破坏任何东西。
仅通过扫描产生的任务不会被迁移。 它们本就是每次打开时重新生成的,从不具备持久性——没有任何状态可以延续下去。
如果你仍然想要一份 TODO 清单
你的注释仍然留在代码里,grep / rg 依然能找到它们。如果标签注释是你喜欢的工作方式,那就继续写——遇到值得变成有负责人、有历史记录的真实工作项时,就右键点击 Add task。