名称： quests
描述： 追踪并引导用户完成复杂的多步骤现实世界流程。当用户需要帮助处理官僚、法律、技术或任何需要组织化追踪、分步指导和进度监控的多步骤程序时使用。触发条件包括：“帮我处理这个流程”、“指导我完成”、“追踪这个项目”、“创建一个任务”，或任何适合分解为可管理步骤的复杂任务。也适用于现有任务：“我的任务进展如何”、“[流程]的下一步是什么”、“更新我的进度”。这适用于跨会话/跨多日的流程，而非简单的单次任务。任务取代了零散的记忆文件——它本身就是长期运行流程的记忆。

任务 — 引导式流程框架

一个标准化框架，用于AI助手追踪并引导用户完成复杂的长期任务。任务是唯一的事实来源——上下文、决策、联系人、风险和进度都存在于任务内部，而非分散在多个记忆文件中。

核心理念

• 一次一步：quest next 仅显示当前任务——避免信息过载
• 任务即记忆：quest context 以最少的令牌提供助手所需的一切信息
• 活文档：步骤可随时添加、删除、重新排序和修改
• 用户友好：quest brief 生成适合消息传递的摘要

CLI：skills/quests/scripts/quest.py（符号链接为 quest）

数据存储在 $WORKSPACE/data/quests.json。任务ID根据名称自动生成（转换为URL友好格式）。

使用约定

• 自动解析：当只有一个活动任务时，任务参数是可选的
• 模糊匹配：任务可通过精确ID、ID前缀或名称子字符串匹配
• 可选参数：不带步骤参数的 quest done 将完成当前活动步骤

快速开始

quest new "修理汽车" --priority high --deadline 2026-06-01
quest add car "获取文件" --desc "收集所有文书"
quest substep car 1 "找到保险证书"
quest learn car "税务豁免需要在国外居住12个月"
quest decide car "使用合同日期作为证明" --reason "没有PERE注册"
quest contact car "机构" --phone "555-1234" --role "税务办公室"
quest next car                    # 向用户呈现当前步骤
quest done car 1.1                # 标记子步骤完成
quest context car                 # 重新加载完整上下文（约1K令牌）

恢复任务（新会话）

quest list                        # 查找活动任务
quest context myquest             # 加载完整状态——替代读取记忆文件
quest next myquest                # 向用户呈现当前步骤

命令参考

任务生命周期：
- new <名称> [--desc] [--priority low|medium|high] [--deadline 日期] [--tags a,b]
- list [--all] — 列出活动任务（或包括已归档的所有任务）
- delete <任务> [--archive] — 归档可逆，删除是永久性的

步骤（完全灵活）：
- add <任务> <标题> [--desc] — 追加一个步骤
- insert <任务> <位置> <标题> [--desc] — 在特定位置插入
- remove <任务> <步骤> — 移除一个步骤或子步骤（例如 3 或 2.1）
- substep <任务> <步骤> <标题> — 向步骤添加子步骤
- done [任务] [步骤] — 完成步骤/子步骤（自动推进到下一步）
- skip [任务] [步骤] — 跳过步骤
- block <任务> <步骤> <原因> — 标记步骤为受阻
- unblock <任务> <步骤> — 解除受阻状态
- edit <任务> [步骤] [--title] [--desc] — 编辑步骤或任务级别字段
- reorder <任务> <步骤> <位置> — 将步骤移动到新位置

上下文与记忆（核心功能）：
- learn <任务> <事实> — 记录关键事实（任务级别，影响所有步骤）
- decide <任务> <决策> [--reason] — 记录决策及其理由
- risk <任务> <顾虑> — 标记风险或顾虑
- note <任务> <步骤> <文本> — 向特定步骤添加备注（步骤级别）
- summarize <任务> <文本> — 更新高层上下文摘要
- context [任务] [--json] — 紧凑的上下文转储（约500-1500字符）
- brief [任务] — 适合异步消息传递的用户友好摘要
- log [任务] [-n 限制] — 带时间戳的活动日志

learn 与 note 的区别：使用 learn 记录影响整个任务的事实（如“税务豁免需要在国外居住12个月”）。使用 note 记录特定步骤的信息（如“Carlos说他已有CoC”）。

元数据：
- meta <任务> [--priority] [--deadline] [--tags a,b] [--remove]
- contact <任务> [姓名] [--phone] [--email] [--role] [--url] — 添加或列出联系人
- link <任务> [url] [--label] — 添加或列出参考链接

模板：
- template save <任务> [模板名称] — 将任务结构保存为可重用模板
- template list — 列出可用模板
- template use <模板> [任务名称] — 从模板创建新任务

显示：
- next [任务] — 仅显示当前步骤（用于呈现给用户）
- show [任务] [-v] — 显示完整任务及其所有步骤和上下文
- status [任务] — 快速进度概览

导出：
- export <任务> [--file 路径] — 导出为Markdown格式
- json [任务] — 原始JSON格式（若无参数则导出所有任务）

AI助手指南

何时（不）创建任务

• 创建：跨会话流程、官僚任务、任何超过3个步骤且持续多日的任务
• 不创建：简单的单次任务、快速查询、适合单次对话完成的事情

开始新任务

1. 使用 quest new 创建——如果已知，设置优先级和截止日期
2. 使用 quest add 添加5-12个步骤（使用子步骤进行细化）
3. 使用 quest learn 记录初始事实
4. 在发现过程中添加联系人、链接和风险
5. 使用 quest next 呈现第一步

会话恢复

在涉及现有任务的任何会话开始时：
1. quest list — 检查活动任务
2. quest context <ID> — 重新加载完整状态（替代读取记忆文件）
3. quest next <ID> — 查看用户上次中断的位置

流程进行中

• 记录一切：事实（learn）、决策（decide）、风险（risk）
• 随着理解深入，使用 quest summarize 更新摘要
• 随着流程变化，自由添加/删除/重新排序步骤
• 在异步消息传递（如WhatsApp/Discord摘要）时使用 quest brief
• 在交互式对话中使用 quest next

向用户呈现

• 始终使用 quest next — 除非用户要求，否则不要显示完整的步骤列表
• 当用户完成某事项时 → quest done → 自动推进
• 当受阻时 → quest block 并注明明确原因
• 当用户提供信息时 → quest learn 或 quest note

多个活动任务

自动解析仅在有一个活动任务时有效。当有多个活动任务时，务必明确指定任务ID。

任务完成

当所有步骤完成后，任务自动完成。考虑：
- quest export <任务> --file 保存永久记录
- 如果流程可能重复，使用 quest template save
- quest delete <任务> --archive 清理数据同时保留存档

令牌效率

• quest context 输出约500-1500字符，包含完整情境感知
• 无需单独的记忆文件、追踪器或项目文档
• 任务本身就是记忆——事实、决策、联系人、风险，全部集中一处
• 使用 quest context --json 进行结构化程序访问