GInstall OneClick — GitHub 安装器

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

触发时机

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

前提条件

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

操作流程

1. 标准化 URL —— 支持 owner/repo、owner/repo@branch、完整 github.com URL，以及单体仓库专用的 /tree// 格式。
2. 密钥处理 —— 若访问私有仓库，或在 fetch/clone 过程中返回 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 → 将完整 tree URL 用双引号包裹后传入 ginstall ""。

3. 自动化场景： 用户希望在 CI 中静默执行、无需任何交互提示 →
   ginstall "owner/repo" --yes --mode assisted --env-mode scan

上游 CLI

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

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