plan-quest 是 moq-dev/moq 提供的技能,用于通过交互式访谈来界定、创建和发布 quest。开始前需完整阅读 quest/AGENTS.md。
用途:当用户调用 /plan-quest、要求规划一个 quest,或存在尚未确定的计划时使用。核心是通过反复追问,让用户与技能就目标达成共识。
主要能力与流程:
- 目标界定:访谈首先聚焦目标本身,即可观测的结果、其重要性、重要边界和非目标。在目标确定之前不进入实现决策。若目标包含可独立完成的结果,应先拆分再规划。
- 设计树规划:将实现计划映射为一棵设计树,每个重要决策都分支出依附于它的后续决策。
- 分轮推进:每轮只询问“前沿”问题,即所有前置条件已确定、当前无需猜测即可回答的问题。若支持交互,一轮中同时提出整个前沿:每个问题编号、每个答案用字母标记,并在一个答案前标注 (recommended)。然后等待用户回答再进行下一轮。
- 动态重算:用户每轮回答都会重塑设计树,已确定的决策把前沿向外推进并解锁依赖问题,随后重新计算前沿并询问下一轮。若某问题的答案依赖本轮仍未解决的问题,则归入后续轮次。
- 事实查找:查找事实是技能的职责而非用户的责任。当某个前沿问题需要来自环境(文件系统、工具等)的事实时,派发子代理去查找,不向用户询问可自行查得的信息。不因此阻塞:正在进行的探索属于未确定的前置条件,只让依赖它的问题等待子代理报告,其余前沿问题照常询问。决策权属于用户,每个决策都交由用户并等待答复。
- 全局一致性:搜索其他 quest 和 questline 以保持更大计划的一致性。当前沿与已确定的 quest 冲突时,向用户提出质疑并询问是否扩大范围来解决冲突。
- 完成条件:当前沿为空时会话结束,即设计树的每个分支都已访问,没有遗留的静默假设。结果可能是一个或多个 quest 与 questline;可独立完成的结果应拆分。每个 quest 标题需加前缀 [XS]、[S]、[M]、[L] 或 [XL],涵盖实现、验证和落地工作。
- 发布:完成后创建、更新或删除相关 quest 与 questline,提交并创建 PR,若 quest 已就绪可提议立即开始执行。
适用场景:需要系统化界定目标和实现路径的规划任务;希望把模糊需求拆成可独立完成、可验证的多个 quest 的场景;需要与既有 quest 计划保持一致性的规划。
限制:资料未提供具体安装命令、命令行参数、依赖环境或收费信息;执行效果取决于用户是否参与交互式问答以及环境中是否有可查询的事实。