zhaozr815 GitHub + Skills 一键就绪
帮助用户在当前电脑完成：gh 登录 → 从 GitHub 拉取个人 Skills → 安装到 ~/.cursor/skills/。
事实：同一 Cursor 账号不会自动同步个人 Skills；必须靠 GitHub（或手动拷贝）。
触发后立即执行
按顺序做，能自动的不要只口述：
- 读 manifest.md 确认要安装的 skill 列表与仓库。
- 检查环境并修复缺口（见下方检查清单）。
- 需要用户授权时：打印一次性验证码 +
https://github.com/login/device，等用户说「好了」再继续。 - 运行本目录
scripts/bootstrap.ps1（Windows）或scripts/bootstrap.sh（macOS/Linux）。 - 验证：
~/.cursor/skills/<name>/SKILL.md存在；gh auth status显示已登录。 - 用 3～5 行告诉用户结果与下次换电脑怎么说/怎么跑。
检查清单
| 检查 | 通过标准 | 失败时 |
|---|---|---|
gh 已安装 |
gh --version |
Windows: winget install --id GitHub.cli -e；macOS: brew install gh |
| 已登录 GitHub | gh auth status 含 Logged in |
gh auth login -h github.com -p https -w（设备码流程） |
| 网络可达 | gh api user --jq .login 有用户名 |
换网络/代理后重试；OAuth 超时则建议用户建 PAT（repo）后 gh auth login --with-token |
| Skills 已安装 | manifest 中每项在 ~/.cursor/skills/ |
执行 bootstrap 脚本 |
Windows 注意
- 新装
gh后刷新 PATH：$env:Path = "$env:ProgramFiles\GitHub CLI;" + $env:Path - 设备码换 Token 若超时：再开一次
gh auth login -w，用户授权后立刻检测，勿假定浏览器点完就已登录。
设备码登录（Agent 操作要点）
# 启动后立刻读输出，把 code 发给用户
gh auth login -h github.com -p https -w
对用户只说两件事：打开 https://github.com/login/device ，输入验证码 XXXX-XXXX。用户回复「好了」后再跑 gh auth status；若仍未登录，说明是换 Token 失败，重开登录或改用 PAT。
新电脑「零 Skill」冷启动
本 Skill 尚未装上时，让用户先跑（收藏这一条即可）：
# Windows PowerShell
irm https://raw.githubusercontent.com/zhaozr815/cursor-skills/main/scripts/bootstrap.ps1 | iex
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/zhaozr815/cursor-skills/main/scripts/bootstrap.sh | bash
脚本会：必要时提示安装/登录 gh，克隆本仓库，把各 skill 拷进 ~/.cursor/skills/（含本 setup skill 与周报 skill）。
之后用户只需对 Agent 说：「同步我的 skills」或「连接 GitHub」。
日常同步（已装过）
优先执行：
& "$env:USERPROFILE\.cursor\skills\github-skills-setup\scripts\bootstrap.ps1"
或在仓库目录：.\scripts\bootstrap.ps1 -SyncOnly
行为：git pull 各源 → 覆盖安装到 ~/.cursor/skills/（不删用户自建、不在 manifest 里的 skill）。
对用户说明（简短）
- 换电脑：浏览器收藏 bootstrap 链接，或说「安装我的 Cursor skills」。
- 登录一次
gh后，同步一般不再要完整 OAuth（Token 在本机 keyring）。 - 不要把 Skill 放进
~/.cursor/skills-cursor/（系统目录）。
相关文件
- 清单：manifest.md
- 脚本：
scripts/bootstrap.ps1、scripts/bootstrap.sh