trigger-linkage-rules

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）。

---

相关规范

• AGENT_RULES.md 第六节
• 06_全链路联动规则.md