GInstall OneClick — GitHub 安装器

您协助用户运行 GInstall OneClick（ginstall）—— 一个命令行工具（CLI），可对 GitHub 项目（通常为 Node.js 项目）执行一键安装：生成执行计划、克隆仓库、安装依赖，并启动面向开发的脚本。

触发时机

• 用户粘贴了 owner/repo 格式字符串、完整的 github.com URL，或单体仓库（monorepo）的 /tree// URL。
• 用户提出类似“安装这个仓库”、“克隆并运行 dev”等请求，或使用含 /ginstall 风格的表述。

前提条件

• ginstall 已安装并位于系统 PATH 中（请从上游 GInstall / GInstall OneClick CLI 项目安装）。
• node 和 git 均已安装并位于 PATH 中（已在技能元数据中声明）。

执行流程

1. 标准化 URL — 支持 owner/repo、owner/repo@branch、完整 github.com URL，以及单体仓库专用的 /tree// 格式。
2. 密钥处理 — 若访问私有仓库，或在获取/克隆过程中返回 401/403/404 错误，请提示用户设置环境变量 GITHUB_TOKEN（最低权限需包含 contents:read），然后重试。切勿将 token 粘贴至聊天窗口，亦不可将其写入共享的 plan 文件中。
3. 以引号包裹仓库 URL 运行 ginstall — 推荐如下方式：

ginstall "" --mode guided --env-mode scan

CI / 非交互式场景：

ginstall "" --yes --mode assisted --env-mode scan

仅生成计划（不执行）：

ginstall "" --mode manual --env-mode plan

4. 运行完成后 — 引导用户查阅 CLI 输出中打印的计划 Markdown 文件路径与报告文件路径。

参数参考

校验要点

• 生成的计划应包含 clone、install、run 步骤，且 workingDir 设置正确（单体仓库场景下需匹配子路径 subpath）。
• 若检测到 engines.node 版本不匹配，或存在如 sharp 等需原生工具链（native toolchain）支持的包，应予以警告。

使用示例（ClawHub）

1. 交互式场景：用户说：“用 GInstall 在本地安装 https://github.com/microsoft/TypeScript。” → 执行
   ginstall "https://github.com/microsoft/TypeScript" --mode guided --env-mode scan

2. 单体仓库场景：用户提供 https://github.com/org/mono/tree/main/packages/app → 在 ginstall "" 中完整引用该 tree URL。

3. 自动化场景：用户希望在 CI 中无提示运行 →
   ginstall "owner/repo" --yes --mode assisted --env-mode scan

上游 CLI

本文件仅为 OpenClaw 技能 定义。请从 GInstall OneClick CLI 仓库安装或构建 ginstall：

https://github.com/YunzhouLi-hub/GInstall-OneClick