用途:ai-context/ 记忆层没有自动清理机制,changelog-ai.md 会无限增长、known-issues.md 会堆积已解决项、也缺少单页索引。memory-maintain 负责这类积压清理,与 memory-init(从零生成)、memory-update(记录会话变更)互补。运行时机:changelog-ai.md 过长、已解决项杂乱,或新项目阶段开始时。
主要能力:
- Changelog 归档:按 ENTRY_BOUNDARY_REGEX = /^##\s+[/ 识别条目,超过 30 条时保留最近 30 条,其余移入 changelog-ai-archive.md。
- Known-issues 分离:用 RESOLVED_MARKER_REGEX = /(FIXED)|(RESOLVED)/i 匹配 H2 标题,将已解决段落移入 known-issues-archive.md。
- 索引生成:遍历 ai-context/ 下 .md 文件(排除 index.md 和 _ 开头文件),提取首个 H1 与 Last updated 日期,生成 index.md。
- CLAUDE.md 缺口检测:检查是否存在 ## Active Constraints 段落,仅作 INFO 提示。
使用方式:触发后先执行 Step 0 加载项目上下文,再依次扫描各步骤,输出 dry-run 报告并等待确认。用户回复 yes 才执行写入,其他回复则退出且不写文件。写入后输出维护报告。
限制:写入前必须 dry-run 并获明确确认;不得修改 [auto-updated] 标记块内容,冲突时中止该步骤并告警;归档文件只追加不覆盖;任何情况下不得写入 CLAUDE.md;changelog-ai.md 或 known-issues.md 缺失时静默跳过;≤30 条不归档;仅作用于项目本地 ai-context/,不触碰全局 ~/.claude/;索引每次确认运行都会重新生成;30 条阈值按数量而非日期。