Forge 项目记忆

要解决什么问题

在仓库文件成百上千、模块关系分散时，智能体若一上来就全量读源码，既慢又容易漏掉架构决策和跨模块依赖。Forge Memory 把项目认知和源码备份分开：在用户显式触发或确实需要「项目全貌」时，在项目根目录维护 .project-context/，作为可复用的本地记忆层；日常小改 bug 则只读已有索引，不反复扫描。

技能如何工作

触发分三层：完整触发（初始化 / 扫描 / 写会话摘要 / 读结构化文件）、被动读取（仅读 project-summary.md 做定位）、不触发。命中完整或手动条件后，按优先级在四种状态里选一条：总结会话摘要 → 读取会话记忆 → 读取项目结构化文件 → 初始化并跑结构化扫描。

核心约定包括：

• 返回会话时优先从 .project-context/ 进入，再按需定向读源码
• 扫描排除构建产物、依赖缓存、VCS 元数据、虚拟环境、日志与二进制
• 脚本经 forge_memory.py 统一入口；编辑记忆目录或 graph JSONL 前应对照 references/schema.md，流程细节见 references/workflow.md

验证上，应确认 INDEX.md、project-summary.md 与会话索引齐全；用 context --task "项目概览" 做质量检查时，期望评分为 A/B。

边界与注意点

本 skill 不负责大段复制或备份源码；摘要与知识图谱应描述结构、决策、关系、风险与会话状态。被动读取不得顺带初始化或扫描。若目录里已有用户手写摘要，覆盖前须询问；目标根目录不明、项目过大、或发现敏感文件时也应暂停并问用户。