SuperAPI AI 工具集

sus-change-plan

编程与开发

查看项目

更新于 11-05 01:28

技能介绍

sus-change-plan 是 jcosta33/corpus 技能集中的一个工作流技能,面向需要在保持现有行为的前提下进行结构性变更的工程场景。它强调“未经证实的保持等同于意外破坏”,因此把行为保持当作需要证据支持的约束,而非默认假设。

用途 适用于重构、重写、迁移、升级、性能变更、模式变更或大范围架构调整。在用户明确请求制定计划,或人类选择 Suspec change-plan 工作流后进入。

主要能力与方法

  1. 取证式准备:阅读项目规则、长期决策、当前源码、测试和现状地图。当变更范围较广且缺乏已证实的地图时,先为不熟悉或对变更关键的区域建立长期现状档案;仅在变更孤立、地图已证实且不存在行为保持、分阶段切换或回滚风险时跳过。
  2. 歧义处理:可逆的约定自行解决;当歧义涉及行为、公共契约、安全、成本、权限或不可逆操作时,强制交由人工显式选择,并在选择前阻塞依赖批次。提问通过原生选择器或编号选项加“其他”进行,推荐项排在最前,提供三个真实选项(二选一时可两个),每项附简明理由与代价。
  3. 产出变更计划:写入 ~/.agents/artifacts/<workspace>/ 的绝对路径,<workspace> 取自仓库或工作目录基名;文件含 type: change-plan、唯一 CHANGE-ID,并在旁侧放置关联附属文件。名称冲突或工作区不明时提供人类可读的名称选项;写入受阻时提供授权重试、改用其他与智能体无关的用户目录或取消三种处理。绝不覆盖,也不回退到仓库、第三方目录或临时路径。本地源码引用相对产出物书写,仅运行时交接使用绝对路径。
  4. 计划结构:使用最小 frontmatter(type、id、kind、preserves 列表),preserves 中治理性需求用完整 SPEC-id#AC-NNN,计划局部保证用 PG-NNN。正文只写承重章节:基线(当前状态、直接证据、所用地图)、目标(最终结构、有意的行为变更、保留的行为)、保持性保证(ID | 行为 | 验证方式)、转换批次(使构建与测试保持通过的最小有序变更,每批注明受影响面、验证与回滚点)、切换/回滚(可观测的进入、完成、中止与恢复条件)、任务拆分(可派发的归属与依赖,或 None)。kind 用于命名变换类型;仅对无需求 ID 的保留行为铸造 PG-NNN。
  5. 验证要求:要求基准、差分或属性检查在行为漂移时失败;绿测试只证明其已执行的覆盖。每个兼容层须有路径、前向目标与机械移除条件。跨源码、测试、生成代码、动态派发、注册表、配置与反射统计旧调用点,完成目标为命名兼容层之外归零。记录每一处有意的重写差异,其余全部保留。性能变更须在前后使用同一协议:工作负载、输入、环境、预热、样本、统计量、目标与回归上限。仅在消费者无法原子切换时使用模式共存。校验 frontmatter 与必备章节,将每个 preserves ID 解析到源规范或计划保证,并要求每个转换批次注明验证。
  6. 输出与关闭:交接前删减重复、含糊、仪式与结构冗余,但不改变契约、标识符、逐字源文本、证据或行为,并重跑适用的检查。只返回变更计划及每个附属文件的可点击 Markdown 链接,使用紧凑的 ~/.agents/... 标签和完全展开的绝对目标;仅解释阻塞、创建失败、验证不完整或不可逆操作确认。产物完全执行且无下游步骤需要后,要求人类对产物及附属文件做一次处置:删除、保留或提升;提升即把临时材料移入项目自有永久位置。删除所选路径并验证不存在,残留会阻塞关闭。

适用场景与限制 适合需要严谨行为保持证据、分阶段切换和可回滚方案的中大型结构变更。依赖人工交互选择、项目内规范与测试作为输入;官方资料未提供安装命令、收费、价格或平台支持信息,暂未提供。