用途:为本地 AI 智能体运行环境(agent harness)配置 GitHub CLI(gh)认证,确保智能体能以受控、隔离的方式访问指定仓库。\n\n主要能力与用法:提供两种工作路径。一次性接线仓库(bootstrap):先阅读本技能目录下的 references/setup-protocol.md 了解密钥层级与 PAT 权限;在仓库根目录执行 bash .cursor/skills/verasic-github-env/scripts/bootstrap.sh(Cursor 中可用 /verasic-setup-github,或由 /verasic-init 代跑);用户自行创建 .github-agent.local 并写入 GH_TOKEN(切勿提交);随后运行 bash .cursor/skills/verasic-github-env/scripts/check-gh.sh 校验。运行时路径:执行任何 gh 命令前,若 GH_TOKEN 未设置,用 source .cursor/skills/verasic-github-env/scripts/load-gh-env.sh 加载凭据,且不执行 env 文件;自动检测失败时用 gh -R "${GH_REPO}"。\n\n脚本与安装根路径无关,未安装在 Cursor 根目录(如 .agents/skills/)时需调整前缀。完整规范以 references/setup-protocol.md 为准,不要在其他位置重复该规范。\n\n硬性规则:本地智能体用 .github-agent.local,CI 用 GitHub Actions,生产用密钥管理器,三类层级不得混用;每个仓库一个仅限该仓库的细粒度 PAT;智能体搭建不要使用 gh auth login 的设备码轮询流程,改用 GH_TOKEN。切勿记录或提交令牌,不要在智能体日志中直接运行裸 gh auth status,应改用 check-gh.sh。\n\n限制:安全与信任模型参见 references/scanner-notes.md 与上游 SECURITY.md;除上述流程外的其他部署细节暂未提供。
verasic-github-env
部署与运维
更新于 10-16 01:16