init: seed collective memory repo

This commit is contained in:
Memory Gateway Bot
2026-03-08 14:38:32 +08:00
commit 88d5d979fe
42 changed files with 569 additions and 0 deletions

46
AGENTS.md Normal file
View File

@@ -0,0 +1,46 @@
# AGENTS.md (memory-repo root)
## 1) 工作根路径
- 当前工作根路径 = 本文件所在目录(`memory-repo/`)。
- 智能体在该目录及其子目录内维护记忆文件。
- 禁止跨仓库写入其他记忆体根目录。
## 2) 目录类型
- 类型:`root`
## 3) 当前目录作用
- 定义整个记忆系统的全局规则与目录语义。
- 本地 Git 仓库负责写入。
- 远程 MCP/QMD 负责群体共享记忆权威查询。
- 本仓库应作为独立记忆仓库存在,例如 Gitea 上的 `collective-memory-repo`
- 当前 `qmd-docker-http-mcp` 代码仓库不是群体记忆真相源。
## 4) 查询规则
- 群体共享记忆查询必须走远程 MCP/QMD`memory.search/get/trace/status/list_lanes`)。
- 本地检索仅用于:未 push 草稿、远程故障降级、本地调试。
- 本地结果不是群体真相。
## 5) Git 工作规则(总则)
- 修改前:`git fetch --prune origin`,再 `git pull --rebase`
- 小步提交,一次提交只做一件事(建议 message 含 `task/agent/scope`)。
- 优先写自己的 `agents/<id>/`、当前 `tasks/<id>/``daily/`
- 避免同时修改公共长期文件与私有草稿。
- 冲突处理append-only 文件先保留原始记录,再人工提炼长期事实。
## 6) 可见性状态机
- `push 前`:本地记忆仅自己可见。
- `push 后但未索引`:记忆已提交但群体未可见。
- `远程 fetch + qmd update 后`:记忆群体可见。
- `群体召回`:只认远程 MCP 结果。
- `本地结果`:只认作个人草稿或 fallback。
## 7) Promote 规则
- 原始观察先落到 `daily/``tasks/<id>/``agents/<id>/`
- 稳定结论再 promote 到 `shared/long-term/`
- 不允许智能体直接把未验证草稿写入长期共享记忆。
## 8) 参考文档
- `policies/GIT-SOP.md`
- `policies/MEMORY-VISIBILITY.md`
- `policies/QUERY-POLICY.md`
- `policies/PROMOTION-POLICY.md`