用途
setup-deploy 是一个「一次性部署配置」技能。根据其描述，它的职责是：检测部署平台、收集 URL 与健康检查（health check）相关信息，并将这些配置持久化写入 CLAUDE.md，以便未来的 land-and-deploy 运行直接复用。也就是说，它把部署环境的初始登记工作与后续的重复部署操作分离开来，避免每次部署都重新询问。
来源与归属
该技能引用上游文档：garrytan/gstack 仓库中的 setup-deploy/SKILL.md，指定修订版本为 f4bbfaa5bdfd2d6ce59541c2145432febde57fed，作者归属为 Garry Tan，许可证为 MIT。技能文档本身标注为从 SKILL.md.tmpl 自动生成，不应直接编辑，重新生成命令为 bun run gen:skill-docs。
运行约定（来自技能文档）
技能文档包含一段前置脚本（Preamble），在实际执行前运行，内容包括：检查 gstack 更新、创建与管理 ~/.gstack/sessions 会话文件、读取 gstack 配置（如 contributor、proactive、telemetry 等）、输出当前 git 分支、仓库模式（REPO_MODE）以及完整性介绍是否已读等状态。
若 PROACTIVE 为 "false"，则不主动建议 gstack 技能，仅在用户明确要求时调用。若检测到可用升级（UPGRADE_AVAILABLE），需读取 gstack-upgrade/SKILL.md 并按其内联升级流程处理。
交互与工作原则
文档规定所有 AskUserQuestion 调用需遵循固定结构：重新交代项目、分支与当前任务；用通俗语言简化说明问题；给出推荐项并标注完整性评分（Completeness）；提供带字母编号的选项，涉及工作量时同时给出人工团队与 CC+gstack 两种时间尺度。
文档还阐述了「Boil the Lake」完整性原则：在 AI 辅助下，完整实现的边际成本接近零，因此当完整方案与走捷径方案的差距不大时，应推荐完整方案。同时区分「湖」（可完成，如模块 100% 测试覆盖）与「海洋」（超出范围，如重写整个系统）。
仓库所有权模式
REPO_MODE 用于判断仓库问题的归属：solo 模式下由单一开发者主导，发现问题可主动修复；collaborative 模式下通过 AskUserQuestion 提示，由他人决定；unknown 则按 collaborative 处理。工作流中若发现异常，应以一句话简要标记，不静默放过。
其他机制
文档还包含「Search Before Building」知识分层原则、Eureka 时刻记录、贡献者模式的字段报告流程（写入 ~/.gstack/contributor-logs/，每次会话最多 3 份）、完成状态协议（DONE、DONE_WITH_CONCERNS、BLOCKED、NEEDS_CONTEXT）与升级机制，以及遥测日志（写入 ~/.gstack/analytics/）。
使用方式
资料给出的是技能文档中的 shell 片段与配置命令，例如 bun run gen:skill-docs 用于重新生成文档；遥测与贡献者相关设置通过 gstack-config set 命令调整。技能本身的具体调用方式、支持哪些部署平台、健康检查如何定义、URL 收集的交互流程等细节，资料中未提供。
适用场景与限制
适用场景：在使用 gstack 技能集合的 AI 编程环境中，首次为某个项目配置部署信息，供后续 land-and-deploy 复用。
限制与暂未提供的信息：具体的部署平台列表、健康检查的实现方式、CLAUDE.md 写入的具体字段格式、安装步骤、价格或收费方式，资料中均未提供，需以原始 SKILL.md 为准。
引用文档
以下为作者声明的引用来源，保留指定版本、署名和许可。
- garrytan/gstack/setup-deploy/SKILL.md — 署名：Garry Tan；许可：MIT；版本：
f4bbfaa5bdfd2d6ce59541c2145432febde57fed。