name: trigger-linkage-rules description: 指导 AI 正确执行跨项目联动通知。当任务涉及①公理体系变动、②体系结构变动、TF变动、分身数据格式变动、产品设计变动时触发。对应 AGENT_RULES.md 第六节和 06_全链路联动规则.md。
跨项目联动规则触发技能
当任务涉及以下任一变动时，必须按此技能执行联动通知。
第一步：判断触发场景
| 发生的变动 | 对应场景 | 通知对象 | 强制？ |
|---|---|---|---|
| ①公理体系变动 | A + B | ②体系结构 + ③沙盘验证 | ✅ 强制 |
| ②体系结构变动（已通过①③验证） | G | TF 技术框架 | ✅ 强制 |
| ②变动且影响 Bᵢ/Agent State | K | ④⑤分身系统 | ✅ 强制 |
| 产品设计（PD）变动 | H | ②评估 → TF → TEST | ✅ 强制（不可跳流程） |
| TF 发布新版本（含 Breaking Change） | I + N | 所有 APP_n + ④⑤ | ✅ 强制通知 |
| APP_n 发现底座 Bug | J | TF 修复 → 所有 APP | ✅ 强制 |
| ④⑤分身数据格式变动 | L | 消费分身数据的 APP_n | ✅ 强制 + 迁移脚本 |
| APP_n 需要 TF 新能力 | M | TF 的 PD 评估 | ✅ 强制走需求单 |
第二步：创建联动通知 Issue
在受影响仓库创建 Issue，标签：linkage-notice
通知格式模板：
## 联动通知 [场景X] - 来自 [触发源仓库]
**触发日期**：YYYY-MM-DD
**触发场景**：X（如：G - 体系结构变动）
**触发源**：[触发变动的仓库/文档名称]
**变动版本**：vX.X.X
### 变动概述
（1-3 句话描述核心变动内容）
### 需要你做什么
（明确说明受影响方需要进行的评估或操作）
### 截止时间
- Breaking Change：5 个工作日内完成评估
- Non-breaking：14 个工作日内完成评估
### 参考文档
- 变更记录：[CHANGELOG.md 链接]
- 详细说明：[相关文档链接]
第三步：在任务日志中记录联动状态
在 任务日志.md 的「联动触发记录」中追加：
| 触发场景 | 通知对象 | 通知日期 | 响应状态 |
|---------|---------|---------|---------|
| 场景G | TF技术框架 | YYYY-MM-DD | 🔲 待响应 |
场景 H（产品设计变动）专项流程
产品设计变动不能直接推给 TF，必须先走评估：
PD 变动
↓
评估：是否需要改②体系结构？
├── 不需要 → 直接进入 TF 功能层改动
└── 需要 → ②变动流程（公理验证 + 沙盘验证）
↓ 通过后
触发场景 G（TF 架构合规层）
评估判断标准（任一为"是"则需改②）：
- 是否需要引入新的状态持有者（粒子层面）？
- 是否需要修改现有事件路径（emit→route→apply）？
- 是否需要改变粒子间耦合方式？
- 是否需要新增/修改写权所有者？
Breaking Change 预告期规则
确认 Breaking Change
↓
当前版本发布 Deprecation Notice（代码 + CHANGELOG 标记 ⚠ Deprecated）
↓
保留至少一个中间版本（deprecated 但仍可用）
↓
下下个版本正式移除（发布 Breaking Change）
- 轻量 Breaking Change：跳过 1 个版本后删除
- 重大 Breaking Change：提前 2 个版本公告
完整场景速查
详见 _内部总控/开发规范/06_全链路联动规则.md 第十八节「完整场景速查矩阵」（场景 A–P）。