AgentSkillsCN

upstream-sync

了解上游 Godot 同步对接口 SDK 的影响。适用于用户询问上游同步、分支更新,或 Godot 上游变更如何影响接口合约时使用。

SKILL.md
--- frontmatter
name: upstream-sync
description: Understand upstream Godot sync impact on the Interface SDK. Use when user asks about upstream sync, fork updates, or how Godot upstream changes affect the Interface contracts.

Upstream Sync Awareness — Phoenix Agentic Engine Interface

Context

This repo does NOT sync from upstream — it is an original project, not a fork.

However, upstream Godot syncs in the Engine repo can indirectly affect contract types:

Engine changeInterface impact
Godot scene/node API changesMay require new contract fields for Shadow Tree payloads
New tool types in GodotMay need new tool invoke contract schemas
Editor plugin changesNo direct impact

What to do after an Engine upstream sync

  1. Check if Backend updated api/schemas/ in response to the Engine sync
  2. If so, update golden fixtures in contracts/v1/ to match
  3. Run npm test and npm run typecheck to verify compatibility