用途:Sidequest(/sidequest)把对话历史与进行中的任务合成为可视化会话地图 sidequest.md,底层由确定性 JSON 状态文件 sidequest.json 支撑,用于跟踪任务层级与上下文漂移。
主要能力:按 Main Quest、Sub-Quest、Blocker、Step、Side Quest 五级组织任务,带状态标记(待办、进行中、已停放、已完成)与完成顺序标签([#N ⭐]);跟踪 VCS 生命周期(📝 Dirty → 📦 Local Commit → 🚀 Uploaded → 🎉 Merged → 🧹 Clean);sidequest.json 在上下文截断后仍保留状态模型。
使用方式:状态更新与地图编译必须通过 CLI 工具 sidequest 完成,不得手改 sidequest.json 或手写 sidequest.md。常用命令:sidequest status、sidequest init "Title"、sidequest subquest add 1 "UI Implementation" [--start]、sidequest step add 1.1 "Draft UI widget" [--start]、sidequest blocker add 1.1 "..."、sidequest sidequest add "..." [--global] [--parked]、sidequest start 1.1 1.1.1、sidequest batch '[...]'、sidequest complete 1.1.1 1.1.2 1.1、sidequest vcs 1 --stage=dirty|local_commit|uploaded|merged|clean、sidequest reopen 1.1、sidequest remove 1.1.2。长历史重建用 /sidequest rebuild,由审计子代理从 watermark.stepIndex 起检查 transcript.jsonl,再执行 sidequest merge-audit --input=<payload_file>。
适用场景:会话中任务层级梳理、进度汇报、上下文漂移恢复、跨会话保留已讨论工作。
限制:sidequest.md 只记录已明确讨论、提出或引用的工作,不得编造或外推未讨论任务;未讨论的新想法只能在聊天窗口提出。被用户放弃的选项应直接省略,不得放入 [Parked]。状态文件仅存放于会话产物目录(通过 ANTIGRAVITY_CONVERSATION_ID、CLAUDE_ARTIFACT_DIR、GEMINI_ARTIFACT_DIR 或 --dir 自动发现),不得写入用户仓库或 dotfiles;不得在面向用户的对话中提及 sidequest.json;不得在主对话直接读取 transcript.jsonl。完成父级 Sub-Quest 不会自动完成子项,需一并传入子项 ID。
其他:具体安装方式、收费与平台支持暂未提供。