init: seed collective memory repo

AGENTS.md

@@ -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`

MEMORY.md

@@ -0,0 +1,23 @@
+# MEMORY.md
+
+## 系统定义
+- 写入通道：本地 Git 记忆仓库。
+- 权威查询通道：远程 MCP/QMD。
+- 本地检索角色：草稿与故障降级。
+
+## 目录索引
+- `shared/long-term/`：长期共享记忆（durable facts）。
+- `agents/<agent-id>/`：智能体私域工作记忆。
+- `tasks/<task-id>/`：任务级共享记忆。
+- `daily/`：append-only 原始观察。
+- `policies/`：统一策略与 SOP。
+
+## 记忆生命周期
+1. capture：原始事实写入 `daily/` 或 `tasks/` 或 `agents/`。
+2. review：在任务上下文验证和去重。
+3. promote：沉淀稳定结论到 `shared/long-term/`。
+4. recall：群体召回仅通过远程 MCP/QMD。
+
+## 群体查询准则
+- 所有群体结论必须可追溯到：`branch + commit_hash + synced_at + source_path + scope`。
+- 查询一致性顺序固定：`sync git -> qmd update/embed -> query`。

SOUL.md

@@ -0,0 +1,5 @@
+# SOUL.md (Optional OpenClaw Compatibility)
+
+本文件为可选兼容层，不是系统必需规范。
+请以 `AGENTS.md` 为唯一通用必读文件。
+本文件内容与根 `AGENTS.md` 保持一致。

USER.md

@@ -0,0 +1,4 @@
+# USER.md (Optional OpenClaw Compatibility)
+
+本文件为可选兼容层，不是系统必需规范。
+系统规则与操作边界请以根 `AGENTS.md` 为准。

agents/AGENTS.md

@@ -0,0 +1,28 @@
+# AGENTS.md (agents)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/agents/`）。
+
+## 目录类型
+- 类型：`shared-agent-space`。
+
+## 目录作用
+- 承载各智能体私域目录：`agents/<agent-id>/`。
+
+## 查询规则
+- 群体查询必须走远程 MCP/QMD。
+- 本地检索仅草稿/fallback。
+
+## Git 规则
+- 每个智能体优先只改自己的子目录。
+- 先同步再提交，小步提交。
+
+## 可见性状态机
+- push 前：本地可见。
+- push 后未索引：群体不可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅草稿/fallback。
+
+## Promote 规则
+- 稳定结论通过 task/promote 进入 long-term。

agents/agent-a/AGENT-CARD.md

@@ -0,0 +1,7 @@
+# AGENT-CARD: agent-a
+
+- agent_id: `agent-a`
+- default_lane: `agent`
+- writable_scope: `agents/agent-a/**`
+- promote_target: `shared/long-term/**`
+- query_authority: `remote MCP/QMD only`

agents/agent-a/AGENTS.md

@@ -0,0 +1,33 @@
+# AGENTS.md (agents/agent-a)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/agents/agent-a/`）。
+- 智能体仅在该目录维护自己的工作记忆。
+- 不得跨目录修改其他智能体私域目录。
+
+## 目录类型
+- 类型：`agent`。
+
+## 目录作用
+- 智能体私域工作记忆：收件、当前上下文、草稿。
+
+## 查询规则
+- 群体共享记忆查询必须走远程 MCP/QMD。
+- 本地检索仅用于未 push 草稿、故障降级和本地调试。
+
+## Git 规则
+- 修改前先 `git fetch --prune origin`，再 `git pull --rebase`。
+- 先写 `inbox.md/current.md/drafts/`，再按需要 promote。
+- 小步提交，避免与长期共享记忆同提交混改。
+- 冲突优先保留 append-only 原始记录。
+
+## 可见性状态机
+- push 前：仅自己可见。
+- push 后未索引：已提交未群体可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅作草稿/fallback。
+
+## Promote 规则
+- 个人观察先记在当前目录。
+- 稳定结论通过 task 或 promote 流程进入 `shared/long-term/`。

agents/agent-a/current.md

@@ -0,0 +1,3 @@
+# current
+
+当前任务上下文与短期计划。

agents/agent-a/inbox.md

@@ -0,0 +1,3 @@
+# inbox
+
+- [ ] 待整理观察记录

agents/agent-b/AGENT-CARD.md

@@ -0,0 +1,7 @@
+# AGENT-CARD: agent-b
+
+- agent_id: `agent-b`
+- default_lane: `agent`
+- writable_scope: `agents/agent-b/**`
+- promote_target: `shared/long-term/**`
+- query_authority: `remote MCP/QMD only`

agents/agent-b/AGENTS.md

