用途：指导在 Tuist 生成的 Xcode 工作区中进行日常工作，包括生成工作区、用 xcodebuild 构建与测试，以及使用可构建文件夹等。
主要能力与用法： 生成：tuist generate --no-open 可在不打开 Xcode 的情况下生成工作区；也可按目标或标签限定范围，如 tuist generate tag:feature:payments、tuist generate PaymentsUI PaymentsTests。任何清单或依赖图变化后需重新生成；若因缺少产物生成失败，运行 tuist install 解析依赖后重试。 构建：xcodebuild build -workspace App.xcworkspace -scheme App，可加 -destination "generic/platform=iOS Simulator"。 测试：优先用 xcodebuild test 而非 tuist test，因为后者每次都会重新生成工程；用 --only-testing 只跑指定套件或用例，并选择包含所需测试目标且编译目标最少的 scheme。例如 xcodebuild test -workspace App.xcworkspace -scheme AppTests -only-testing AppTests/MyTestSuite 或 -only-testing AppTests/MyTestSuite/testMyFunction。
项目定义建议：优先使用 buildableFolders 代替 sources 与 resources 通配；它随文件系统同步，增删文件无需重新生成。可用 target 标签（tag:team:、tag:feature:、tag:layer:*）分组，便于限定生成与测试范围。保持项目与外部依赖的构建配置一致，可用 PackageSettings(settings: .settings(configurations: [])) 镜像配置，不一致会告警。
限制与注意：buildableFolders 路径需与目标真实目录一致，避免与 sources/resources 通配重叠。若用 --no-open 生成，需要时手动打开 Xcode。静态副作用警告需谨慎调整产品类型，本地目标用 Target.product、外部产品用 PackageSettings(productTypes:)，尽量用静态产品。Objective-C 依赖崩溃时按需在消费目标上通过 OTHER_LDFLAGS 添加 -ObjC 或 -force_load，参考 https://tuist.dev/en/docs/guides/features/projects/dependencies#objectivec-dependencies。