SuperAPI AI 工具集

propagate-design-change

设计与创作

查看项目

更新于 10-15 21:11

技能介绍

用途:当 GDD(游戏设计文档)发生变更时,原本基于它的架构决策记录(ADR)可能不再成立。该技能定位受影响的 ADR,比较 ADR 当时的假设与 GDD 现状,生成影响报告并引导用户逐一处理。

主要能力与流程:校验传入的 GDD 路径参数;用 git diff 对比 GDD 的改动(如 git diff HEAD -- design/gdd/[filename].md,必要时改用 git diff HEAD~1 HEAD -- ...),从差异块识别变更与未变更的章节;产出变更摘要,并可通过 design/registry/entities.yaml 计算下游 GDD 影响;按解析出的 tier(full/standard/minimal)加载 docs/architecture/ 下的 ADR,先用 Grep 扫描需求表与正文引用得到受影响集合,再按需读取 Context、Decision、Consequences 做判断;将每个 ADR 分类为「仍然有效 / 需要复核 / 可能被取代」,并给出建议动作。

使用方式:命令为 /propagate-design-change design/gdd/combat-system.md,需提供 GDD 路径。在 full 评审模式下会触发技术总监门 TD-CHANGE-IMPACT;随后逐条询问用户处理方式(标记取代、就地更新、保持原样或跳过),并询问是否更新追溯索引、是否写入 docs/architecture/change-impact-[date]-[system-slug].md。

适用场景与限制:适用于采用 GDD、ADR 与追溯索引的 Claude Code 游戏工作室工作流。minimal 工作流层级下没有 ADR 可级联;standard 仅检查关键(Foundation 层)及引用该 GDD 的 ADR;若 GDD 无 git 历史或 diff 为空,则视为新文档或无变更。写文件前均需用户确认,且不删除 ADR 内容。价格、平台等其它信息暂未提供。