用途
Task Preparation 的目标是把一个已选定的路线图任务转化为可实施的任务级文档,即规格(spec)阶段。它适用于以下情况:已选定一个具体任务,或根据已确认的路线图状态该任务明确是下一步;接下来的工作是任务级澄清、编写 spec.md、可选的 plan.md 以及执行交接;路线图结构足够稳定,可以在不重塑里程碑或任务的前提下准备实施。
不适用的情况包括:里程碑确认、任务选择或依赖顺序仍不明确;当前工作仍处于路线图分解或规划对齐阶段;当前工作属于实施、就绪检查、验证或分支关闭。
主要能力
该技能负责:任务可选择性检查;为 grilling 环节构建任务级澄清框架;编写 spec.md;按需编写 plan.md;任务级文档的评审暂停;默认的已评审文档后续处理;执行交接上下文。
它不负责:重塑里程碑或新的路线图分解;执行隔离、实施、验证或分支关闭;把阻塞性的任务边界歧义隐藏在模糊的规格中;利用 plan.md 引入新范围或重写已批准的规格。
使用方式
进入条件(需全部满足):里程碑已标记 Roadmap confirmed: yes;跨里程碑时前一里程碑关闭已解决;任务状态为 planned 或 in_progress;依赖已满足或明确豁免;没有未解决的硬性门禁阻塞进展;用户已选定任务,或文档明确标识其为下一步。若任一条件不明确,应回到 milestone-planning。
任务级访谈循环使用外部 grilling 技能。若不可用,应请用户安装,而不是在此重建其完整协议。
始终编写 spec.md,不可跳过。默认不写 plan.md,仅当存在真实的计划触发条件时才创建。
澄清规则:在起草 spec.md 之前运行 grilling 会话,即使任务看起来很明显。先用代码和文档解决当前状态事实。不要将当前实现或现有文档视为未来意图、范围、验收或非目标决策的权威。当未解决的分支涉及应改变什么、什么应排除在范围外、或任务旨在产生什么未来行为时,询问用户。让 grilling 运行访谈协议,同时本技能保持任务级边界。当范围、验收、非目标、迁移归属、发布行为、证明期望和允许的最小实现对任务级设计有实质影响时,将其视为阻塞项。在阻塞分支未解决时,不要基于假设的默认值起草。
默认流程:确认所选任务确实可从已确认的路线图状态中选择;若任务仍为 planned,在活动任务级工作开始时将其移至 in_progress;在任务级约束下运行 grilling 直到阻塞分支解决;一次性起草完整的 spec.md;停止等待规格评审;若规格评审后存在计划触发条件,编写 plan.md 并停止等待计划评审;运行默认文档后续处理;仅在文档后续处理结果明确后才交接给执行。
计划触发条件:3 个或更多主要文件或模块必须变更且修改顺序影响正确性;数据库模式、迁移、回填或持久化格式变更;公共 API、CLI、配置格式、插件接口或任务文档兼容性边界;跨模块协调且职责或顺序不明显;分阶段发布、功能标志、双读、双写或迁移过渡行为;不明显的验证顺序;一个任务内仍存在多个实现切片且不应在路线图层面拆分;实施编辑前需要探索性 spike 或风险降低工作。对于实现顺序直接的小型单一能力任务,不要创建 plan.md。若计划触发状态不确定,指出疑似触发条件并在编写计划前询问。
边界规则:保持 1 任务 -> 1 规格。若任务似乎需要多个规格,则任务边界有误。plan.md 补充已批准的 spec.md,不重述规格。除非已在当前任务范围内,否则不要将后续工作写入当前 plan.md。准备期间发现的未来工作默认应放入当前里程碑 index.md 的 Handoff Notes 下,而非 plan.md。紧凑的规格可以,模糊的规格不行。使边界、非目标、可能的首次编辑面和证明期望足够明确,以便新对话或另一个智能体可以继续。
何时回退:当以下任一情况成立时,回到 milestone-planning 而不是强行编写当前规格:任务需要两个互斥的范围选择才能成立;任务似乎需要两个独立规格;验收实际描述了两个可独立评审或独立发布的能力;缺失的依赖实际是路线图顺序问题而非任务级设计问题。
任务状态规则:进入活动任务级准备时,若任务尚未变更,应将其从 planned 移至 in_progress。在澄清、spec.md、可选 plan.md、评审暂停或文档后续处理仍活跃时,保持任务为 in_progress。当任务级准备因真实阻塞问题、外部依赖、缺失前置条件或用户明确暂停而无法继续时,使用 blocked。阻塞条件解决且活动工作恢复后,将 blocked 任务移回 in_progress。准备期间不要将任务标记为 completed;完成属于实施和分支关闭之后的执行阶段。
评审与默认后续处理:在 spec.md 后停止于评审暂停。存在计划时,在 plan.md 后停止于第二个评审暂停。评审暂停后任何明确的前进消息视为允许常规后续处理。在 spec.md 评审暂停时,同一前进消息视为批准已评审的规格,除非用户要求更改。最终任务级评审后的默认后续处理是:提交已评审的任务级文档,除非用户明确要求保持未提交。若已评审文档保持未提交,应说明这是明确例外、给出原因并列出受影响文件。在文档后续处理结果解决并报告之前,该阶段不算完成。
硬性门禁:不要使用 continue 绕过未解决的任务边界歧义。当阻塞性的 Undecided 项仍影响 spec.md、plan.md 或已评审文档后续处理时,不要交接给执行。不要让已评审文档的批准暗示允许破坏性执行操作;那些属于执行阶段。
输出与交接
输出包括:Task、Readiness check、Blocking questions、Spec result、Plan needed? why?、Review stop、Docs follow-up outcome、Execution handoff。
停止点:规格评审暂停、计划评审暂停,或关于任务级歧义或任务边界失败的直接阻塞问题。
交接内容:Decided、Undecided、Next skill、Stop point。
参考
当存在语言规则时,以仓库文档语言生成 spec.md;否则使用当前用户语言。模板章节名称是结构提示,不是固定英文文本;将标题、标签和字段名本地化为所选文档语言。任务级 spec.md 使用 references/spec-template.md。任务级 plan.md 使用 references/plan-template.md。