/context-memory-keeper

name: "context-memory-keeper"
description: "Manages persistent memory. Invoke to read active context or archive old tasks. Structure: Long-term Principles (Rules) + Short-term Workbench (Tasks)."

Context Memory Keeper

全局流程协作约束（长对话防漂移）

• 本 skill 不得作为孤立入口。用户要求完整论文、生成 Word、继续流程或不确定阶段时，先回到 `paper-workflow-orchestrator` 判断当前 S0-S8 阶段。
• 启动或继续本 skill 的正式任务前，必须运行：

  python .claude/skills/paper-workflow-orchestrator/scripts/workflow_guard.py --skill context-memory-keeper

• 如果输出 `[WORKFLOW FAIL]` 或报告 `status != "PASS"`，停止本 skill，按 `paper_output/qa/workflow_guard_report.json` 的失败项回补前置阶段，不得凭记忆继续。
• 本 skill 只写入自己契约范围内的 `paper_output/` 产物；完成后必须回到 `paper-workflow-orchestrator` 判断下一步，并用 `context-memory-keeper` 记录已完成产物、阻塞项和下一步。
• 长对话中如果上下文变长、阶段不确定或用户分开调用 skill，先运行：

  python .claude/skills/paper-workflow-orchestrator/scripts/workflow_guard.py --status

再读取 `paper_output/qa/workflow_guard_report.json`、`paper_output/preflight_report.json`、`paper_output/input_manifest.json`、`paper_output/results/run_manifest.json` 和本 skill 的上游 JSON 契约，按报告里的 `recommended_skill` 与 `next_action` 继续。

• 继续流程前，必须把 `paper_output/context/workflow_memory.json` 视为长期断点记录；若其中的 `current_step`、`next_step`、`recommended_skill` 与 `workflow_guard.py --status` 不一致，以 guard 报告为准。
• 每次完成本 skill 的产物后，先回到 `paper-workflow-orchestrator` 或运行 `workflow_guard.py --status`，再更新 workflow memory：

  python .claude/skills/context-memory-keeper/scripts/update_workflow_memory.py

更新后读取 `paper_output/context/workflow_memory.json` / `.md`，确认下一步和推荐 skill 已记录。

执行契约

• 上游输入：当前赛题约束、模型路线、数据源、图表路径、QA 结论、用户新增偏好和流程断点。
• 必须输出：更新后的 `memoryskill.md`；当短期工作台过长时，将旧任务摘要归档到 `memory_archive.md`。
• 下游交接：其他 skill 在复杂任务开始前读取 `memoryskill.md`，避免遗忘当前模型路线、数据来源和用户要求。
• 推荐下一步：完成记忆更新后回到调用它的当前 skill；若目标是完整论文，回到 `paper-workflow-orchestrator` 判断后续阶段。
• 失败回退：若无法安全更新记忆文件，应在本轮回复中明确保留关键结论，并提示后续手动补写到记忆文件。

Description

此 Skill 维护双层记忆结构，旨在解决模型上下文遗忘问题，同时保持上下文窗口的整洁。

Files Structure

Executable Workflow Memory

• After `workflow_guard.py --status` or after a skill handoff, run:

  python .claude/skills/context-memory-keeper/scripts/update_workflow_memory.py

• The script reads `paper_output/qa/workflow_guard_report.json` plus key workflow artifacts and writes:
• `paper_output/context/workflow_memory.json`
• `paper_output/context/workflow_memory.md`
• Long conversations and resumed sessions should read `workflow_memory.json` before relying on chat history.

1. **`memoryskill.md` (Active Memory)**:

• **长期准则**: 用户偏好、角色设定、全局约束 (Read-Only mostly)。
• **短期工作台**: 当前任务状态、变量、正在进行的步骤、**外部文献/数据索引** (Read-Write frequently)。

2. **`memory_archive.md` (Archive)**:

• 历史记录、已完成的任务详情 (Write-Only mostly)。

When to Invoke

• **Read**: 每次开始复杂任务前，或感到上下文模糊时，读取 `memoryskill.md`。
• **Update**:
• 获得新指令或完成小步骤 -> 更新 `memoryskill.md` 的“短期工作台”。
• 用户修改全局规则 -> 更新 `memoryskill.md` 的“长期准则”。
• **Archive (Cleanup)**:
• 当“短期工作台”内容过长或阶段性任务结束 -> 将旧内容剪切到 `memory_archive.md`，并在 `memoryskill.md` 中仅保留关键结论。

Compression Policy (Auto-Cleanup)

• **触发条件**: 当 `memoryskill.md` 超过 **100 行** 时，**必须**执行压缩。
• **保留原则**:

1. **User Imperatives**: 用户强烈要求的命令、偏好、红线（High Priority）。 2. **Project Skeleton**: 项目核心框架、关键路径、当前阶段里程碑（Medium Priority）。 3. **Active Blockers**: 正在阻碍当前任务的问题（High Priority）。

• **丢弃/归档原则**:

1. **Details**: 已完成任务的执行细节 -> 移至 `memory_archive.md`。 2. **Logs**: 过程性的成功/失败日志 -> 移至 `memory_archive.md` 或直接删除。 3. **Expired Context**: 已失效的临时变量或不再相关的上下文 -> 直接删除。

Usage Tips

• 保持 `memoryskill.md` 轻量（建议 < 100 行），以便随时快速读取。
• 归档是**手动触发**的动作（由模型决定何时剪切粘贴）。