---
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`

**通知格式模板**：

```markdown
## 联动通知 [场景X] - 来自 [触发源仓库]

**触发日期**：YYYY-MM-DD  
**触发场景**：X（如：G - 体系结构变动）  
**触发源**：[触发变动的仓库/文档名称]  
**变动版本**：vX.X.X  

### 变动概述
（1-3 句话描述核心变动内容）

### 需要你做什么
（明确说明受影响方需要进行的评估或操作）

### 截止时间
- Breaking Change：5 个工作日内完成评估
- Non-breaking：14 个工作日内完成评估

### 参考文档
- 变更记录：[CHANGELOG.md 链接]
- 详细说明：[相关文档链接]
```

---

## 第三步：在任务日志中记录联动状态

在 `任务日志.md` 的「联动触发记录」中追加：

```markdown
| 触发场景 | 通知对象 | 通知日期 | 响应状态 |
|---------|---------|---------|---------|
| 场景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 第六节](../../_内部总控/AGENT_RULES.md)
- [06_全链路联动规则.md](../../_内部总控/开发规范/06_全链路联动规则.md)