init: seed collective memory repo
This commit is contained in:
46
AGENTS.md
Normal file
46
AGENTS.md
Normal 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`
|
||||
Reference in New Issue
Block a user