名称: ctx-存档 描述: “归档已完成任务。当TASKS.md中有大量已完成项导致视图杂乱时使用。” 允许的工具: Bash(ctx:*)
将已完成的任务从TASKS.md移动到存档中。
归档前
两个问题——如果任一答案为“否”,则不要归档:
- “已完成的任务是否使视图杂乱?” → 如果TASKS.md仍然易于浏览,则没有紧迫性
- “所有
[x]项是否真的完成了?” → 验证没有任务被过早勾选
使用时机
- 当TASKS.md中有许多已完成的
[x]任务时 - 当任务列表难以导航时
- 定期使用以保持上下文清洁
不应使用的时机
- 当只有少量已完成任务时(不值得产生操作噪音)
- 当不确定任务是否真正完成时(应先验证)
- 切勿删除任务——仅归档(这是《章程》中的不变规则)
章程规则
这些规则不可违反:
- 允许归档,不允许删除——切勿删除上下文历史
- 存档保留结构——保留阶段标题以便追溯
- 切勿移动任务——任务保留在其所属的阶段部分;归档是唯一被允许的“移动”操作,且只能移动到
.context/archive/目录
执行
ctx tasks archive $ARGUMENTS
示例——先预览(推荐):
ctx tasks archive --dry-run
示例——确认预览后归档:
ctx tasks archive
已归档的任务将保存到.context/archive/tasks-YYYY-MM-DD.md文件中,并保留阶段标题以便追溯。
报告已归档的任务数量以及存档文件的写入位置。