用途：为新建 Swift Package Manager 仓库提供单一入口的脚手架，遵循简洁优先的 Swift 基线。运行入口为 scripts/run_workflow.py，核心实现为 scripts/bootstrap_swift_package.sh，负责脚手架创建与校验。
适用场景：新建 Swift 包；需要一致的包默认设置、生成 AGENTS.md 并立即校验；或想自定义未来运行的引导默认值。不适合作为 Xcode 应用常规协作的默认路径。已有 Xcode 项目或引导后需 Apple 平台执行时，建议改用 apple-xcode-workflow；需要 Dash 文档集搜索、安装或生成时建议 apple-dash-docsets。
输入与默认值：name 必填，必须以字母开头，仅含字母、数字、_ 或 -。type 为 library、executable 或高级显式 tool；destination 默认 .；platform 默认 multiplatform；version_profile 默认 current-minus-one；testing_mode 默认 swift-testing；validation 默认执行，除非传入 --skip-validation。别名由脚本规范化：macos→mac，ios→mobile，both→multiplatform，latest→latest-major，minus-one→current-minus-one，minus-two→current-minus-two。
使用方式：先收集输入，再运行 scripts/run_workflow.py，由包装器加载自定义状态中的默认值并归一化为 JSON 契约，随后调用：scripts/bootstrap_swift_package.sh --name <Name> --type <library|executable|tool> --destination <dir> --platform <mac|macos|mobile|ios|multiplatform|both> --version-profile <latest-major|current-minus-one|current-minus-two|latest|minus-one|minus-two> --testing-mode <swift-testing|xctest>。创建后校验 Package.swift、.git、AGENTS.md、Tests/，并执行 swift build 与 swift test（除非 --skip-validation）。测试模式须在创建前选定：工具链需不低于 Swift 5.10，支持的当前工具链优先 swift-testing，显式要求或工具链需要时用 xctest。返回包含创建路径、归一化选项与校验结果的 JSON 摘要。
限制与停止条件：缺少 swift、无法解析 swift --version、工具链低于 5.10、缺少 git、缺少 assets/AGENTS.md、目标目录存在不可忽略文件、缺少 name、或活动 swift package init 无法满足所需测试模式时，均以 blocked 终止。状态包括 success、blocked、failed；path_type 有 primary 与 fallback。脚本不可用或用户明确要求时才用手动 swift package init 路径；tool 为高级显式透传，非默认分支。普通包工作优先用 swift build 与 swift test；需要 Xcode 管理的 SDK 或工具链行为时改用 apple-xcode-workflow。
自定义与参考：参考 references/customization-flow.md，scripts/customization_config.py 存储并报告自定义状态，脚本尊重包装器的 git 与 AGENTS.md 复制标志。官方资料未提供具体收费、价格或平台支持信息。