KP Agent Memory（共享、已提交）

更新日期：2026-07-01

本目录是 knowledge-pipeline 仓库共享、已提交、推送到两个远程的 agent memory。所有 agent（Codex、Claude Code、Copilot、自动化流程）在 AGENTS.md §3.0 上下文发现时检索索引 MEMORY.md，命中即复用，不重复假设、不重复踩已知坑。

与其它 memory 的边界

store	位置	入 Git	用途
本目录	docs/memory/	是（双远程共享）	持久的项目级用户偏好、纠错/反馈、可复用结论——对所有 agent 有约束力
.memory/	仓库根 .memory/	否（.gitignore）	个人 / 一次性会话草稿
全局 memory	~/.claude/.../memory/	否（仅本机）	个人跨会话草稿

判据：持久、对所有 agent 有约束力的偏好/纠错 → 本目录；一次性、个人的 → .memory/ 或全局。

Schema（一条事实一文件）

---
name: <kebab-slug，等于文件名 stem>
description: <一行摘要，用于召回时判断相关性>
metadata:
  node_type: memory
  type: user | feedback | project | reference
---

• user — 用户是谁、沟通风格、长期期望。正文散文。
• feedback（纠错） — 对 agent 工作方式的纠正/确认。正文必须含 规则 / 触发·症状 / Why / How to apply，足以改变下次行为。
• project — 不由代码/git 直接得出的持久项目结论。正文散文 + Why: / How to apply:。
• reference — 外部资源指针（URL、dashboard、ticket）。

正文用 [[slug]] 交叉链接相关条目（可指向尚未创建的条目，作为待写标记）。

slug 约定 + §8 豁免

• slug 用 kebab-case、稳定、描述内容、永不带日期。
• 本目录豁免 AGENTS.md §8 的日期文件重命名规则：slug 是 [[name]] 链接目标与索引键，改名会断链并 churn 历史。内容时效写在正文，不进文件名。
• 不要用 session-handoff-* 命名（.gitignore glob 卫生）。

写入触发器

用户每给出一条偏好或纠正时，立即按对应模板沉淀一条结构化条目，并在 MEMORY.md 对应分组登记一行。先查既有条目：能更新就更新、不建重复；发现写错的条目就删。

模板

user

---
name: <slug>
description: <谁 / 什么偏好>
metadata:
  node_type: memory
  type: user
---

<散文：持久偏好 / 沟通风格 / 长期期望>。

feedback（纠错）

---
name: <祈使句-slug>
description: <一行规则>
metadata:
  node_type: memory
  type: feedback
---

**规则：** <纠正后的行为，祈使句>

**触发/症状：** <agent 即将重犯该错的情形>

**Why:** <旧行为为何错 / 付出的代价>

**How to apply:** <下次具体怎么做>

相关：[[other-slug]]

project / reference 用同一 frontmatter，仅改 type，正文为散文加 Why: / How to apply:。