任务导出
将任务导出为带 YAML frontmatter 的 Markdown
它能做什么
导出系统会把你的项目任务转换为独立的 Markdown 文件。每个导出的文件都包含:
- YAML frontmatter —— 结构化元数据(status、phase、priority、tags、dates)
- Description(描述) —— 任务的详细描述
- Session links(会话链接) —— 关联的聊天会话,含名称与日期
- Deliverables(交付物) —— 追踪的产出,含类型、创建者与字数
- Metadata footer(元数据页脚) —— 内部 ID 与 AI 建议来源(如适用)
你可以导出单个任务,也可以导出整个项目。
如何使用
导出单个任务
- 1点击任务卡片,打开其详情面板
- 2点击 Export 按钮(下载图标),位于面板底部
- 3文件会被保存为 Markdown(例如
TOR-001.md),并在你的文件浏览器中打开
导出所有任务
当你将所有任务导出到某个文件夹时,TorlyAI 会创建:
- 每个任务对应一个
.md文件,以展示编号命名(例如TOR-001.md、TOR-002.md) - 一个
README.md索引文件,内含所有任务的汇总表
索引文件包含:
- 任务总数与状态分布
- 一个表格,列包括:Key、Title、Status、Phase、Priority 与 Team Member
- 指向每个单独任务文件的链接
默认导出位置
~/.torlyai/workspaces/{id}/project/exports/tasks/导出格式
YAML frontmatter
每个导出的文件都以 YAML frontmatter 开头,其中包含全部任务元数据:
---
aliases:
- TOR-001
- Define core product vision
type: task
cssclass: torlyai-task
date: 2026-01-15
key: TOR-001
title: Define core product vision
status: done
phase: discovery
priority: high
team_member: strategist
assignee: Dumbledore
tags:
- task/done
- phase/discovery
- priority/high
- team/strategist
- vision
- foundation
created: 2026-01-15T10:30:00.000Z
updated: 2026-01-20T14:45:00.000Z
---Obsidian 兼容性
该 frontmatter 设计为可在 Obsidian 中开箱即用: aliases 让你既能按 key 也能按标题建立链接, type: task 支持 Dataview 查询, cssclass: torlyai-task 可应用自定义样式, 层级化标签(例如 task/done、phase/discovery)支持精细化筛选。
内容章节
在 frontmatter 之后,文件包含:
- 1Description(描述) —— 任务描述(或 "No description provided")
- 2Session Links(会话链接) —— 逐项列出,含角色(Primary/Reference)、会话名称与日期
- 3Deliverables(交付物) —— 带编号的列表,含类型图标、标题、字数、创建者与预览
- 4Metadata(元数据) —— 内部 ID、显示状态、排序,以及 AI 建议来源
自动导出选项
你可以配置在特定事件触发时执行的自动导出:
On Complete(完成时)
当某个任务的状态变为 "Done" 时触发
On Status Change(状态变更时)
当某个任务在任意列之间移动时触发
小贴士
- 用导出来做备份 —— 尽管数据存储在本地,Markdown 导出仍提供了一份人类可读的备份
- 导入 Obsidian —— 把你的导出文件夹放进 Obsidian 知识库(vault),并用 Dataview 查询任务
- 分享给顾问 —— 导出单个任务,发送给导师或顾问以供审阅
- 纳入 git 追踪 —— Markdown + YAML 格式非常适合版本控制,便于查看两次导出之间发生了哪些变化
- 善用索引文件 —— 自动生成的
README.md让你无需打开单个文件即可快速总览所有任务