用途:在 Home Assistant 及自托管基础设施发生变更后,保持相关文档同步,避免工作区指令、README、运行手册、仪表盘快捷方式或机器可读清单与实际运行状态脱节。
主要能力:先检查工作区,识别实际存在的文档表面,包括工作区级基础设施指令(如根 AGENTS.md 或等效策略文件)、受变更影响的仓库级指令文件、面向用户的 README 与架构文档、专用运行手册或操作基线文档、仪表盘/起始页/服务目录快捷方式,以及机器可读的基础设施清单或面向助手的快照。不会仅为满足清单而虚构不存在的表面。
使用方式:从相关主机、容器、compose 文件、服务 API 和仓库状态收集当前运行事实;确定主机角色、服务部署、URL、端口与存储的权威来源;共享拓扑变化时先更新工作区指令;仓库指令只保留不可自动发现的约束与适用范围门槛;将长流程移入专用运行手册;同步更新用户文档与快捷方式;刷新机器可读清单;对照运行状态验证引用并检查文档表面是否冲突;仅在明确授权且必要时,定向重载或重启相关文档/仪表盘服务。
指令质量规则:优先使用简短约束与检查清单而非叙述性手册;代理指令文件只保留高影响、不可自动发现的上下文;多范围指导需加适用范围门槛;避免在工作区与仓库层级重复同一策略;绝不发布凭据、令牌、私有地址、个人路径或仅限内部的操作细节。
仪表盘与快捷方式:优先使用稳定服务名称或公开 URL,而非原始私有 IP;保留现有分类与命名约定;只改受影响条目;定向重载前先验证仪表盘配置。
清单内容规则:保持高层规划导向,记录角色、关系与公开安全的服务标识;避免密钥、私有文件路径和逐步恢复命令;存在实时清单表面时,写入后验证渲染或 API 表示。
输出约定:始终报告变更的文件与表面及其用途、最终预期拓扑或服务部署、仪表盘或快捷方式变更(或无需变更)、运行手册内容是否移出代理指令、清单/快照验证状态(或该表面不存在)、已执行的运行验证及未解决的后续事项。
限制:仅适用于 Home Assistant 与自托管基础设施的文档同步场景;不包含具体平台、价格或效果承诺;相关命令与具体部署细节暂未提供。