用途：把 nangongwentian-fe/Awesome-GlobalRule 仓库中的 Agent 规则体系同步到本地两个 AI 编程工具的全局配置目录。用户说“同步规则”“同步 global rule”“检查规则更新”“更新 agent rules”“sync global rules”“规则有没有更新”“拉取最新规则”时触发。
同步映射：AGENTS.md 写入 ~/.claude/CLAUDE.md 和 ~/.codex/AGENTS.md；docs/agent-rules/ 下 11 个文件写入 ~/.claude/docs/agent-rules/ 与 ~/.codex/docs/agent-rules/。上次同步的 commit SHA 记录在 ~/.claude/.sync_state.json，检查时只需对比 SHA。
用法：检查更新执行 bash ~/.claude/skills/sync-global-rules/scripts/check_updates.sh，退出码 0 且输出 updates-available: 表示有更新，退出码 1 且输出 up-to-date: 表示已最新，退出码 2 且输出 ERROR: 表示环境问题。完整同步执行 bash ~/.claude/skills/sync-global-rules/scripts/sync.sh，脚本会对比 SHA、在 ~/.claude/backups/<timestamp>/ 备份、下载文件并更新状态文件。强制同步加 --force，预览模式加 --dry-run。标准顺序为先 check_updates.sh，有更新再运行 sync.sh 并汇报 SHA、备份路径与文件数量。
前提：gh CLI 已安装并登录（gh auth status），python3 可用，对 ~/.claude/ 和 ~/.codex/ 有写权限。
限制：同步会覆盖现有规则文件；备份仅保存主规则文件（CLAUDE.md 和 AGENTS.md），docs 目录文件不备份；如存在本地个人化修改（如语言偏好），同步后需手动追加。