代码任务

将 TODO、FIXME、BUG 等代码注释变成可筛选的 Kanban 看板，添加手动任务，并将工作交给 AI Agent。

Code Tasks 把源代码中分散的未完成工作集中到一处。它会扫描 TODO、FIXME、BUG 等标签注释，将其变成卡片，并与不属于代码注释的手动任务一起显示。

Code Tasks 看板按标签显示扫描任务和手动任务

打开 Code Tasks

  1. 打开要检查的项目。
  2. 点击顶部工具栏的 Tasks，或在应用菜单中选择 Navigate → Tasks…。
  3. 如有需要，在对话框顶部的 Project 选择器中切换项目。

1DevTool 只在你打开 Code Tasks 时扫描，不会在后台监视文件。需要重新扫描时点击 Refresh。

编写任务注释

ts
// TODO: 处理空状态
// REVIEW(alex): 检查身份验证流程
// BUG(#123)!: 慢网络下请求可能竞争
// FIXME!!: 发布前防止数据丢失

内置标签包括 TODO、FIXME、BUG、HACK、XXX、NOTE、OPTIMIZE、PERF、REVIEW、DEPRECATED、WARNING 和 REFACTOR。

  • REVIEW(alex) 会记录负责人，BUG(#123) 会关联 issue。
  • ! 表示 High 优先级，!! 表示 Critical 优先级。
  • 卡片同时保留文件、行号和附近代码上下文。

项目的 ignore 规则以及常见的依赖、构建目录会被跳过，不会让生成文件淹没看板。

整理看板

可在可拖放的 Board view 和紧凑的 List view 之间切换。任务可按标签、文件、作者、优先级或来源分组，再按优先级或文件排序。

搜索框会匹配描述、文件路径和负责人。筛选器可按优先级或 Scanned from code / Manual task 来源缩小范围。

添加手动任务

对不适合写在注释里的工作，点击 Add，填写描述、标签、优先级，以及可选的文件、行号和负责人。手动任务保存在 .1devtool/manual-tasks.json 中。

手动卡片可编辑、删除和拖放。来自扫描的卡片不能拖放，因为源注释才是真实记录；请修改注释后点击 Refresh。

处理任务

选中卡片后，可使用 Open in Editor 跳到准确行，用 Send to Agent 生成带完整上下文的修复提示词，或用 Copy as Markdown 粘贴到 GitHub、Linear、Notion。

齿轮按钮可启用/禁用标签、新增自定义标签、修改颜色和 ignore 列表。设置保存在 .1devtool/tasks.json 中。

相关内容