Obsidian Tasks 插件：在 Obsidian vault 的 .md 文件中创建、编辑和管理基于 Emoji 元数据的任务。 当用户需要添加待办事项（带日期、优先级、重复规则）、创建任务查询代码块、 管理重复任务、设置任务状态或依赖、按条件筛选/排序/分组任务时使用此技能。 也适用于用户提到 "tasks 查询"、"任务过滤"、"📅 截止日期"、"🔁 重复任务"、 "紧迫度排序" 等场景。
在 Obsidian vault 的 .md 文件中创建和管理任务。通过 Emoji 元数据（日期、优先级、重复、标签等）将 Markdown 清单项转变为功能丰富的任务：
- [ ] 任务描述 📅 2026-04-01 🔼 #标签 🔁 every week
格式: - [ ] 描述 [元数据...]
支持的清单格式: - [ ]、* [ ]、+ [ ]、1. [ ]
| 你要做什么 | 该怎么做 |
|---|---|
| 创建/编辑任务 | 加载 references/syntax-core.md，按语法写入任务行 |
| 编写任务查询 | 加载 references/query-basics.md，在 ```tasks ``` 代码块中编写 |
| 使用自定义状态 | 加载 references/statuses.md |
| 设置任务依赖 | 加载 references/dependencies.md |
| 高级查询（脚本/正则） | 加载 references/query-advanced.md |
| 排查问题 | 加载 references/limitations.md |
在创建、编辑或删除任何任务之前：
.md 文件，了解现有内容和结构- [ ]、- [x]、- [/] 等开头的行）避免：
遵循：
任务行上元数据的顺序必须严格遵循以下序列，否则解析会出错：
描述 → 创建日期 → 开始日期 → 计划日期 → 截止日期 → 完成日期 → 取消日期 → 优先级 → 重复规则 → 完成时行为 → id → dependsOn/blocked → 标签 → 块链接
实际使用中通常只需要其中几个：
- [ ] 买菜 📅 2026-04-01 ⏫ #购物
- [ ] 写报告 ⏳ 2026-03-31 🛫 2026-04-01 📅 2026-04-05 🔼
- [ ] 每日站会 🔁 every weekday when done 📅 2026-04-01
标签和块链接必须放在最后 — 这是最常见的错误。
当 AI 帮用户编辑 .md 文件中的任务时，遵循以下规则：
| 操作 | 做法 |
|---|---|
| 完成任务 | 将 [ ] 改为 [x]，并追加 ✅ YYYY-MM-DD |
| 取消任务 | 将状态改为 [-]，并追加 ❌ YYYY-MM-DD |
| 设置进行中 | 将 [ ] 改为 [/] |
| 未知状态符号 | 默认视为 TODO 类型 |
| 自定义状态 | 加载 references/statuses.md 查看完整状态系统 |
只加载当前任务所需的文件。不要一次全部加载。
| 文件 | 内容 | 加载时机 |
|---|---|---|
references/syntax-core.md | 任务语法、日期、优先级、标签、重复任务、完成时行为 | 创建或编辑任务时 |
references/query-basics.md | Filter/sort/group/layout 查询指令 | 编写任务查询时 |
references/statuses.md | 状态系统、自定义状态、状态类型 | 使用非默认状态时 |
references/dependencies.md | 任务依赖（id/dependsOn/blocked） | 使用任务依赖时 |
references/query-advanced.md | 脚本函数、正则、预设、explain、紧迫度 | 高级查询场景 |
references/task-properties.md | Task 对象全部属性（状态/日期/优先级/文件/依赖等） | 使用 filter/sort/group by function 时 |
references/limitations.md | 所有限制和不支持的场景 | 排查问题时 |
本技能不处理以下内容：
obsidian-kanban 技能| ❌ 错误写法 | ✅ 正确写法 | 原因 |
|---|---|---|
- [ ] 买菜 📅 04/01/2026 | - [ ] 买菜 📅 2026-04-01 | 日期只能是 YYYY-MM-DD |
- [ ] 买菜 📅 2026-04-01 14:00 | - [ ] 买菜 📅 2026-04-01 | 不支持时间 |
- [ ] 买菜 / 备注（多行） | - [ ] 买菜（单行） | 只支持单行，第二行会被忽略 |
- [ ] 买菜 🔁 every week | - [ ] 买菜 🔁 every week 📅 2026-04-05 | 重复任务必须搭配日期 |
| 在每日笔记中创建重复任务 | 在普通笔记中创建 | 每日笔记中的重复任务会产生重复实例 |
| Canvas / 代码块 / 注释中的任务 | 普通清单项 | 这些位置的任务无法被插件识别 |
📅 2026-02-30（无效日期） | 📅 2026-02-28 | 无效日期会被静默忽略，用 !task.due.isValid 排查 |
启用全局 #task 过滤器后在查询中再用 tags include #task | 移除查询中的该标签过滤 | 全局过滤器会在读取时移除该标签，查询中无法匹配 |
A ⛔ depends on B + B ⛔ depends on A | 单向依赖链 | 循环依赖会导致查询逻辑混乱，需避免 |