用途
changeset 是一个文件影响与级联规划技能,用于在真正实施或建立任务跟踪之前,把已确定的解决方案映射成一份可审阅的变更集(Changeset)。它回答的核心问题是:这个方案会触及哪些文件、哪些是直接改动、哪些是必要的级联影响、哪些旧逻辑需要删除。
主要能力
- 以已确定的方向或方案为输入,结合结果、约束与可用证据,对照当前代码检出与治理契约进行核验。
- 全程保持规划只读,不修改文件系统,并保留输入的既定方向。
- 追踪直接与间接的调用方、实现、导入、schema 和测试。
- 只检查目标文件与承重级联,排除外观性改动、推测性文件以及未受影响且向后兼容的调用方。
- 清理被取代的逻辑:显式安排删除废弃的辅助函数、过时分支以及因该方案而失效的测试。
- 若输入方案已过期或自相矛盾,则停止,而不是悄悄重新设计。
文件操作类型
- [CREATE]:方案要求的新文件。
- [MOVE]:移动或重命名,包括受影响的引用。
- [UPDATE]:既有逻辑、契约、测试或必要的级联。
- [DELETE]:方案要求删除的废弃文件。
使用方式
技能接收一份已确定的方案后,先检查该方向与当前代码、契约是否一致;若发现方案过期或存在根本性矛盾,就以 UNRESOLVED 状态报告并说明所需的重新设计决策。否则构建包含文件操作、直接级联、验收标准与证据来源的变更集树,合并冗余目录但保留文件层级,最后以 STAGED 状态呈现并停止,不执行任何文件系统变更。在别处生成的嵌入式变更集,交接义务相同,但无需调用本技能。
输出契约
STAGED 输出包含:标题(范围 · STAGED)、Basis(已确定方案及支撑证据或引用)、Acceptance(可观察的验收标准与约束),以及文本形式的目录树,每个文件标注操作类型和承重变更或不变式,最后给出受影响文件数量汇总(新建、更新、移动、删除各多少)。UNRESOLVED 时以简洁的阻塞点、证据和所需重新设计决策替代目录树,不编造文件操作。
路由
- 方案过期暴露未解决的需求 → 经 /clarify 处理。
- 方案过期需要新的设计方向 → 经 /architect-decision 处理。
- 变更集获得授权可实施 → 经 /forge 处理。
- 调用方需要拆分为可验证的任务切片 → 经 /split-tasks 处理。
- 调用方需要持久化到待办或问题跟踪 → 经 /track-tasks 处理。
适用场景
适用于在动手编码前需要明确改动范围与依赖连锁反应的开发工作,尤其是需要把方案转换为可审阅计划、并把该计划交接给实施、任务拆分或问题跟踪环节的场景。
限制
该技能仅做只读规划,不执行任何文件系统修改。输入方案必须已确定且与当前代码一致;若方案过期或矛盾,只能报告 UNRESOLVED 并要求决策。文档未提供收费、价格、平台支持范围等信息的,暂未提供。