Fleet Maintenance 是一个面向多台 Mac 的机群维护技能,用于在保护本地未明确归属的工作的前提下,对 Mac 进行清点与日常维护。资料显示其维护对象为 Peter 的 Mac 机群,并明确允许在活跃会话期间执行软件包更新,但更新可能干扰正在被升级的软件。
用途与配置档 该技能维护两种配置档,除非明确更改模型,否则保持恰好两种:full 为日常主力 Mac,包含完整的开发、通信、媒体与智能体工具集;worker 为精简的远程 Mac,主要运行 Codex、Claude、OpenClaw 节点及配套智能体基础设施。配置档策略被视为最低要求:安装必需条目,报告多余条目但不移除,且绝不把观察到的软件静默转为期望状态。期望软件与本地账户托管引用读取自 ~/Projects/manager/fleet/inventory.json,修改其 schema 或采纳软件包前需阅读 references/fleet-schema.md。拓扑、SSH 路由与交接状态保存在 ~/Projects/manager/computers.yaml,不在本技能中重复。
主要能力 技能包含多项审计与修复脚本:agent-skill-links-audit.sh 审计 agent 技能镜像,其 --repair 仅在两个规范仓库都存在时触发广泛规范同步;global-gitignore-audit.sh 审计共享全局 Git ignore,--repair 会创建 ~/.config/git/ignore 并保留无关条目;claude-attribution-audit.sh 审计 ~/.claude/settings.json,--repair 在保留无关设置的同时禁用提交尾注、PR 页脚与远程会话链接;agent-cli-audit.sh 审计官方 Codex 与 Claude Code CLI 的版本及非交互认证,--live 用于有界、无工具、非持久的模型回合;octopool-audit.sh 证明非交互与登录 zsh 均通过 Octopool shim 解析 gh,并检查客户端登录身份元数据与池身份健康;op-profile-audit.sh 审计 1Password CLI 完整性基线,--cli-only 用于 token 豁免主机。
使用方式 技能提供确定性的 profile 工具,通过 node 运行:collect 采集快照;plan 结合 fleet 清单与主机快照生成计划;diff 比较源与目标快照;brewfile 为指定主机渲染 Brewfile;validate 校验 fleet 清单。采集器快照属于观察证据而非配置,应存放在 ~/Projects/manager/fleet/snapshots/<host-id>.json。运行顺序为:解析主机配置档、采集观察清单、执行包归属预检、同步合格仓库、更新 Homebrew 与全局 npm、验证 macOS 轨道、通过 $xcode-sync 同步 Xcode、按需清空废纸篓、重新审计磁盘/工具/包归属/仓库/内存/关键服务。
安全契约与限制 安全契约要求读取 computers.yaml,使用实时 Tailscale 状态并按硬件 UUID 去重,排除已交接与未知机器;并行审计主机,但一次只变更一台主机;每次仓库或 Xcode 变更前立即复查 agent 活动。跳过有用户进程 cwd 位于其中或存在 Git 锁的仓库。常规维护中绝不 reset、clean、stash、rebase、切换分支、删除本地工作、push、安装 macOS 更新或重启。不可达主机视为 pending 而非 current。绝不使用 pull 或 merge 作为冲突解决器,绝不传递 --autostash、创建 stash、丢弃更改或暂存文件。Homebrew 更新允许在 agent/服务运行时进行,但需接受混合旧内存代码与新文件的风险,且绝不手动终止或重启服务。全局 npm 更新指注册表支持的顶层全局包,不改变仓库的 package.json 或 lockfile。macOS 轨道维护不切换轨道、不安装更新、不重启,仅准备精确更新并在确认无活跃 agent/服务且备份与磁盘状态充足后请求维护窗口。Xcode 工作统一调用 $xcode-sync,不重复其安装逻辑。密码、恢复密钥与私钥保存在 1Password,清单仅存不透明条目 ID。
适用场景 适用于需要统一维护多台 Mac 的开发或运维环境,尤其是同时存在日常主力机与远程工作机的机群,涉及软件包一致性、账户安全基线、仓库同步、CLI 工具版本与认证、GitHub 缓存以及 Xcode 轨道管理等场景。
限制 资料未提供该技能的收费、价格、平台支持范围、具体效果指标或完整安装步骤;部分脚本行为与修复条件依赖外部文档(如 references/fleet-schema.md、~/Projects/manager/docs/fleet-setup.md)与外部技能($remote-mac、$xcode-sync、$one-password、$anthropic、$npm),这些内容在给定资料中未完整展开。