zrr1999 SSH Fleet
Goal
维护一个私有、可 diff、严格校验的设备事实源；生成配置只是可审阅输出。完成时说明使用的 inventory 路径、涉及的设备名、做过的校验，以及哪些连接、应用、信任、提交或推送动作没有获得授权而保持未执行。
需要字段定义或 TOML 示例时读取 references/device-schema.md。
Resolve the fact source
按以下优先级解析根目录：
- 用户明确给出的路径；
SSH_FLEET_ROOT；~/workspace/zrr1999/fleet-config。
根目录内只有两个权威事实面：
devices.toml：活动设备、连接能力与地址来源；trust/known_hosts：经过独立渠道核验的 SSH host key。
生成的 ~/.ssh/config、Ansible inventory、DNS manager JSON、hosts 文件和命令输出都不是事实源。不要在别处维护第二份设备清单。
Authorization boundaries
把动作拆开，不用一个许可推导另一个许可。这里的领域边界优先于通用 Git/PR skill 的默认交付：其他 skill 可以执行本节已经允许的 Git 动作，但不能据其默认规则新增 commit、push、apply、连接或信任权限。
- 本地读取和审计：可检查 inventory、生成器代码、Git 状态、现有 SSH 配置和
ssh -G解析结果；不连接设备。 - 编辑 inventory：用户要求新增、修改、迁移或退役设备时，才修改
devices.toml。这不授权连接或应用生成文件。 - 信任更新：只有用户要求新增或轮换 host key，且指纹已通过独立可信渠道核验时，才修改
trust/known_hosts。ssh-keyscan只能采集候选 key，不能单独建立信任。 - 远程连接：只有用户明确要求连接、调查或操作目标设备时才执行 SSH；先解析精确 alias、目标与信任状态，不用
StrictHostKeyChecking=no绕过缺口。 - 应用生成配置：只有用户明确要求 apply 时，才把已审阅输出写入 live 路径。render 或 diff 不等于 apply。
- Git 提交和推送：分别需要用户请求；编辑完成不自动 commit，commit 完成不自动 push。
任何阶段都不得输出或提交私钥、密码、token、agent socket、.env、临时命令输出或未筛选的密钥材料。
Inspect before change
- 确认根目录是预期的 private Git 仓库，并检查 branch、upstream、dirty/untracked 状态；保留用户已有改动。
- 读取完整
devices.toml和与目标相关的known_hosts行，确认设备name、hostname、group 和引用关系。 - 检查本机
auto-config --help、validate --help与render --help；精确 CLI 语法以当前版本为准。 - 若用户只要求审计或设计，到这里保持只读；不要顺带修复、连接或应用。
Add or update a device
- 使用稳定的
name；hostname、地址、操作系统或用途变化时不要改名。name同时是生成的 OpenSSHHostalias。 group只表示一个主运维边界。只有生成器确实需要筛选时才添加tags，不要恢复roles、Ansible aliases 或多个布尔角色字段。- 只写存在的能力：不可 SSH 的设备省略
ssh，没有受管地址的设备省略addresses。默认端口22和forward_agent = false不重复写。 - 先完成整文件编辑，再运行严格校验。重复 name、未知字段、非法地址或域名、坏引用必须让整个操作失败；不能跳过单台设备继续。
- render 到
mktemp -d或仓库忽略的目录，审阅全部输出。对受影响 alias 使用ssh -G -F <rendered-ssh-config> <name>验证解析；这个命令不建立网络连接。 - 报告 diff 和验证结果。没有 apply 授权时停在这里。
Retire a device
从活动 devices.toml 删除完整记录；Git 历史承担审计，不为简单 active/retired 状态保留 lifecycle 字段。然后严格校验和 render，确认所有预期输出都移除该设备。
不要因为删除设备记录就自动删除分支、DNS 记录、live SSH 配置、远端账号或 trust/known_hosts 条目。每种外部状态由对应 apply/远程/信任动作单独授权和验证。
Trust changes
新增或轮换 host key 时记录精确 hostname 与 key 类型，核对是否存在 hashed、带端口或旧算法形式。通过控制台、设备管理面、供应商面板或另一个已信任通道比对 fingerprint 后再编辑 trust/known_hosts。
若只能获得 ssh-keyscan 结果，保存为临时候选并报告待核验 fingerprint；不要提交为已信任 key，也不要通过关闭检查来连接。轮换时保留变更前后的证据和受影响 alias，避免把连接劫持误认为正常换钥。
Apply and verify
获得 apply 授权后，也只应用刚刚严格校验和审阅的 render 结果。应用前再次确认目标路径、现有文件来源和备份/回滚方式；使用原子替换，保持 SSH 配置权限，并避免覆盖不属于 auto-config 的手写 block。
应用后先运行语法和展开检查，再在用户已授权连接时做真实连接验证。ssh -G 成功只证明配置解析，不证明网络、凭据或 host key 正确。
Output
更新类请求报告：事实源、设备 name、字段变化、整文件校验、render 目录、受影响输出与 ssh -G 结果。审计类请求报告：现状、风险和建议，不制造改动。明确列出未执行的远程连接、live apply、trust 变更、commit 和 push。