用途:为本地 AI 代理运行环境配置 GitHub CLI(gh)认证,把凭据写入被 gitignore 的 .github-agent.local 文件,配合 direnv 加载,并用脚本验证。适用于在本仓库(如 Cursor 安装根目录下)一次性接入 gh 的场景。
主要能力:提供 bootstrap.sh 引导脚本;提供 load-gh-env.sh,在 GH_TOKEN 未设置时加载凭据(不执行 env 文件);提供 check-gh.sh 做验证;references/setup-protocol.md 说明密钥分层与 PAT 权限。
使用方式:从仓库根目录运行 bash .cursor/skills/verasic-github-cli-init/scripts/bootstrap.sh;在 Cursor 中也可用 /verasic-github-cli-init 或由 /verasic-init 触发。随后创建细粒度 PAT(https://github.com/settings/tokens?type=beta,仅限本仓库),把 .github-agent.local.example 复制为 .github-agent.local,设置 GH_TOKEN 并 chmod 600。使用 direnv 时执行 direnv allow。用 bash .cursor/skills/verasic-github-cli-init/scripts/check-gh.sh 验证。运行时若 GH_TOKEN 未设置,先 source .cursor/skills/verasic-github-cli-init/scripts/load-gh-env.sh;gh 自动检测失败时使用 -R "${GH_REPO}"。安装在其他位置(如 .agents/skills/)时调整路径前缀,脚本本身与安装根目录无关。
限制与规则:不要用 gh auth login 的设备流轮询循环做 harness 初始化;不要打印或提交 token 值;不要在对话或代理日志中运行裸 gh auth status,改用 check-gh.sh。凭据分层不得混用:本地代理用 .github-agent.local,CI 用 GitHub Actions,生产用 secrets manager。每个仓库一个仅限该仓库的细粒度 PAT。安全性说明见 references/scanner-notes.md 与上游 SECURITY.md。具体 PAT 推荐权限、收费与平台细节资料未提供。