47 lines
1.9 KiB
Markdown
47 lines
1.9 KiB
Markdown
# 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`
|