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. memoryskill.md (Active Memory) : 长期准则 : 用户偏好、角色设定、全局约束 (Read-Only mostly)。 短期工作台 : 当前任务状态、变量、正在进行的步骤、 外部文献/数据索引 (Read-Write frequently)。 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 行 时， 必须 执行压缩。 保留原则 : User Imperatives : 用户强烈要求的命令、偏好、红线（High Priority）。 Project Skeleton : 项目核心框架、关键路径、当前阶段里程碑（Medium Priority）。 Active Blockers : 正在阻碍当前任务的问题（High Priority）。 丢弃/归档原则 : Details : 已完成任务的执行细节 -> 移至 memory_archive.md 。 Logs : 过程性的成功/失败日志 -> 移至 memory_archive.md 或直接删除。 Expired Context : 已失效的临时变量或不再相关的上下文 -> 直接删除。 Usage Tips 保持 memoryskill.md 轻量（建议 < 100 行），以便随时快速读取。 归档是 手动触发 的动作（由模型决定何时剪切粘贴）。