SuperAPI AI 工具集

trellis-finish-work

编程与开发

查看项目

更新于 10-15 23:49

技能介绍

用途:Trellis 工作流的会话收尾技能,负责归档当前活动任务(以及用户确认要一并清理的其他已完成任务)并记录会话日志。代码提交不在此处进行,应在工作流 Phase 3.4 调用本命令前完成。

主要能力与用法:

  1. 查看当前状态:运行 python3 ./.trellis/scripts/get_context.py --mode record,输出活动任务、Git 状态与近期提交哈希。若发现其他已完成任务,会一次性询问是否一并归档,默认否;当前活动任务始终在第三步归档。
  2. 脏路径分类:运行 git status --porcelain,过滤掉 .trellis/workspace/ 与 .trellis/tasks/ 下由脚本自动提交管理的路径;其余路径按任务范围判断归属。若疑似本任务未提交的代码改动,则中止并提示返回 Phase 3.4 提交,不在此执行 git commit;若属于其他并行窗口的工作,仅提示一次后继续;无法判断时询问用户。
  3. 归档任务:运行 python3 ./.trellis/scripts/task.py archive <task-name>,至少归档当前活动任务,脚本会自动产生 chore(task): archive 提交。无活动任务且用户未确认清理时跳过。
  4. 记录日志:运行 python3 ./.trellis/scripts/add_session.py --title "Session Title" --commit "hash1,hash2" --summary "Brief summary",--commit 使用 Phase 3.4 的工作提交哈希,不含归档提交,产生 chore: record journal 提交。最终提交顺序为工作提交、归档提交、日志提交。

适用场景:使用 Trellis 工作流、需要规范收尾并留存会话记录的开发流程。

限制:不负责代码提交;依赖 .trellis 脚本与 Git 仓库环境;具体参数与行为以实际脚本为准,其他细节暂未提供。