| name | aigd-sync |
| description | AIGD 贯穿动作 · 回写整合(非线性"最后一步",每个系统 handoff 后都触发)。当某系统落定后要更新全局规范、整体 html 原型(整合 demo)、实现总纲(交接包入口),或某共享项变更后标记下游系统重验时使用。维护脊柱与交接包入口的一致性。是 aigd 包的一员,方法论见 ../aigd/references/。 |
AIGD · sync(回写整合) [最小骨架]
包契约:aigd 整包安装(编排器 aigd/+references/ 与 6 子 skill(含 aigd-ui-capture)同级放于本环境的 skills 目录,随宿主 agent,如 Claude Code 的 .claude/skills/),勿单拷本 skill——本包子 skill 靠同级 aigd/ 取方法论,单独拷会断链。
定位
贯穿动作(不是线性"第 5 步"):每个系统 handoff 后都触发,持续 / 里程碑式回写。把单系统的成果回写到项目层,保持脊柱与整体一致;管"下行影响"。
读 / 产 / 写回
- 读:
manifest(全量)、各系统状态、项目档案。
- 产 / 改:
- 全局规范收口(枚举 / 号段 / 量纲 去重对齐)。
规范/全局集成验收.md(把下方「集成检查」结果落盘成跨系统验收;实现总纲 即指向它)。- 整体原型(整合 demo)—— 单文件 html,放项目档案『目录布局』指定处(工程化布局归
docs/prototypes/)。
实现总纲.md(交接包入口:给下游 AI 的 start here)。
- 写回:① 共享项变更 → 按「配方 4」两类反查(点对点 → A 表「被依赖(下游)」/ 广播型 → C 表「引用的共享真源」)→ 标受影响的已定稿系统「待重验」(记在 D 表);② 重验通过 → 该系统「
待重验 → 定稿」,刷新 D 表定稿时间(= 本次重验确认时间)——这是 待重验 状态唯一的出口,不补它该状态会永远悬在那。
配方
- 系统定稿后:收编其枚举/号段到全局规范。
- 把该系统并进整体原型(整合 demo)。
- 刷新实现总纲(系统清单/建造顺序/契约位置/验收入口)。
- 跑下行影响,分两类(各自反查不同列):
- 点对点系统边(某系统的产出被另几个系统消费)变 → 反查 A 表「被依赖(下游)」,标那几个下游
待重验(记在 D 表)。
- 广播型共享真源(枚举 / 文本结构 / id 命名空间,见 manifest F 表)变 → 向后兼容(纯追加)免重验;破坏性变更 → 反查 C 表「引用的共享真源」 找出列了它的系统(广播型真源不在 A 表「被依赖」里)→ 标这些系统 D 表
待重验,别炸全表。
- 重验
待重验 系统:核对它对「变更后的共享项」引用是否还成立 → 成立则状态回 定稿、刷 D 表;不成立则打回(回 iterate/concept,按打回规则再联动其下游)。
集成检查（每次必跑 —— 中观层(系统间组合)事后闸;组合点的事前设计在 concept)
准入 / 准出
- 准入:有系统状态变
定稿,或某共享项发生变更,或有 待重验 系统待核。
- 准出:全局规范收口 + 整体原型更新 + 实现总纲刷新 + 受影响系统已标
待重验 + 入选重验的 待重验 系统已结清(通过→定稿 / 不通过→打回)。
边界
只做项目层回写与一致性维护,不设计新系统(那是 concept/system)。
