用途:在完成计划或 .writing/ 积累过时数据时,将该活跃项目整体归档,避免丢失设计、计划、进展与发现,并为下一个任务清空工作区。核心对象是活跃项目而非单次会话。
主要能力与流程:
- 确定归档名称:从 progress.md 的任务状态看板提取任务名,或从 plan.md 推导功能名,再用 AskUserQuestion 让用户确认。
- 生成摘要:读取 design.md、plan.md、progress.md、findings.md 及 agents/*/findings.md,生成 30-60 行的 summary.md,含摘要、关键决策、经验教训、关键改动文件。
- 保存归档:创建 .writing/archive 目录并用脚本生成唯一名称,调用 snapshot-save.sh 保存全部活跃文件,再写入 summary.md。
- 记忆整理:基于当前仓库事实检查记忆,提出新增、压缩、更新、删除建议,经用户确认后写入记忆文件,MEMORY.md 控制在 200 行以内。
- 重置 .writing/:用脚本删除活动文件并重建干净模板,archive/ 与 stash/ 自动保留。
- 报告完成情况。
必要命令(保持原样): mkdir -p .writing/archive ${CLAUDE_PLUGIN_ROOT}/scripts/unique-filename.sh .writing/archive "<name>" "" mkdir -p "<returned-path>" ${CLAUDE_PLUGIN_ROOT}/scripts/snapshot-save.sh "<returned-path>" ${CLAUDE_PLUGIN_ROOT}/scripts/writing-reset.sh ${CLAUDE_PLUGIN_ROOT}/scripts/check-writing-state.sh
前置条件:.writing/progress.md 与 .writing/findings.md 必须存在且内容超出空模板。
适用场景:计划完成后的项目归档、.writing/ 数据过时需重置、需要将本次发现沉淀为长期记忆时。
限制与边界:记忆写入必须经用户确认,不自动写;若 .writing/ 为空会警告并询问是否仍要归档;无须记忆变更时跳过相关步骤并报告“Memory already up to date”;同一 .writing/ 含多个会话时全部纳入摘要;旧式单文件归档仍有效。所有记忆整理须基于当前仓库事实,不做假设。具体脚本行为与平台细节暂未提供。