用途:结束当前 Trellis 会话,归档活动任务及用户同意清理的其他已完成任务,并记录会话日志。代码提交不在本技能内完成,应在调用本命令前的流程 Phase 3.4 完成。
主要步骤:
- 查看当前状态:python3 ./.trellis/scripts/get_context.py --mode record ,输出活动任务、git status 和最近提交;若发现其他已完成任务,以“These N tasks look done — archive them too in this round? [y/N]”向用户确认一次,默认否,当前活动任务始终在步骤 3 归档。
- 脏路径分类:运行 git status --porcelain ,过滤 .trellis/workspace/ 与 .trellis/tasks/ 下的路径(由 add_session.py 和 task.py archive 自动提交管理)。其余路径若属于当前任务,则中止并提示回到 Phase 3.4 提交;若确属其他并行窗口工作,只报告一次后继续;不确定时向用户询问一次并按回答处理。此处不执行 git commit,也不提示用户提交。
- 归档任务:python3 ./.trellis/scripts/task.py archive <task-name> ,至少归档当前活动任务及用户确认的额外任务,每次归档产生 chore(task): archive 提交;无活动任务且用户未确认清理时跳过。
- 记录日志:python3 ./.trellis/scripts/add_session.py --title "Session Title" --commit "hash1,hash2" --summary "Brief summary" ,--commit 使用 Phase 3.4 的工作提交哈希,不包含步骤 3 的归档提交,最终产生 chore: record journal 提交。
最终 git log 顺序为:Phase 3.4 的工作提交 → chore(task): archive(可多个)→ chore: record journal。
限制:不负责代码提交;需已有 Trellis 项目目录结构与脚本;归档与日志提交由脚本自动完成;涉及任务归属的判断不确定时需询问用户。其余收费、平台支持等信息暂未提供。