我创建了一个 VS Code 扩展,将 TODO 转换为 Kanban 看板并在 Jira 中生成真实的 issue

发布: (2026年1月9日 GMT+8 14:04)
4 min read
原文: Dev.to

Source: Dev.to

Cover image for Criei uma extensão para VS Code que transforma TODOs em um quadro Kanban e issues reais no Jira

代码中经常会出现大量 TODO
而团队也知道,这些大多数永远不会真正变成工作任务。
它们埋在注释里,被遗忘,逐渐演变成看不见的技术债务。

问题

在大多数项目中,技术债务散落在代码注释里,例如:

// TODO: refatorar isso
// FIXME: tratar edge case
// NOTE: melhorar performance

这些都是实际的待办事项,但它们不在 Jira 中,未进入冲刺,缺乏优先级,通常也没有负责人。
换句话说:待办列表并未真实反映代码的实际情况

思路

如果把 TODO 当作真正的待办事项来处理会怎样?

TODO Board 是一个 VS Code 扩展,它:

  • 扫描项目并找到 TODOFIXMENOTE 等标记
  • 在编辑器内部以看板(Kanban)形式组织所有标记,支持搜索、标签、按文本和日期过滤
  • 只需一次点击即可将任意 TODO 转换为 Jira 中的 issue,无需复制粘贴,也不会丢失上下文

扩展功能

  • 扫描项目寻找 TODOFIXMENOTE
  • 在 VS Code 中以看板形式展示所有结果
  • 显示文件、行号、年龄和优先级
  • 直接在编辑器中创建 Jira issue
  • 自动填充 issue 的代码上下文
  • 在重新扫描时保持 TODO ↔ issue 的关联
  • 支持添加标签和优先级

Demo dos filtros

配置

TODO Board 允许你完全自定义扫描器在项目中的行为。

文件扩展名

"todo-board.fileExtensions": [
  "ts", "tsx", "js", "jsx", "vue", "py", "go", "rb", "php", "rs", "swift"
]

搜索模式

"todo-board.searchPatterns": ["@TODO", "FIXME", "BUG"]

每个 TODO 的最大行数

"todo-board.maxTodoLines": 4

可视化高亮

"todo-board.highlight.enabled": true,
"todo-board.highlight.highPriorityColor": "#e74c3c",
"todo-board.highlight.mediumPriorityColor": "#ffa94d",
"todo-board.highlight.lowPriorityColor": "#4dabf7"

与 Jira 的正确集成

集成使用 OAuth 2.0(3LO)和安全的后端,具体如下:

  • 扩展本身不直接调用 Jira API。
  • 所有通信都通过后端进行。
  • 令牌以安全方式存储。
  • 应用仅请求最小必要权限。
  • 用户只能在自己有权限的项目中创建 issue。

Demo integração com Jira

为什么有用

  • 技术债务变得可视化。
  • 待办列表真实反映代码现状。
  • 规划更具可预见性。
  • 减少被遗忘的 TODO。
  • 降低返工率。

你的代码终于可以和待办列表“对话”了。

开源

该项目已开源,地址如下:

  • GitHub:
  • 官方 Marketplace 上的扩展:

欢迎提交反馈、issue 和 PR 🙂

Back to Blog

相关文章

阅读更多 »