Synthesis Preplan 是一个架构决策锁定器,用于在工单或问题进入实际规划前,通过结构化问答循环锁定承重架构决策,并生成决策摘要文件,再交接给后续规划步骤。
用途
该技能的核心目的是让“决定构建什么”这一规划中最困难的部分显式化。它认为一旦架构决策被锁定,逐提交的计划就是机械性的。因此它在代码存在之前运行,聚焦于架构层:选择哪个基础分支、范围边界、以及有能力的工程师可能给出多种答案的设计问题。
主要能力
- 来源接地:读取工单(包括评论)、前置分支/PR/工单、路线图文档,识别依赖图(上游约束、下游消费、并行共享假设)。
- 初始评估:产出五个简短工件——一句话工单目标、分支堆叠建议、依赖澄清、范围边界声明、执行通道(完整逐提交工作流或单提交工作流)及理由。
- 初步计划:列出承重决策、任务分解(提交)、开放问题,作为暴露架构问题的载体。
- 开放问题问答循环:对每个开放问题呈现问题、具体选项、重要性、推荐倾向;支持接受、重定向、深度三种回复模式;持续迭代直到无开放问题。
- 决策摘要文件:将锁定决策写入
plans/<ticket-slug>-decisions.md,按主题分组,包含决策、选择、理由,并包括范围外和文档约定组。 - 交接给规划步骤:使用交接模板填充槽位,预览提示词,用户确认后交接给规划机制,并将返回的计划持久化为
plans/<ticket-slug>-plan.md。
使用方式
该技能以技能形式提供,需在支持技能调用的代理环境中使用。运行流程为:步骤1来源接地 → 步骤2初始评估(暂停确认)→ 步骤3初步计划 → 步骤4问答循环 → 步骤5决策摘要文件(确认)→ 步骤6交接与计划持久化。
适用场景
适用于:后端基础设施/基座工单、横切变更(模式+代码+运维面)、存在真实架构替代方案的工单、隐私/安全敏感工单、堆叠在进行中工作上的工单。不适用于:简单bug修复、UI调整、文案更改、依赖升级、只有唯一明显实现路径的工单、当前对话中已设计好只需执行的事项。
限制
资料未提供该技能的具体安装命令、收费模式、平台要求或效果数据。该技能依赖问题跟踪器(Jira、GitHub Issues、Linear等),若不可用则需用户粘贴工单内容。执行通道若为单提交,则技能其余部分通常不适用。