project-memory

Project Memory 用于在项目根 ./tmp/ 下维护过程性记忆：项目记忆、研究讲解、脚本、实验记录、实验结果、当前状态与后续方向。其核心是把过程与结论分开——./docs/ 放给项目读者的结论，./tmp/ 放产生这些结论的过程；探索中、失败、临时、未定论的内容进 ./tmp/，只有稳定且对项目有价值的内容才毕业到 ./docs/ 并在 STATE.md 记一笔。\n\n主要能力与约定：实验定义在 experiments/（小、稳定、人读），运行产物放 outputs/（多、只增、程序写），产物不覆盖；状态入口唯一，先读 ./tmp/STATE.md；删除是最后手段，完成或废弃的内容移进 archive/；初始化惰性，只读不建，第一次写入时才落最小集合（.gitignore 规则、README.md、STATE.md），其余目录用到再建；多 agent 并行时才启用 agents/，任务在 agents/BOARD.md 认领即锁，进展写各自 agents/<agent-id>/，全局 STATE.md 收尾汇总。\n\n常用操作包括开新实验（建 experiments/EXP-XXXX-slug/，编号扫描 experiments/ 与 archive/ 取最大值加一且不复用）、跑脚本记产物、写代码讲解、沉淀文档到 docs/{memory,research,plans}/、收尾更新 STATE.md、归档等。docs/ 文档带 front-matter（title、type、status、created、updated、tags、related），状态由 draft 到 stable，过时标 deprecated。\n\n适用场景为开发过程中的实验管理、研究探索记录、项目状态维护与多 agent 协作。限制：该技能依赖项目根目录，./tmp/ 默认不进版本库，顶层内容除 scratch/ 外不可随意删除；平台、收费与具体实现细节资料暂未提供。