obsidian-tasks

在 Obsidian 知识库中使用看板、Dataview 仪表盘和结构化任务笔记进行任务管理。

设置

运行设置脚本以在 Obsidian 知识库中初始化任务看板：

python3 scripts/setup.py <vault-path> [--folder <name>] [--columns <col1,col2,...>]

• vault-path：Obsidian 知识库根目录的路径
• --folder：要创建的子文件夹（默认值：Tasks）
• --columns：看板列（默认值：Backlog,Todo,In Progress,Review,Done）

这将创建：

• <folder>/Board.md- 看板（需要 Kanban 社区插件）
• <folder>/Dashboard.md- Dataview 仪表盘（需要 Dataview 社区插件）

请告知用户安装Kanban和数据视图若尚未安装则需安装社区插件。

任务笔记格式

每个任务都是一个独立的 Markdown 文件，并包含 YAML 前置元数据：

---
status: todo
priority: P1
category: revenue
created: 2026-02-03
due: 2026-02-07
---

# Task Title

Description and notes here.

## References
- [[linked-document|Display Name]]

## Status
- [x] Step completed
- [ ] Step pending

前置元数据字段

看板上的优先级标签

在看板上使用表情符号前缀进行视觉优先级区分：

• 🔴 P1 （紧急）
• 🟡 P2 （普通）
• 🟢 P3 （待办/搁置）

任务管理

创建任务

1. 在 tasks 文件夹中创建一个带有 frontmatter 的 markdown 文件
2. 在 Board.md 的适当列中添加一张卡片：

- [ ] [[Task Name]] 🔴 P1 @{2026-02-07}

移动任务

1. 更新状态在任务笔记的 frontmatter 中
2. 将 Board.md 中的卡片行移动到目标列

完成任务

1. 设置状态：完成在 frontmatter 中
2. 移动到"完成"列并标记复选框：

- [x] [[Task Name]] ✅ 2026-02-03

请务必同时更新 Board.md 和任务笔记的 frontmatter，以保持它们同步。

链接文档

使用 Obsidian[[wikilinks]]将任务与支持文档连接起来：

## References
- [[2026-02-03-research-report|Research Report]]
- [[meeting-notes-jan|Meeting Notes]]

将引用的文档存储在相邻的文件夹中（例如，研究/紧邻任务/）。

仪表板查询

设置脚本会创建一个 Dataview 仪表板。核心查询包括：

按优先级分类的任务：

TABLE status, category, due
FROM "<tasks-folder>"
WHERE priority = "P1" AND status != "done"
SORT due ASC

逾期任务：

TABLE priority, category
FROM "<tasks-folder>"
WHERE due AND due < date(today) AND status != "done"
SORT due ASC

最近完成的任务：

TABLE category
FROM "<tasks-folder>"
WHERE status = "done"
SORT file.mtime DESC
LIMIT 10