nbl.install-rules

Install Rules Skill

从 GitHub 仓库 icefrag/nbl-superpowers 的 rules/ 目录安装所有规则文件到本地 ~/.claude/rules/，存在则覆盖。

执行流程

1. 获取远程文件列表

调用 GitHub API 获取仓库文件树：

curl -s "https://api.github.com/repos/icefrag/nbl-superpowers/git/trees/main?recursive=1"

从返回的 JSON 中筛选 rules/ 目录下的文件：

• path 以 rules/ 开头
• type 为 blob
• 收集所有匹配的文件路径

2. 逐个下载并写入文件

对每个匹配的文件，通过 GitHub Contents API 获取内容并解码写入：

注意：禁止使用 raw.githubusercontent.com，该域名在 Windows Schannel 下会因 SSL 重协商失败。

对每个文件执行以下命令（将 {path} 替换为文件路径如 rules/common/architecture.md，{relative_path} 替换为 rules/ 之后的部分如 common/architecture.md）：

curl -s "https://api.github.com/repos/icefrag/nbl-superpowers/contents/{path}" | python -c "import json,sys,base64,os; d=json.load(sys.stdin); p=os.path.expanduser('~/.claude/rules/{relative_path}'); os.makedirs(os.path.dirname(p),exist_ok=True); open(p,'wb').write(base64.b64decode(d['content'])); print('OK: {relative_path} (' + str(d['size']) + ' bytes)')"

写入规则：

• 目标路径：~/.claude/rules/{相对路径}
• 自动创建不存在的子目录
• 已存在的文件直接覆盖

3. 输出同步报告

向用户展示同步结果：

# Rules Sync Report

## Synced
- rules/common/architecture.md (updated)
- rules/common/coding-conventions.md (updated)
- rules/common/naming.md (new)
...

## Summary
Total: X files synced (Y updated, Z new)

错误处理

• API 限流：GitHub API 匿名请求限制 60 次/小时。如遇 403 响应，提示用户稍后重试或配置 GITHUB_TOKEN 环境变量
• 网络异常：如 curl 失败，报告具体错误并中止，不写入不完整的文件
• 空响应：如 rules/ 目录下无文件，提示用户确认仓库路径是否正确