---
name: cross-project-coordinator
description: 跨项目并行开发协调框架创建 Skill。当启动涉及2个或以上子项目并行开发时激活：收集项目清单，生成标准协调框架文档（项目地图/API契约/并行轨道/Day 1清单）。触发词：「多项目并行」「建协调框架」「几个项目同时做」「分工要明确」「并行开发」「各自独立启动」「RULE-37」。与元项目导航的区别：元项目导航是轻量指针文档，本Skill生成可操作的协调框架（含API契约和并行轨道）。
---

# 跨项目并行开发协调框架创建（cross-project-coordinator）

> RULE-37 的执行层落地：把「必须建协调框架」的规则转化为「如何一步步建」的操作流程。

---

## 触发判断

**触发条件**（满足任一即触发）：
- 用户提到同时要推进 2 个或以上子项目
- 不同子项目存在 API 调用关系（A 调用 B 的接口）
- 多名开发者分别负责不同子项目

**触发判断示例**：
- ✅「我们要同时做 twin-engine 后端和 tashan-world 前端」→ 触发
- ✅「后端开发者和前端开发者今天各自开工」→ 触发
- ❌「我要做 A 功能，做完再做 B 功能」（顺序不并行）→ 不触发
- ❌「帮我更新某个 Skill」→ 不触发

---

## 激活后立即执行

```
Step 0  确认触发
        问用户（或从上下文推断）：
        「本次并行开发涉及哪些子项目？每个项目大致做什么？」
        收集：项目名称列表 + 每个项目的一句话职责描述

Step 1  检查元项目导航
        Read: _内部总控/元项目导航.md
        → 确认各子项目是否已在导航中（未登记的需同步更新）
        → 获取各子项目的产品定义.md 和技术架构.md 路径

Step 2  检查是否已有协调框架文档
        检查 _内部总控/ 目录下是否已有 [生态名]_跨项目协调框架.md
        
        已有 → 读取现有文档，判断是否需要追加更新（新增项目/新接口）
        未有 → 执行 Step 3-6 全量创建

Step 3  生成「项目地图」（第一章）
        对每个子项目输出：
        - 职责：做什么（一句话）+ 不做什么（边界声明）
        - 部署位置：服务器 + 端口
        - 格式：ASCII 表格或 mermaid 图

Step 4  生成「跨项目 API 契约」（第二章）
        对每一对存在调用关系的项目对（A→B）：
        
        接口已定义时：
          列出端点 + HTTP方法 + 路径 + 关键请求/响应字段 + 鉴权方式
        
        接口未定义时（❗关卡A发现的问题，修复：先输出占位符）：
          「⚠️ [端点名] — 接口待定义，建议由 [项目A] 技术架构师填写」
          留占位符行，不留空白
        
        必须包含错误码规范（见模板格式）

Step 5  生成「并行开发轨道」（第三章）
        并行判断规则：
        - 两个工作包之间没有共享的「输出 → 输入」依赖 → 可并行
        - 例：后端 API 定义完成后，前端才能开始联调 → 串行约束
        
        用时间轴格式输出：
        - 轨道A：[项目A的工作]（可立刻开始/依赖X完成后开始）
        - 轨道B：[项目B的工作]（同上）
        - 阻塞关系：明确列出「A的X完成前，B的Y无法开始」

Step 6  生成「各项目启动前提清单」（第四章）
        对每个子项目开发者的 Day 1 清单：
        ✅ 已就绪的文档（列路径）
        🔲 缺失的文档（标注谁负责/何时完成）
        ✅ 可以先 mock 开始的工作（说明 mock 约定）

Step 7  保存文档
        路径：_内部总控/[生态名称]_跨项目协调框架.md
        
        关系声明（写在文档头部）：
        「关系类型：implements → _内部总控/AGENT_RULES.md RULE-37」
        
        同步更新 元项目导航.md：
        - 在「跨项目并行协调文档」行补充本文档路径

Step 8  触发 F-022 挑战者反思（高依赖度文档必做）
        以「消费方开发者」和「接口破坏者」双视角检查：
        1. API 契约是否完整（每个接口都有错误码规范？）
        2. 并行轨道依赖关系是否漏写？
        3. 有没有"循环依赖"（A等B，B等A）？
        
        发现问题 → 立即修复再输出
```

---

## 文档模板（保存时使用）

```markdown
# [生态名] · 跨项目并行开发协调框架

> 关系类型：implements → _内部总控/AGENT_RULES.md RULE-37
> 创建日期：YYYY-MM-DD
> 维护规则：任何跨项目 API 变更，必须先更新本文档，再通知消费方

## 一、项目地图
[项目地图内容]

## 二、跨项目 API 契约
[API 契约内容]

**错误码规范**：
| 状态码 | 含义 | 前端行为 |
| 400 | 请求格式错误 | 显示具体字段错误 |
| 401 | 未认证 | 跳转登录页 |
| 403 | 无权限 | 提示无权操作 |
| 404 | 资源不存在 | 显示友好提示 |
| 429 | Rate Limit | 禁用按钮N秒 |
| 5xx | 服务器错误 | 通用错误提示 |

**Mock 数据约定**：
- Mock 文件位置：[前端项目]/src/mocks/[被调用服务]/
- 格式：与 API 契约返回字段完全一致的 JSON fixture

## 三、并行开发轨道
[轨道内容]

## 四、各项目启动前提清单
[清单内容]

## 五、接口变更通知规则
任何一方变更跨项目接口时：
1. 先更新本文档
2. 在对方项目追踪台创建 P1 问题
3. 任务日志标注「跨项目接口变更」

## 六、变更记录
| 日期 | 变更 | 触发原因 |
```

---

## 与其他 Skill 的关系

| 关系 | Skill/Rule |
|---|---|
| 基于此规则触发 | `_内部总控/AGENT_RULES.md` RULE-37 |
| 更新后通知 | `元项目导航.md` 跨项目协调文档引用 |
| 接口变更时更新 | `deploy-arch-maintenance.mdc` RULE-22 |

---

## 变更记录

### v1.0 — 2026-03-21 — 初始创建

**根因**：RULE-37 填补了「必须建协调框架」的规范空白，但缺少「如何建」的操作步骤。
今日手动创建了认知协作生态_跨项目协调框架.md，没有可重复使用的步骤规范。

**经验核心**：
- 关卡A 发现：触发条件需要明确判断标准（并行 vs 顺序）
- 关卡A 发现：接口未定义时输出占位符而非空白
- Step 8 F-022 是强制步骤（高依赖度文档必做）

**验证状态**：🔵 待验证（下次多项目并行启动时验证）