Project Memory Skill 技能

技能简介

Project Memory 是一款专为 AI 编程 Agent（Claude Code / Codex）设计的本地项目记忆与决策追踪系统。它将项目的目标、决策过程、证据、成果和经验教训全部记录在本地 SQLite 数据库中，通过 MCP 协议为 AI Agent 提供读取和写入工具，让 Agent 的每次操作都建立在完整的项目上下文之上，而非每次对话都从零开始。项目模板涵盖软件产品、咨询项目和工作流自动化三种类型，覆盖从立项到交付的完整生命周期。

核心能力

• MCP 三工具协议：memory_get（读取）、memory_write（写入）、project_memory_view（本地控制面板）
• 项目模板体系：内置 product（软件产品）、engagement（咨询项目）、automation（n8n 工作流）三种模板
• Kickoff 启动对话：7 个启动问题，Agent 读取后逐项与用户确认
• 决策追踪：每次决策记录证据、备选方案、不确定性和预期结果
• Guard 机制：被接受的教训形成 Guard，触发条件匹配时强制要求决策者明确表态
• Scope 边界守护：编辑超出允许范围时 Lifecycle Hook 自动拦截
• Agent 检查与委托工作：支持 Codex / Claude Code 进行自动化检查
• 本地控制面板：展示 Now/Plan/Work/Architecture/Decisions/Learning 等视图
• 零遥测·零托管：仅依赖 Python 标准库，无外部数据库

安装配置

# 为 Codex 安装
uvx project-memory-mcp@0.6.0b5 setup --client codex --trust

# 为 Claude Code 安装
uvx project-memory-mcp@0.6.0b5 setup --client claude --trust

使用步骤

1. 初始化项目

   project-memory init ~/projects/pricing-tool --template product --client codex

2. Kickoff 启动对话：Agent 读取 kickoff 问题，向用户收集项目背景

3. 日常工作循环：告知 Agent 预期结果和约束，Agent 记录工作项并持续追踪

4. 查看项目状态

   project-memory view

适用场景

• 长期产品开发：保持 AI 对产品目标、架构决策的理解跨越多轮对话
• 咨询项目交付：结构化管理各阶段文档和交付成果
• n8n 工作流维护：追踪自动化流程的设计意图和变更历史
• 团队知识传承：新成员加入后快速了解项目背景

适用人群

• 日常使用 Claude Code 或 Codex 的开发者
• 需要 AI 编程 Agent 保持项目上下文一致性的工程师
• 有复杂多阶段交付物的项目团队

工作原理

Project Memory 在项目根目录初始化 SQLite 数据库，通过 MCP 协议暴露工具供 Agent 调用。Agent 通过 memory_get 读取项目历史，通过 memory_write 记录新决策。Lifecycle Hook 监控文件修改路径，超出允许范围时自动拦截。

官方链接

• PyPI：https://pypi.org/project/project-memory-mcp/
• GitHub：https://github.com/Dankaro-projects/project-memory