메뉴
帮助用户安装或更新 GSD Core runtime 配置。主路径：运行支持包内的一键脚本；脚本不可用或用户需要 native/manual 路径时回退到 repo_readme_summary.md 第 2 部分。范围：运行官方 npx 安装器并提示验证方式，不含安装 Node.js、Codex CLI 或运行 GSD 项目工作流。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Fix npm global install failures for @openai/codex when ENOTEMPTY rename conflicts occur in the global node_modules path.
Write skill_for_setup/SKILL.md and skill_for_setup/README.md for any open-source library in the open_supports/ system. Use after scripts_for_install/ is complete. Implements the script-first pattern: primary path runs the install script; fallback follows repo_readme_summary.md Part 2.
Use when creating or updating an open_supports support package end-to-end, especially when coordinating repo summary, install script, setup skill, clarification, resume, or optional install verification.
帮助用户安装并配置 OpenSpec。主路径：运行支持包内的一键脚本；脚本不可用时回退到 repo_readme_summary.md 第 2 部分。范围：安装/更新 CLI、验证版本、可选初始化或更新项目；不含卸载、删除生成文件或详细使用教程。
Write scripts_for_install/install.sh for any open-source library in the open_supports/ system. Use when adding a new support package that needs a one-click installation script. Produces a POSIX sh script with platform detection, flag-driven interface, and idempotent behavior.
Write repo_readme_summary.md for any open-source library in the open_supports/ system. Use when adding a new support package or updating an existing summary. Produces a concise 5-part structured document distilled from the official README.
| 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 |
参考：
repo_readme_summary.md
脚本：scripts_for_install/install.sh
官方仓库：open-gsd/gsd-core
当用户希望安装、更新或配置 GSD Core 到 Claude Code、Codex CLI 或其他官方支持 runtime 时使用本 Skill。典型触发包括：
../../repo_readme_summary.md — 安装方式、平台限制、验证命令和官方替代路径../../scripts_for_install/install.sh — 实际支持的参数、检查逻辑和脚本边界../../.ost-refs/ 目录（如存在）— 本地约定从对话上下文中确认：
| 信息 | 默认值 | 说明 |
|---|---|---|
| 操作系统 | 无 | 主路径只支持 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 的情况下运行安装脚本。
从支持包根目录（本 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 第 2 部分（安装与更新） 逐步执行：
将第 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
命令被识别并开始询问项目问题，即代表安装成功。
| 现象 | 原因 | 处理 |
|---|---|---|
| 未指定 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 |