knowledge-maintenance

name	knowledge-maintenance
description	维护 Proma 项目地图与长期协作知识。当用户说“记住”“以后这样做”“你又忘了”、用户直接表达或重复出现的稳定偏好/决策/纠错，或当前任务发现项目 AGENTS.md 已过时时使用。将事实路由到项目根 AGENTS.md、Proma workspace AGENTS.md、memory/、Skill 或 Context；历史会话仅在用户明确授权后分批作为补证据。不要将会话流水账或单次推断写入长期知识。
version	1.0.3

知识维护

目标不是补全档案，而是减少未来重复沟通、重复探索和重复犯错。

路由

信号	位置
当前项目如何运行、架构/目录/命令/验证/边界	项目根 AGENTS.md
Proma 执行环境、工作区流程、项目入口指针（不列已安装 Skills）	Proma workspace AGENTS.md
用户画像、协作偏好、纠错、经验、决策理由	workspace memory/ 的主题 Markdown
重复的可执行步骤	Skill
长调研、证据正文、设计报告	项目 Context / 本地文档
当前任务临时状态	会话工作台

项目根 AGENTS.md 与 workspace AGENTS.md 都应最小更新、保留用户内容；项目事实不双写。优先维护 <!-- proma:... --> 区块。

Memory 的组织

• MEMORY.md 仅做主题索引和路由，不承载长正文；每个有效主题文件都必须有一条简洁索引，主题被合并、迁移或淘汰时同步更新索引，避免悬空入口。
• 按证据创建主题文件；常见但非强制主题包括 user-profile.md、collaboration.md、lessons.md、decisions.md。
• 不为凑结构创建空文件，不把一次性过程或未经验证推断写入。
• 更新前先读索引及相关主题，修订过时结论而不是追加冲突条目。
• 保留时间语境：时间敏感、会随状态更新，或记录具有后续判断价值的阶段性进展时，在对应记忆正文相邻标注事实/状态的发生、生效或截至时间（至少日期；日内顺序、截止点或时区会影响判断时写明时间和时区）。不得用文件修改时间替代；稳定且不随时间变化的事实无需额外加时间戳。
• 用户画像按领域迭代，禁止用“新手/专家”一类全局标签代替实际证据。

主动重整

每次准备写入或修订 Memory 时，顺带检查目标主题的语义边界；这是一项轻量维护，不需建立额外台账或元数据体系。

• 若一个主题文件累积了 3 个以上可独立命名的主题，或新内容明显不属于其标题范围，停止继续追加：按语义拆分或迁移到已有的合适主题；没有合适位置时才创建最小的新主题文件。
• 合并重复结论，修订冲突或已被新证据推翻的结论；对长期未验证、无未来判断价值的内容予以删除或明确标记为待确认。删除可能仍有价值的历史结论前，遵循本 Skill 的确认边界。
• 重整后立即同步 MEMORY.md：新增、改名、迁移、合并或淘汰的主题都应更新索引和一句话路由说明。
• 不等待用户专门提出“整理记忆”：只要本次维护已暴露上述信号，就在同一次最小改动中主动完成重整；若涉及大段覆盖、作用域不明或敏感信息，先提出候选并确认。

维护流程

1. 完成当前任务后，只有发现稳定且会影响未来判断的事实时才维护；不要为了收集资料提问。
2. 对明确、稳定且与既有记录不冲突的最小增量，直接写入相应 Memory 主题并在完成后简短说明。不得把此类写入包装成“是否要记住/是否要更新”的预先确认问题。
3. 只有删除或大段覆盖既有内容、出现冲突、需要从单次行为做不确定推断，或可能记录敏感个人信息时，才先以 1–3 条候选内容说明事实、位置和影响，并取得确认。
4. 用户跳过、拒绝或只答一部分时停止追问，继续正常服务。
5. 历史会话只能在用户明确授权后读取：先按元信息选至多 3 个高信号会话，按需读局部，证据足够即停止；不得全量扫描。