SuperAPI AI 工具集

rewrite-plan

测试与质量

查看项目

更新于 10-16 09:34

技能介绍

用途:在设计到交付代码的场景中,代理编辑文件前需先产出契约式重写计划;该计划是后续每个阶段引用的审计轨迹,缺少它补丁流程易滑向“看起来不对就全部重构”,导致构建以不可审查的方式失败。

输入:来自 code-import 的 code/index.json;来自 token-map 的 token-map/*.json;已置于提示中的当前设计系统 DESIGN.md;用户的 tune 意图(通常是一段简短说明)。

输出:在 project-cwd/plan/ 下生成 plan.md(人类可读叙述)、ownership.json(文件归属,layer 取值 leaf、shared、route、shell)、steps.json(有序步骤,含 id、files、rationale、risk 取值 low、medium、high)、meta.json(generatedAt、atomDigest、tokenMapDigest)。

使用方式:poll-edit 每次迭代读取 steps.json 中的一条步骤;ownership.json 是“哪些文件属于单一组件、哪些属于共享基础设施”的唯一事实来源;除非对应步骤的 risk 为 high 且用户明确确认,patch-edit 拒绝触碰 shell 层级文件。完成条件为 plan.md 非空且 steps.json 至少包含一个步骤。

限制:禁止把“重写整个组件库”写成单一步骤,需按组件拆分;不得缺少归属分类;不得省略末尾的构建测试步骤。该 id 在 v1 中为预留的仅提示词片段,组件映射启发式与归属分类器在规范 §16 第 7 阶段落地。