@@ -0,0 +1,30 @@
+# AGENTS.md (agents/agent-b)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/agents/agent-b/`）。
+
+## 目录类型
+- 类型：`agent`。
+
+## 目录作用
+- `agent-b` 的私域工作记忆目录。
+
+## 查询规则
+- 群体查询只认远程 MCP/QMD。
+- 本地检索仅草稿/fallback。
+
+## Git 规则
+- 先同步（fetch + pull --rebase）再修改。
+- 小步提交，不跨目录乱改。
+- 冲突时先保留原始记录，后人工整理。
+
+## 可见性状态机
+- push 前：本地可见。
+- push 后未索引：群体不可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅草稿/fallback。
+
+## Promote 规则
+- 原始观察在 agent/task/daily。
+- 稳定事实 promote 到 long-term。

agents/agent-b/current.md

@@ -0,0 +1,3 @@
+# current
+
+当前上下文。

agents/agent-b/inbox.md

@@ -0,0 +1,3 @@
+# inbox
+
+- [ ] 待办输入

daily/2026-03-08.md

@@ -0,0 +1,3 @@
+# 2026-03-08
+
+- 原始观察：系统完成远程权威查询链路验证。

daily/2026-03-09.md

@@ -0,0 +1,3 @@
+# 2026-03-09
+
+- 原始观察：任务记忆与长期记忆目录分离完成。

daily/AGENTS.md

@@ -0,0 +1,28 @@
+# AGENTS.md (daily)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/daily/`）。
+
+## 目录类型
+- 类型：`daily`。
+
+## 目录作用
+- 原始日记/观察记录，默认 append-only。
+
+## 查询规则
+- 群体查询只认远程 MCP/QMD。
+- 本地查询仅草稿/fallback。
+
+## Git 规则
+- 每天一个文件，追加写入为主。
+- 不把 daily 直接当长期真相，需 promote。
+
+## 可见性状态机
+- push 前：仅本地可见。
+- push 后未索引：群体不可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅草稿/fallback。
+
+## Promote 规则
+- daily 里的稳定事实必须提炼后写入 `shared/long-term/`。

policies/GIT-SOP.md

@@ -0,0 +1,35 @@
+# GIT-SOP
+
+## 目标
+- 降低冲突。
+- 保证“先同步再提交”。
+- 避免长期共享记忆被多人同时频繁改写。
+- 保证 task/agent/daily 记录优先 append-only。
+- 建立稳定的 promote 流程。
+
+## 标准流程
+1. 修改前同步
+- `git fetch --prune origin`
+- `git pull --rebase`
+- 确认当前分支与远端一致。
+
+2. 写入阶段
+- 优先写私域和过程态目录：`agents/<id>/`、`tasks/<id>/`、`daily/`。
+- 原始观察不直接进入 `shared/long-term/`。
+
+3. 提交阶段
+- 小步提交，一次提交只做一类修改。
+- commit message 建议包含 `task:<id> agent:<id> scope:<lane>`。
+
+4. push 后语义
+- push 仅表示“已提交到远端”，不代表群体立即可见。
+- 必须等待远程服务完成 `fetch + qmd update`。
+
+5. promote 阶段
+- 仅把稳定事实从 `task/agent/daily` 提炼至 `shared/long-term/`。
+- promote 提交应附来源路径与证据引用。
+
+## 冲突处理
+- `daily/RUNLOG/inbox`：按 append-only 思路合并。
+- `shared/long-term/*`：禁止自动粗暴合并，必须人工审阅。
+- 无法确认语义一致时，先保留原始记录，再单独提交整理。

policies/MEMORY-VISIBILITY.md

@@ -0,0 +1,22 @@
+# MEMORY-VISIBILITY
+
+## 可见性状态机
+1. push 前
+- 本地记忆仅写入者可见。
+
+2. push 后但未索引
+- 内容已在远端 Git，但远程 MCP/QMD 尚未完成索引。
+- 群体查询不可将其视为已可见。
+
+3. 远程 fetch + qmd update 后
+- 该 commit 进入远程索引。
+- 群体查询可见。
+
+4. 群体召回
+- 只认远程 MCP 返回结果。
+
+5. 本地结果
+- 仅作个人草稿或 fallback。
+
+## 可追溯字段
+- 每次查询返回必须包含：`branch`、`commit_hash`、`synced_at`、`source_path`、`scope`。

policies/PROMOTION-POLICY.md

