aigd-sync

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 表定稿时间(= 本次重验确认时间)——这是 待重验 状态唯一的出口,不补它该状态会永远悬在那。

配方

1. 系统定稿后:收编其枚举/号段到全局规范。
2. 把该系统并进整体原型(整合 demo)。
3. 刷新实现总纲(系统清单/建造顺序/契约位置/验收入口)。
4. 跑下行影响,分两类(各自反查不同列):
   • 点对点系统边(某系统的产出被另几个系统消费)变 → 反查 A 表「被依赖(下游)」,标那几个下游 待重验(记在 D 表)。
   • 广播型共享真源(枚举 / 文本结构 / id 命名空间,见 manifest F 表)变 → 向后兼容(纯追加)免重验;破坏性变更 → 反查 C 表「引用的共享真源」 找出列了它的系统(广播型真源不在 A 表「被依赖」里)→ 标这些系统 D 表 待重验,别炸全表。
5. 重验 待重验 系统:核对它对「变更后的共享项」引用是否还成立 → 成立则状态回 定稿、刷 D 表;不成立则打回(回 iterate/concept,按打回规则再联动其下游)。

集成检查（每次必跑 —— 中观层(系统间组合)事后闸;组合点的事前设计在 concept)

• 系统 A 产出的枚举,B 消费时字段对齐?
• A 的配置主键,在 B 的引用表里存在?
• A↔B 状态机有无死锁(A 等 B、B 等 A)?
• 核心循环(最小可玩闭环)所有系统都覆盖到? 任一不通过 → 标问题、回相关系统(必要时回 concept),并把结果写进 规范/全局集成验收.md。

准入 / 准出

• 准入:有系统状态变 定稿,或某共享项发生变更,或有 待重验 系统待核。
• 准出:全局规范收口 + 整体原型更新 + 实现总纲刷新 + 受影响系统已标 待重验 + 入选重验的 待重验 系统已结清(通过→定稿 / 不通过→打回)。

边界

只做项目层回写与一致性维护,不设计新系统(那是 concept/system)。