memcoach

AI 元认知 MCP server：项目记忆（wiki）、需求反问（intake）、动手前教训激活（preflight）、缺陷复盘（retro）。记忆即 Markdown 文件（Obsidian 可视化，git 版本化），server 是访问与流程引导的协议层。

快速开始

cd your-project
npx memcoach init                 # 检测 Cursor/Claude/Codex → 交互选择 → 写 MCP + 规则 + 记忆库
npx memcoach init --yes           # 非交互：已检测到的全部配置
npx memcoach init --target=claude,codex
npx memcoach init --print-config=cursor

| 客户端 | MCP | 规则 | |---|---|---| | Cursor | .cursor/mcp.json | .cursor/rules/memcoach.mdc | | Claude Code | .mcp.json | CLAUDE.md（标记段） | | Codex | .codex/config.toml | AGENTS.md（标记段） |

幂等：已有 memcoach 配置不覆盖。--local 写本机 dist 绝对路径。MEMCOACH_ROOT 缺省为 <cwd>/memcoach；骨架缺失时自动生成。

开发

npm install
npm run build     # 产物 dist/
npm run smoke     # stdio 冒烟测试（临时目录，不碰真实记忆库）
npm publish       # 发布（prepublishOnly 自动 build + smoke）

六个工具

| 工具 | 职责 | 守卫逻辑 | |---|---|---| | memory_search | 关键词分层检索 + 返回 INDEX 地图 | — | | memory_write | 写条目：自动编 ID / pending_review / 更新 INDEX 表格 | lesson 无 trigger 拒收；decision 无被否决方案拒收 | | intake_requirement | 新需求质疑材料：模糊点五类 + 冲突/曾否决检测 + 成本收益框架 | 检出含否决方案的相关 ADR 时预警 | | preflight_check | trigger 匹配激活教训，至多 5 条 | 无命中时明示库存量，防假阴性误读 | | retro_bug | 两段式五步复盘，产出 BUG + LESSON | 自动检测"本可避免"（同类教训已在库）与"同类第 3 次"（提议升级强规则） | | inbox_add | 会话内被纠正的微信号，一行入库 | 同类满 3 条提示归纳升级 |

所有流程工具返回值末尾带"下一步"接力指令（流程自我推进，不依赖 agent 记全规则）；intake/preflight/retro 自动往 METRICS.md 打客观记录。

源码结构

src/
├── index.ts        # 入口：init 分流 + 注册六工具 + stdio transport
├── init.ts         # init 子命令：规则/mcp.json/记忆库骨架一键写入
├── skeleton.ts     # 记忆库骨架文件与规则模板文本（单一来源）
├── store.ts        # 记忆库访问层：frontmatter 解析/ID 分配/检索/trigger 匹配/INDEX 维护/打点
├── templates.ts    # 七分类表、intake/retro 引导文本、接力指令常量
└── tools/          # memory / intake / preflight / retro(含 inbox)