sync-xcode-workspace-guidance

스타6

포크0

업데이트2026년 7월 23일 22:01

Sync guidance for an Apple .xcworkspace with Apps and Packages. Use to audit root guidance, app projects, local package wiring, XcodeGen settings, and service boundaries; not for one standalone .xcodeproj or package.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

출처

gaelic-ghost

gaelic-ghost/socket

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Sync Xcode Workspace Guidance

Purpose

Align the root guidance for a modular Apple workspace while preserving the separate owners of each app project and Swift package. scripts/run_workflow.py detects the shape, audits its composition, and adds the bounded workspace guidance section when needed.

Workflow

Use explore-apple-swift-docs before changing workflow policy. Prefer Xcode MCP, then Dash's usable XcodeGen : ProjectSpec archive.
Run scripts/run_workflow.py --repo-root <root> to inspect workspace, projects, packages, and optional services.
Confirm that the root contains one .xcworkspace, Apps/, and Packages/. Report missing or misplaced projects and packages; do not repair project membership by editing workspace or .pbxproj data directly.
Check each app's project.yml for a local packages declaration before claiming it consumes a Core package. Check the package's Package.swift for its real target and product graph.
For generated workspace projects, verify schemePathPrefix: "../" where workspace-relative scheme paths are used. Keep XcodeGen per-project: it does not become the workspace source of truth.
Route app-specific guidance to sync-xcode-project-guidance, package-specific guidance to sync-swift-package-guidance, and active execution to xcode-build-run-workflow or xcode-testing-workflow.
Keep optional services under Services/ as their own deployment and runtime boundary. Use the selected server skill for service-local policy.

Audit Contract

The runtime reports:

workspace and app-project paths;
package paths containing Package.swift;
project.yml paths;
optional service roots;
missing workspace, app-project, package, or marker-directory findings;
the root AGENTS.md action taken or planned.

It does not parse XcodeGen package declarations, classify topology, or change workspace membership, app target dependencies, package manifests, generated projects, or service code.

Guards And Handoffs

Stop when the root has no .xcworkspace, Apps/, or Packages/ marker.
Stop when the root is a single app project or package; use the narrower sync skill instead.
Do not mistake a navigator group, folder reference, or directory for a Swift package target.
Do not use cross-project references to replace local package products.
Do not hand-edit .pbxproj or workspace data. Make Xcode/XcodeGen-aware changes through the owner skill.

References

references/workspace-shape.md
assets/append-section.md

이 저장소의 다른 Skills

같은 저장소

app-intents-workflow

gaelic-ghost/socket

Design, implement, validate, and troubleshoot App Intents, App Entities, App Shortcuts, and system-surface integrations. Use when exposing a focused app action or content to Siri, Spotlight, Shortcuts, widgets, controls, Live Activities, or hardware interactions.

2026-07-236

appkit-app-architecture-workflow

gaelic-ghost/socket

Guide AppKit app-structure decisions for macOS apps across app delegates, status-item menu bar apps, responder-chain menus, windows, controllers, restoration, archiving, Observation, and mixed AppKit/SwiftUI composition. Use when the user wants help deciding where AppKit responsibilities belong or how to avoid steering a macOS app into SwiftUI-only structure when AppKit owns the behavior.

2026-07-236

apple-developer-provisioning-workflow

gaelic-ghost/socket

Plan and safely automate officially supported Apple Developer provisioning and CloudKit workflows through the App Store Connect REST API, Xcode-aware local discovery, cktool, and CKTool JS. Use when inspecting or changing bundle IDs, capabilities, certificates, devices, provisioning profiles, CloudKit schemas, or sandbox test data while keeping portal-only configuration, credentials, dry runs, and confirmation gates explicit.

2026-07-236

apple-image-representation-workflow

gaelic-ghost/socket

Guide Apple image decoding, encoding, metadata, thumbnails, multi-frame sources, and representation bridging across Image I/O, Core Graphics, AppKit NSImage and NSImageRep, UIKit UIImage, Core Image, and Core Video. Use when image work involves files, data, representations, orientation, scale, color, metadata, or conversion rather than pixel effects or visual recognition.

2026-07-236

apple-typography-workflow

gaelic-ghost/socket

Guide Apple platform typography decisions and implementation across SwiftUI Font, UIKit UIFont, AppKit NSFont, San Francisco system fonts, SF Pro, SF Compact, SF Mono, SF Pro Rounded, New York serif design, Dynamic Type, text styles, fontDesign, fontWeight, fontWidth, monospaced digits, custom font bundle integration, font licensing and redistribution boundaries, accessibility scaling, and Xcode font asset validation. Use when a task mentions Apple typography, San Francisco, SF Pro, SF Compact, SF Mono, New York, Dynamic Type, UIFontMetrics, preferredFont, NSFont.TextStyle, custom fonts, UIAppFonts, ATSApplicationFontsPath, or text style repair.

2026-07-236

apple-ui-accessibility-workflow

gaelic-ghost/socket

Guide Apple UI accessibility implementation and review for SwiftUI-first code, with UIKit and AppKit bridge guidance plus explicit verification expectations and testing handoffs. Use when the user wants help making Apple UI accessible, reviewing accessibility semantics, shaping the accessibility tree, or planning Apple-platform accessibility verification without collapsing the work into generic design review or Xcode test execution.

2026-07-236

name	sync-xcode-workspace-guidance
description	Sync guidance for an Apple .xcworkspace with Apps and Packages. Use to audit root guidance, app projects, local package wiring, XcodeGen settings, and service boundaries; not for one standalone .xcodeproj or package.

Sync Xcode Workspace Guidance

Purpose

Workflow

Use explore-apple-swift-docs before changing workflow policy. Prefer Xcode MCP, then Dash's usable XcodeGen : ProjectSpec archive.
Run scripts/run_workflow.py --repo-root <root> to inspect workspace, projects, packages, and optional services.
Confirm that the root contains one .xcworkspace, Apps/, and Packages/. Report missing or misplaced projects and packages; do not repair project membership by editing workspace or .pbxproj data directly.
Check each app's project.yml for a local packages declaration before claiming it consumes a Core package. Check the package's Package.swift for its real target and product graph.
For generated workspace projects, verify schemePathPrefix: "../" where workspace-relative scheme paths are used. Keep XcodeGen per-project: it does not become the workspace source of truth.
Route app-specific guidance to sync-xcode-project-guidance, package-specific guidance to sync-swift-package-guidance, and active execution to xcode-build-run-workflow or xcode-testing-workflow.
Keep optional services under Services/ as their own deployment and runtime boundary. Use the selected server skill for service-local policy.

Audit Contract

The runtime reports:

workspace and app-project paths;
package paths containing Package.swift;
project.yml paths;
optional service roots;
missing workspace, app-project, package, or marker-directory findings;
the root AGENTS.md action taken or planned.

It does not parse XcodeGen package declarations, classify topology, or change workspace membership, app target dependencies, package manifests, generated projects, or service code.

Guards And Handoffs

Stop when the root has no .xcworkspace, Apps/, or Packages/ marker.
Stop when the root is a single app project or package; use the narrower sync skill instead.
Do not mistake a navigator group, folder reference, or directory for a Swift package target.
Do not use cross-project references to replace local package products.
Do not hand-edit .pbxproj or workspace data. Make Xcode/XcodeGen-aware changes through the owner skill.

References

references/workspace-shape.md
assets/append-section.md