@@ -0,0 +1,24 @@
+# PROMOTION-POLICY
+
+## 目标
+- 将过程态信息提炼为长期稳定记忆。
+
+## 输入来源
+- `daily/`
+- `tasks/<task-id>/`
+- `agents/<agent-id>/`
+
+## promote 判定条件
+- 事实可复核，有来源证据。
+- 内容跨任务可复用。
+- 语义稳定，不依赖临时上下文。
+
+## promote 输出
+- `shared/long-term/projects/`
+- `shared/long-term/lessons/`
+- `shared/long-term/decisions/`
+
+## promote 提交要求
+- 说明来源：原始文件路径和时间。
+- 说明结论：提炼后的稳定事实。
+- 说明范围：适用项目/任务/角色。

policies/QUERY-POLICY.md

@@ -0,0 +1,21 @@
+# QUERY-POLICY
+
+## 双通道模型
+- 写入：本地 Git。
+- 群体查询：远程 MCP/QMD（权威）。
+- 本地检索：仅草稿/fallback。
+
+## 远程查询工具
+- `memory.search`
+- `memory.get`
+- `memory.trace`
+- `memory.status`
+- `memory.list_lanes`
+
+## lane 规则
+- 支持 lane：`task`、`agent`、`shared-long-term`、`daily`。
+- 默认优先级：`task > agent > shared-long-term > daily`。
+
+## 禁止项
+- 禁止将任意机器本地索引当作群体真相。
+- 禁止把本地未 push 内容当作群体共享记忆。

shared/AGENTS.md

@@ -0,0 +1,30 @@
+# AGENTS.md (shared)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/shared/`）。
+
+## 目录类型
+- 类型：`shared`。
+
+## 目录作用
+- 承载群体可共享记忆区域。
+- 长期真相目录在 `shared/long-term/`，并有更严格写入规则。
+
+## 查询规则
+- 群体查询必须走远程 MCP/QMD。
+- 本地检索仅作草稿/fallback，不得作为共享真相来源。
+
+## Git 规则
+- 先同步再编辑：`git fetch && git pull --rebase`。
+- 非 promote 场景不直接编辑 `shared/long-term/`。
+- 冲突优先保留证据链，再做受控整理。
+
+## 可见性状态机
+- push 前：仅本地可见。
+- push 后未索引：已提交未群体可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅作草稿/fallback。
+
+## Promote 规则
+- 仅从 `daily/ tasks/ agents/` 经过提炼后进入 `shared/long-term/`。

shared/long-term/AGENTS.md

@@ -0,0 +1,31 @@
+# AGENTS.md (shared/long-term)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/shared/long-term/`）。
+
+## 目录类型
+- 类型：`long-term`。
+
+## 目录作用
+- 存放 durable facts、稳定项目知识、经验教训与已确认决策。
+
+## 查询规则
+- 该目录是群体长期记忆来源之一，但权威查询仍必须通过远程 MCP/QMD。
+- 本地读取结果只能作草稿或故障降级参考。
+
+## Git 规则
+- 修改前必须先同步：`git fetch --prune` + `git pull --rebase`。
+- 禁止并发大规模改动长期共享文件。
+- 仅允许 promote 提炼写入，不直接搬运未经验证原始记录。
+- 冲突不自动乱合并，必须人工/受控逻辑处理。
+
+## 可见性状态机
+- push 前：本地可见。
+- push 后未索引：已提交未群体可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅作草稿/fallback。
+
+## Promote 规则
+- 原始记录先在 `daily/ tasks/ agents/`。
+- 稳定事实再写入 `projects/ lessons/ decisions/`。

tasks/AGENTS.md

@@ -0,0 +1,29 @@
+# AGENTS.md (tasks)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/tasks/`）。
+
+## 目录类型
+- 类型：`shared-task-space`。
+
+## 目录作用
+- 承载任务级共享记忆目录：`tasks/<task-id>/`。
+
+## 查询规则
+- 群体查询必须走远程 MCP/QMD。
+- 本地检索仅草稿/fallback。
+
+## Git 规则
+- 先同步再写入。
+- task 目录优先 append-only 记录过程。
+- 长期结论必须 promote 到 `shared/long-term/`。
+
+## 可见性状态机
+- push 前：本地可见。
+- push 后未索引：群体不可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅草稿/fallback。
+
+## Promote 规则
+- 任务结论沉淀到长期目录时必须附来源路径与提交信息。

tasks/task-001/AGENTS.md

