SuperAPI AI 工具集

changeset

编程与开发

查看项目

更新于 11-05 16:17

技能介绍

用途

changeset 是一个文件影响与级联规划技能,用于在真正实施或建立任务跟踪之前,把已确定的解决方案映射成一份可审阅的变更集(Changeset)。它回答的核心问题是:这个方案会触及哪些文件、哪些是直接改动、哪些是必要的级联影响、哪些旧逻辑需要删除。

主要能力

  • 以已确定的方向或方案为输入,结合结果、约束与可用证据,对照当前代码检出与治理契约进行核验。
  • 全程保持规划只读,不修改文件系统,并保留输入的既定方向。
  • 追踪直接与间接的调用方、实现、导入、schema 和测试。
  • 只检查目标文件与承重级联,排除外观性改动、推测性文件以及未受影响且向后兼容的调用方。
  • 清理被取代的逻辑:显式安排删除废弃的辅助函数、过时分支以及因该方案而失效的测试。
  • 若输入方案已过期或自相矛盾,则停止,而不是悄悄重新设计。

文件操作类型

  • [CREATE]:方案要求的新文件。
  • [MOVE]:移动或重命名,包括受影响的引用。
  • [UPDATE]:既有逻辑、契约、测试或必要的级联。
  • [DELETE]:方案要求删除的废弃文件。

使用方式

技能接收一份已确定的方案后,先检查该方向与当前代码、契约是否一致;若发现方案过期或存在根本性矛盾,就以 UNRESOLVED 状态报告并说明所需的重新设计决策。否则构建包含文件操作、直接级联、验收标准与证据来源的变更集树,合并冗余目录但保留文件层级,最后以 STAGED 状态呈现并停止,不执行任何文件系统变更。在别处生成的嵌入式变更集,交接义务相同,但无需调用本技能。

输出契约

STAGED 输出包含:标题(范围 · STAGED)、Basis(已确定方案及支撑证据或引用)、Acceptance(可观察的验收标准与约束),以及文本形式的目录树,每个文件标注操作类型和承重变更或不变式,最后给出受影响文件数量汇总(新建、更新、移动、删除各多少)。UNRESOLVED 时以简洁的阻塞点、证据和所需重新设计决策替代目录树,不编造文件操作。

路由

  • 方案过期暴露未解决的需求 → 经 /clarify 处理。
  • 方案过期需要新的设计方向 → 经 /architect-decision 处理。
  • 变更集获得授权可实施 → 经 /forge 处理。
  • 调用方需要拆分为可验证的任务切片 → 经 /split-tasks 处理。
  • 调用方需要持久化到待办或问题跟踪 → 经 /track-tasks 处理。

适用场景

适用于在动手编码前需要明确改动范围与依赖连锁反应的开发工作,尤其是需要把方案转换为可审阅计划、并把该计划交接给实施、任务拆分或问题跟踪环节的场景。

限制

该技能仅做只读规划,不执行任何文件系统修改。输入方案必须已确定且与当前代码一致;若方案过期或矛盾,只能报告 UNRESOLVED 并要求决策。文档未提供收费、价格、平台支持范围等信息的,暂未提供。