用途：在多个 Swift Package 仓库中创建、更新并维护一份统一的 AGENTS.md，适合需要批量同步代理说明文件的开发与自动化场景。
主要能力：以本技能中的 assets/AGENTS.md 为默认基线，或通过 --canonical 指定其他来源；用 --repo 处理单个仓库，用 --root 递归发现含 Package.swift 的仓库；未指定时默认扫描 ~/Workspace。--check 为只读漂移检测，省略则应用更新。扫描时跳过 .git、.* 隐藏目录、.build、.swiftpm、node_modules 及 Xcode 生成的 .xcworkspace、.xcodeproj、DerivedData 等目录。
使用方式：运行 scripts/sync_agents_md.sh [--canonical <path>] (--repo <path> | --root <path>) [--check] [--verbose]。检查模式报告漂移并在存在差异时以非零状态退出；应用模式在每个发现的 Swift 包仓库创建或更新 AGENTS.md。完成后汇总已扫描、未变更、已更新仓库数与漂移数。自动化模板见 references/automation-prompts.md。
定制：先执行 uv run python scripts/customization_config.py effective 读取当前有效设置，参照 references/customization-flow.md 逐项确认，再用 uv run python scripts/customization_config.py apply --input <yaml-file> 持久化，配置保存于 ~/.config/gaelic-ghost/apple-dev-skills/<skill-name>/customization.yaml，可用 APPLE_DEV_SKILLS_CONFIG_HOME 覆盖根目录，reset 可清除。
限制：基线文件缺失时应停止并请求有效文件；--root 下无 Package.swift 时无仓库可处理；写入受权限限制时需改用有权限的工作区路径或经批准提权。适用平台、费用与具体效果暂未提供。