@@ -0,0 +1,31 @@
+# AGENTS.md (tasks/task-001)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/tasks/task-001/`）。
+
+## 目录类型
+- 类型：`task`。
+
+## 目录作用
+- 任务级共享工作记忆，记录任务上下文、过程与决策。
+- 与长期共享记忆区别：任务目录偏过程态，长期目录偏稳定态。
+
+## 查询规则
+- 群体查询必须走远程 MCP/QMD。
+- 本地检索仅用于草稿/fallback。
+
+## Git 规则
+- 先同步再修改：`git fetch` + `git pull --rebase`。
+- 优先 append 到 `RUNLOG.md` 和 `DECISIONS.md`。
+- 单次提交只做一类变更，不混入长期共享改动。
+- 冲突采用 append-only 合并思路，最终人工归档。
+
+## 可见性状态机
+- push 前：仅本地可见。
+- push 后未索引：已提交未群体可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅草稿/fallback。
+
+## Promote 规则
+- 任务结论经验证后，提炼并 promote 到 `shared/long-term/`。

tasks/task-001/DECISIONS.md

@@ -0,0 +1,3 @@
+# DECISIONS
+
+- 待补充。

tasks/task-001/LINKS.md

@@ -0,0 +1,3 @@
+# LINKS
+
+- 相关文档与证据链接。

tasks/task-001/RUNLOG.md

@@ -0,0 +1,3 @@
+# RUNLOG
+
+- 2026-03-08: 初始化任务记录。

tasks/task-001/TASK.md

@@ -0,0 +1,7 @@
+# TASK-001
+
+## Goal
+- 示例任务目标。
+
+## Scope
+- 明确输入与输出边界。

tasks/task-002/AGENTS.md

@@ -0,0 +1,29 @@
+# AGENTS.md (tasks/task-002)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/tasks/task-002/`）。
+
+## 目录类型
+- 类型：`task`。
+
+## 目录作用
+- `task-002` 的共享任务记忆空间。
+
+## 查询规则
+- 群体查询仅通过远程 MCP/QMD。
+- 本地检索只用于草稿/fallback。
+
+## Git 规则
+- 修改前先同步远端。
+- 小步提交、避免跨目录乱改。
+- 冲突先保留原始记录后手工整理。
+
+## 可见性状态机
+- push 前：本地可见。
+- push 后未索引：群体不可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅草稿/fallback。
+
+## Promote 规则
+- 稳定结论 promote 到 `shared/long-term/`。

tasks/task-002/DECISIONS.md

@@ -0,0 +1,3 @@
+# DECISIONS
+
+- 待补充。

tasks/task-002/LINKS.md

@@ -0,0 +1,3 @@
+# LINKS
+
+- 相关链接。

tasks/task-002/RUNLOG.md

@@ -0,0 +1,3 @@
+# RUNLOG
+
+- 2026-03-09: 初始化任务记录。

tasks/task-002/TASK.md

@@ -0,0 +1,4 @@
+# TASK-002
+
+## Goal
+- 示例任务目标。

templates/AGENT-CARD.md.template

@@ -0,0 +1,6 @@
+# AGENT-CARD: <agent-id>
+
+- agent_id: `<agent-id>`
+- writable_scope: `agents/<agent-id>/**`
+- query_authority: `remote MCP/QMD`
+- promote_target: `shared/long-term/**`

templates/AGENTS.md.template

@@ -0,0 +1,31 @@
+# AGENTS.md
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录。
+
+## 目录类型
+- `<root|shared|long-term|agent|task|daily>`
+
+## 目录作用
+- `<填写本目录负责的记忆范围>`
+
+## 查询规则
+- 群体共享记忆查询必须走远程 MCP/QMD。
+- 本地检索仅用于未 push 草稿、故障降级、本地调试。
+
+## Git 规则
+- 修改前：`git fetch --prune origin` + `git pull --rebase`。
+- 小步提交，一次提交只做一件事。
+- 避免跨目录乱改。
+- 冲突优先保留 append-only 原始记录，再人工整理长期事实。
+
+## 可见性状态机
+- push 前：本地仅自己可见。
+- push 后但未索引：已提交但群体未可见。
+- 远程 fetch + qmd update 后：群体可见。
+- 群体召回：只认远程 MCP。
+- 本地结果：只认作草稿/fallback。
+
+## Promote 规则
+- 原始观察 -> `daily/task/agent`
+- 稳定结论 -> `shared/long-term`

templates/MEMORY.md.template

@@ -0,0 +1,12 @@
+# MEMORY.md
+
+## System
+- 写入通道：本地 Git。
+- 查询通道：远程 MCP/QMD（权威）。
+- 本地检索：草稿/fallback。
+
+## Lanes
+- task > agent > shared-long-term > daily
+
+## Traceability
+- branch + commit_hash + synced_at + source_path + scope

templates/TASK.md.template

@@ -0,0 +1,10 @@
+# TASK: <task-id>
+
+## Goal
+- <任务目标>
+
+## Scope
+- <输入输出边界>
+
+## Done Criteria
+- <验收标准>