SuperAPI AI 工具集

hrt-change-size-gate

通用与其它

查看项目

更新于 10-15 22:12

技能介绍

用途:在 tempa-spec schema 的 proposal 阶段、"What Changes" 与 "Capabilities" 草拟完成后、定稿前运行,用于发现一个变更中捆绑了多个独立用户故事的情况,防止 specs、design、tasks、apply 等下游阶段同时膨胀、质量下降。该门控偏向单一变更,认为过度拆分才是更常见的失败,单个跨多层的宽泛故事属正常,不构成拆分信号。

主要能力:检查草稿的 "What Changes" 列表,找出同时满足三个条件的两个及以上条目——可独立交付(只交付该项仍能让用户使用和验证)、无依赖(不依赖列表中其他条目的代码或数据)、能力不同(不落在正在草拟的 Capabilities 中同一能力下)。少于两个此类条目则门控不触发,静默按单一变更继续;两个及以上则必须停止,向用户提问“一个变更还是多个?”,并说明哪些条目看起来独立及原因,用户未答复前不得继续。

使用方式:若用户决定保持单一变更,proposal 不变、不记录任何内容。若用户决定拆分,依次执行:询问先构建哪个切片,只为该切片写 proposal.md;在 proposal.md 添加 ## Out of Scope 段,每个被排除切片一行;在 discovery.md 的 Key Decisions 添加一条永久记录(含被拒绝的替代方案);在 hrt-adversarial-authoring 步骤中若 Destructive Critic 进一步缩小范围,将新排除切片加入 ## Out of Scope;## Out of Scope 定稿后同步 openspec/BACKLOG.md,删除已被覆盖的条目,为每个剩余切片追加条目(含 slug、Raised by、Slice、Deferred because),文件不存在则创建并写入指定标题与说明,删除条目后即使为空也保留标题、不得删除文件。

限制:门控需要交互式用户;非交互运行中无法解决提问,按单一变更继续并在 proposal.md 注明门控未能运行,这是 OpenSpec 的通用限制。暗色模式(存在 dark.md)下仍升级给用户,不得路由到 hrt-dark-mode-decision-gate。proposal.md 的 ## Out of Scope 为权威来源(随变更归档),BACKLOG.md 由其派生并持久保存,冗余是刻意的。