菜单
Use this skill when adding or refactoring Xstream core logic with TDD, including sync protocol serialization, encryption/decryption, and Packet Tunnel config guards. It provides a red-green-refactor workflow and a focused test matrix for stable core behavior.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use this skill before writing or reviewing any Flutter/Dart, Go FFI, or build-script code in the Xstream repo. It enforces non-negotiable product semantics, architecture rules, coding conventions, and App Store compliance constraints that apply to every change in this project. Always read this before suggesting API designs, UI copy, or implementation approaches.
Use this skill when managing Xstream release branches, applying GitHub branch protection rulesets, cherry-picking fixes onto production release lines, generating cross-repo release manifests, or verifying that release/* branches follow the no-force-push / linear-history policy. Apply at the start of any release cut, hotfix, or branch governance audit.
Run a repeatable iOS real-device smoke pass for Xstream after Packet Tunnel, Runner, signing, Flutter iOS bridge, or release build changes. Use when Codex needs executable verification on a connected iPhone for release build health, install, relaunch, device-side process presence, build/install/launch logs, sandbox readiness, and Runner plus PacketTunnel target health.
Verify Xstream functional baseline, UI interaction regression, and external browsing benchmarks on macOS after tunnel, proxy, Packet Tunnel, routing, build, menu, or runtime changes. Use when Codex needs to check whether Xstream is working end to end, confirm Tunnel Mode health, confirm Proxy Mode health, validate start/stop/reconnect/mode-switch behavior from the Home screen, Settings screen, and macOS status menu, validate external site readiness, validate release readiness, or debug regressions in System VPN, Packet Tunnel, local proxy ports, routing, or data-plane connectivity.
| name | xstream-core-tdd |
| description | Use this skill when adding or refactoring Xstream core logic with TDD, including sync protocol serialization, encryption/decryption, and Packet Tunnel config guards. It provides a red-green-refactor workflow and a focused test matrix for stable core behavior. |
Apply a strict Red -> Green -> Refactor loop for core logic that must stay stable across releases.
lib/services/sync/* protocol or crypto codelib/utils/tun_config_guard.dartflutter test test/sync/... or flutter test test/utils/...SyncCryptoSyncPayloadSyncRequest.toBytes() layout must remain stable.clientVersion byte-length limit must be enforced.parseSyncResponse() must correctly decode status/version/config/metadata.TunConfigGuardutunN interface fields in tun inbound must be removed.utunN values must be preserved.Detailed case list: references/test-cases.md.
flutter test passes for the touched test files.