SuperAPI AI 工具集

synthesis-preplan

编程与开发

查看项目

更新于 10-22 16:15

技能介绍

Synthesis Preplan 是一个架构决策锁定器,用于在工单或问题进入实际规划前,通过结构化问答循环锁定承重架构决策,并生成决策摘要文件,再交接给后续规划步骤。

用途

该技能的核心目的是让“决定构建什么”这一规划中最困难的部分显式化。它认为一旦架构决策被锁定,逐提交的计划就是机械性的。因此它在代码存在之前运行,聚焦于架构层:选择哪个基础分支、范围边界、以及有能力的工程师可能给出多种答案的设计问题。

主要能力

  1. 来源接地:读取工单(包括评论)、前置分支/PR/工单、路线图文档,识别依赖图(上游约束、下游消费、并行共享假设)。
  2. 初始评估:产出五个简短工件——一句话工单目标、分支堆叠建议、依赖澄清、范围边界声明、执行通道(完整逐提交工作流或单提交工作流)及理由。
  3. 初步计划:列出承重决策、任务分解(提交)、开放问题,作为暴露架构问题的载体。
  4. 开放问题问答循环:对每个开放问题呈现问题、具体选项、重要性、推荐倾向;支持接受、重定向、深度三种回复模式;持续迭代直到无开放问题。
  5. 决策摘要文件:将锁定决策写入 plans/<ticket-slug>-decisions.md,按主题分组,包含决策、选择、理由,并包括范围外和文档约定组。
  6. 交接给规划步骤:使用交接模板填充槽位,预览提示词,用户确认后交接给规划机制,并将返回的计划持久化为 plans/<ticket-slug>-plan.md。

使用方式

该技能以技能形式提供,需在支持技能调用的代理环境中使用。运行流程为:步骤1来源接地 → 步骤2初始评估(暂停确认)→ 步骤3初步计划 → 步骤4问答循环 → 步骤5决策摘要文件(确认)→ 步骤6交接与计划持久化。

适用场景

适用于:后端基础设施/基座工单、横切变更(模式+代码+运维面)、存在真实架构替代方案的工单、隐私/安全敏感工单、堆叠在进行中工作上的工单。不适用于:简单bug修复、UI调整、文案更改、依赖升级、只有唯一明显实现路径的工单、当前对话中已设计好只需执行的事项。

限制

资料未提供该技能的具体安装命令、收费模式、平台要求或效果数据。该技能依赖问题跟踪器(Jira、GitHub Issues、Linear等),若不可用则需用户粘贴工单内容。执行通道若为单提交,则技能其余部分通常不适用。