| name | trellis-finish-work |
| description | 收尾当前 session：验证质量门禁已通过，提醒用户提交，归档已完成 tasks，并将 session 进展记录到开发者 journal。编码完成并准备结束 session 时使用。 |
完成工作
收尾当前 session：archive active task（以及用户想清理的其他已完成但未归档 tasks），并记录 session journal。代码 commits 不在这里完成 — 它们发生在调用此命令前的 workflow Phase 3.4。
第 1 步：调查当前状态
python3 ./.trellis/scripts/get_context.py --mode record
这会打印：
- My active tasks — review 除当前 task 外是否还有实际已完成（代码已 merged、AC met）且应在本轮归档的 task。
- Git status — 快速查看 dirty 内容。
- Recent commits — 第 4 步需要它们的 hashes 用于
--commit。
如果 --mode record 显示其他不属于当前 session 的已完成 tasks，用一次性确认告知用户："这些 N 个 tasks 看起来已完成 — 本轮也归档它们吗？[y/N]"。默认否；当前 active task 无论如何都会在第 3 步归档。
第 2 步：Sanity check — 分类 dirty paths
运行：
git status --porcelain
过滤掉 .trellis/workspace/ 和 .trellis/tasks/ 下的 paths — 它们由 add_session.py 和 task.py archive auto-commits 管理，会作为此 skill 自身工作的一部分显示为 dirty。
对每个剩余 dirty path，判断它属于当前 task还是其他并行工作（例如另一个终端窗口正在编辑同一 repo）。启发式：
- 当前 task 的
prd.md / implement.jsonl / check.jsonl 中引用的 paths → current task
- 与 task 声明 scope 匹配的 code areas 中的 paths，或你记得本 session 编辑过的 paths → current task
- 无关 areas 中且你不记得本 session 触碰过的 paths → other parallel work
然后路由：
-
任何剩余 path 看起来像 current-task work — 退出并说明：
"Working tree 中存在来自此 task 的未 commit 代码变更：<list>。请返回 workflow Phase 3.4，在运行 /finish-work（Trellis command）前提交它们。"
不要在这里运行 git commit。不要提示用户自行 commit。用户回到 Phase 3.4，由 AI 在那里驱动 batched commit。
-
所有剩余 paths 看起来都无关（其他并行窗口工作）— 报告一次并继续第 3 步：
"提示：存在此 task scope 之外的 dirty files — 为其他窗口保留：<list>。"
-
确实不确定 — 询问用户一次："<list> 是我忘记提交的当前 task 工作，还是另一个窗口的工作？（commit / ignore）" — 然后按其回答路由。
第 3 步：Archive task(s)
python3 ./.trellis/scripts/task.py archive <task-name>
至少：当前 active task（如有）。再加上用户在第 1 步确认的任何额外 tasks。每次 archive 都通过脚本 auto-commit 产生一个 chore(task): archive ... commit。
如果没有 active task 且用户未确认任何 cleanup archives，跳过此 step。
第 4 步：记录 session journal
python3 ./.trellis/scripts/add_session.py \
--title "Session Title" \
--commit "hash1,hash2" \
--summary "Brief summary"
对 --commit 使用 Phase 3.4 产生的 work-commit hashes（可在第 1 步 Recent commits 列表中看到，或通过 git log --oneline 查看）。不要包含第 3 步的 archive commit hashes。这会产生一个 chore: record journal commit。
最终 git log 顺序：<work commits from 3.4> → chore(task): archive ...（一个或多个）→ chore: record journal。
