sync-global-rules

将 GitHub 仓库 nangongwentian-fe/Awesome-GlobalRule 中的 Agent 规则体系同步到本地两个 AI 工具的全局配置目录。

同步映射

仓库来源	Claude Code 目标	Codex 目标
AGENTS.md	~/.claude/CLAUDE.md	~/.codex/AGENTS.md
docs/agent-rules/* (11 个文件)	~/.claude/docs/agent-rules/	~/.codex/docs/agent-rules/

状态追踪

上次同步信息保存在 ~/.claude/.sync_state.json，包含已同步的 commit SHA。 这样每次检查时只需对比 SHA，不用下载全部内容。

工作流程

场景一：检查是否有更新（推荐先执行）

bash ~/.claude/skills/sync-global-rules/scripts/check_updates.sh

输出解读：

• 退出码 0 + 输出以 updates-available: 开头 → 有新版本，执行同步
• 退出码 1 + 输出以 up-to-date: 开头 → 已是最新，无需操作
• 退出码 2 + 输出 ERROR: → 环境问题（gh 未安装或未登录）

场景二：执行完整同步

有更新时（或用户明确要求同步时）：

bash ~/.claude/skills/sync-global-rules/scripts/sync.sh

脚本会自动：

1. 检查远程 SHA 与本地记录的 SHA
2. 在 ~/.claude/backups/<timestamp>/ 自动备份现有文件
3. 下载所有文件并写入两个目标目录
4. 更新 ~/.claude/.sync_state.json

场景三：强制同步（即使 SHA 一致）

bash ~/.claude/skills/sync-global-rules/scripts/sync.sh --force

场景四：预览模式（不写入文件）

bash ~/.claude/skills/sync-global-rules/scripts/sync.sh --dry-run

标准执行顺序

当用户触发此 skill 时，按以下顺序执行：

1. 运行 check_updates.sh
2. 解读输出：
   • 有更新 → 告知用户"发现新版本："，询问是否同步（或直接同步，视用户指令）
   • 已最新 → 告知用户"当前已是最新（SHA: <short_sha>，上次同步: ）"，结束
   • 错误 → 告知用户具体错误并给出修复建议
3. 有更新时，运行 sync.sh
4. 汇报同步结果（SHA、备份路径、文件数量）

前提条件

• gh CLI 已安装且已登录（gh auth status）
• python3 可用
• 对 ~/.claude/ 和 ~/.codex/ 有写权限

注意事项

• 同步会覆盖现有规则文件，但 每次同步前都会自动备份（保存于 ~/.claude/backups/）
• 备份仅保存主规则文件（CLAUDE.md 和 AGENTS.md），docs 目录文件不备份（可从 GitHub 恢复）
• 如用户有本地个人化修改（如语言偏好等），同步后需手动追加