用途：在配置 NixOS 系统时提供规则与检查清单，重点解决 flakes 结构、Home Manager 与 overlay 作用域、多主机配置组织，以及重建后包变更不生效等常见问题。
主要能力：给出 overlay 作用域决策矩阵，说明 useGlobalPkgs=true 时 overlay 必须定义在 NixOS 配置层的 home-manager.nixpkgs.overlays，写在 home.nix 的 nixpkgs.overlays 会被忽略；useGlobalPkgs=false 时则影响用户包。提供 flakes 结构、主机组织、包安装、常见错误与系统化调试等规则文件（overlay-scope、flakes-structure、host-organization、package-installation、common-mistakes、troubleshooting），并附完整 AGENTS.md。
使用方式：修改配置前先阅读对应规则文件与 common-mistakes.md、troubleshooting.md，遵循代码库既有模式；按需查阅各规则文件中的错误与正确示例。
适用场景：使用 flakes 与 Home Manager 配置 NixOS、overlay 不生效、useGlobalPkgs=true 搭配自定义 overlay、多主机配置、重建后包未更新。
限制：不用于打包新软件、无 overlay 的简单安装或 NixOS 模块开发；具体命令与版本细节资料未提供。