Obsidian 任务罗盘
使用 Kanban 看板、Dataview 仪表盘和结构化任务笔记管理 Obsidian 中的任务。
初始化任务看板
先确认目标知识库路径,再运行初始化脚本:
python scripts/setup.py <知识库路径> [--folder <目录名>] [--columns <列1,列2,...>]
<知识库路径>:Obsidian 知识库根目录。--folder:任务子目录,默认Tasks。--columns:看板列,默认待归档,待处理,进行中,待审核,已完成。
脚本只创建缺失文件,不覆盖已有看板或仪表盘:
<任务目录>/Board.md:Kanban 看板。<任务目录>/Dashboard.md:Dataview 仪表盘。
确认用户已安装 Obsidian 社区插件 Kanban 和 Dataview;未安装时给出安装提醒。
创建任务笔记
为每项任务创建独立的 Markdown 文件,并使用以下格式:
---
status: todo
priority: P1
category: 项目
created: 2026-02-03
due: 2026-02-07
---
# 任务标题
在这里填写任务说明和处理记录。
## 相关资料
- [[相关文档|显示名称]]
## 执行清单
- [x] 已完成步骤
- [ ] 待处理步骤
属性字段
| 字段 | 可用值 | 是否必填 |
|---|---|---|
status |
backlog、todo、in-progress、review、done |
是 |
priority |
P1、P2、P3 |
是 |
category |
自由文本,如项目、内容、研究、配置 | 是 |
created |
YYYY-MM-DD |
是 |
due |
YYYY-MM-DD |
否 |
parked_until |
YYYY-MM-DD |
否 |
内部状态值保持英文,以兼容 Dataview 查询;中文看板列与状态值对应如下:
| 看板列 | status 值 |
|---|---|
| 待归档 | backlog |
| 待处理 | todo |
| 进行中 | in-progress |
| 待审核 | review |
| 已完成 | done |
管理任务
新建任务
- 在任务目录中创建带完整属性的任务笔记。
- 在
Board.md的对应列添加卡片:
- [ ] [[任务名称]] 🔴 P1 @{2026-02-07}
移动任务
- 修改任务笔记中的
status。 - 将
Board.md中的卡片移动到对应中文列。
完成任务
- 将任务笔记的状态改为
status: done。 - 将卡片移至“已完成”列,并勾选卡片:
- [x] [[任务名称]] ✅ 2026-02-03
每次变更状态时必须同时更新 Board.md 和任务笔记属性,避免两处信息不一致。
标记优先级
- 🔴 P1:紧急或重要。
- 🟡 P2:常规处理。
- 🟢 P3:低优先级或暂缓。
关联资料
使用 Obsidian 双向链接连接任务与相关文档:
## 相关资料
- [[2026-02-03-调研报告|调研报告]]
- [[一月会议纪要|会议纪要]]
将资料放在任务目录的同级目录中,例如 Research/,保持任务与知识内容分开。
检查结果
完成操作后检查:
- 看板卡片所在列与任务笔记的
status一致。 - 日期使用
YYYY-MM-DD格式。 - 所有任务链接都能指向实际笔记。
Dashboard.md能正常显示优先级、逾期任务和最近完成任务。