建立人和 AI 共用的 Homelab 知识库及服务盘点

AGENTS.md

@@ -0,0 +1,17 @@
+# 人与 AI 共用的知识库
+
+先读 README.md，按任务从 services/index.md 和 architecture/constraints.md 查找资料，
+并检查 verification.md 中的相关冲突。不要求把整个仓库一次性放入上下文。
+
+- 正式知识写给人和 AI 共同阅读；本文件只放工作规则，不另存一份服务事实。
+- 以中文维护正文、commit、PR；配置键、命令和上游专有名称保留原文。
+- 区分设计、配置、部署记录与现场验证。没有访问现场，不得写“运行正常”。
+- 修改前读取对应源码 README/runbook，核实相关运行状态；发现冲突先记录，不能自行把计划升级为事实。
+- 新增服务同时补用途、入口、登录方式、第一次使用示例、依赖和故障入口。
+- 改变行为、入口、依赖、状态或恢复方法时，在同一任务更新对应文档与服务索引。
+- 跨仓库修改互相关联 commit/PR；未完成的文档同步明确记入 verification.md，不能宣称全部完成。
+- 架构约束变更必须明确说明旧规则、新规则和原因，不得静默删除约束来迁就实现。
+- 每项当前事实注明来源；last_verified 只在完成所述现场验证后更新，不随文字编辑刷新。
+- 凭据只记录取得方式和受管位置，不复制实际密码、token、私钥、state 或含敏感值的输出。
+- 不复制 apps/tailscale/helm.sh 的内容。迁移旧文档前先审查敏感内容，不能整库直接发布。
+- 遵守 CONTRIBUTING.md；不把临时检查日志和个人 agent memory 当成正式文档。