| name | ost-open-gsd-gsd-core-install |
| description | 帮助用户安装或更新 GSD Core runtime 配置。主路径：运行支持包内的一键脚本；脚本不可用或用户需要 native/manual 路径时回退到 repo_readme_summary.md 第 2 部分。范围：运行官方 npx 安装器并提示验证方式，不含安装 Node.js、Codex CLI 或运行 GSD 项目工作流。 |
| argument-hint | 至少一个 runtime flag，如 --claude 或 --codex；可选 scope：--local、--global、--location=local、--location=global |
GSD Core 安装（skill_for_setup）
参考：repo_readme_summary.md
脚本：scripts_for_install/install.sh
官方仓库：open-gsd/gsd-core
When to Use
当用户希望安装、更新或配置 GSD Core 到 Claude Code、Codex CLI 或其他官方支持 runtime 时使用本 Skill。典型触发包括：
- "安装 GSD Core"
- "给 Claude Code 配置 GSD Core"
- "给 Codex CLI 安装 open-gsd/gsd-core"
- "更新 GSD Core runtime 配置"
Pre-read
../../repo_readme_summary.md — 安装方式、平台限制、验证命令和官方替代路径../../scripts_for_install/install.sh — 实际支持的参数、检查逻辑和脚本边界../../.ost-refs/ 目录（如存在）— 本地约定
Pre-checks
从对话上下文中确认：
| 信息 | 默认值 | 说明 |
|---|
| 操作系统 | 无 | 主路径只支持 macOS、Linux、WSL；Windows native shell 走兜底路径 |
| Runtime | 无 | 必须至少选择一个 runtime flag，例如 --claude 或 --codex |
| Scope | --local | 可改为 --global；--all 必须配合 --global |
| 自定义配置目录 | 无 | 如需使用 CLAUDE_CONFIG_DIR、GEMINI_CONFIG_DIR 等环境变量，运行脚本前由用户明确指定 |
| Codex CLI 版本 | 脚本检查 | 仅选择 --codex 时需要 Codex CLI >= 0.130.0 |
如果 runtime 或 scope 不明确，先向用户确认。不要在未确认 runtime 的情况下运行安装脚本。
Procedure
主路径：运行一键脚本（macOS / Linux / WSL）
从支持包根目录（本 SKILL.md 向上两级）执行：
sh scripts_for_install/install.sh [runtime flags] [scope]
常用示例：
sh scripts_for_install/install.sh --claude --local
sh scripts_for_install/install.sh --codex --local
sh scripts_for_install/install.sh --claude --codex --global
sh scripts_for_install/install.sh --all --global
脚本会执行平台检查、Node.js/npm/npx 版本检查、Codex CLI 版本检查（仅 --codex），然后调用官方 @opengsd/gsd-core 安装器。脚本执行前会打印摘要，执行后会打印验证方式。
兜底路径：参考 repo_readme_summary.md
遇到以下情况时，转为按 repo_readme_summary.md 第 2 部分（安装与更新） 逐步执行：
- 用户处于 Windows native shell，不能或不想使用 WSL / Git Bash 运行脚本
- 用户要求官方交互式安装、Claude native plugin、Gemini native extension、无 Node.js 机器复制输出目录或手动转换源文件
- 脚本报错且错误不属于可直接补充参数的情况
- 用户需要对官方安装命令逐条确认或手动控制
将第 2 部分中对应路径的安装命令发给用户确认后逐条运行，不要猜测未写明的转换规则。
验证
安装完成后，提示用户重启目标 runtime，然后运行对应命令：
/gsd-new-project
Codex CLI 使用：
$gsd-new-project
命令被识别并开始询问项目问题，即代表安装成功。
安装完成后告知用户
GSD Core 安装器已执行完成。请重启目标 runtime 后运行对应验证命令：
Claude Code / Copilot / OpenCode / Kilo / Cline 等：/gsd-new-project
Gemini CLI：/gsd:new-project
Codex：$gsd-new-project
命令被识别并开始询问项目问题，即代表安装成功。
Troubleshooting
| 现象 | 原因 | 处理 |
|---|
| 未指定 runtime 时脚本报错 | 脚本不运行交互式安装，必须显式选择 runtime | 追加 --claude、--codex 或其他 runtime flag 后重试 |
--all 报 scope 错误 | 官方摘要只给出 --all --global | 改用 --all --global，或选择单个 runtime |
| Node.js / npm 版本不满足要求 | GSD Core 要求 Node.js >= 22.0.0、npm >= 10.0.0 | 先升级 Node.js / npm，再重新运行脚本 |
--codex 时 Codex CLI 检查失败 | Codex runtime 需要 Codex CLI >= 0.130.0 | 先安装或升级 Codex CLI，再重新运行脚本 |
| Windows native shell 报不支持 | 脚本只支持 macOS、Linux、WSL | 改用 WSL / Git Bash，或按 repo_readme_summary.md 第 2 部分执行官方路径 |
| 安装后命令不识别 | 目标 runtime 尚未重启或配置未加载 | 重启目标 runtime；Codex 可重启或运行 codex --reload |
