用途:在人工测试并提交代码之后,将已完成的工作进度记录到 .trellis/workspace/ 的 journal 文件中,捕获会话摘要、提交哈希并更新索引。前提是必须由人工先测试并提交代码,不要直接运行 git commit,脚本会自行提交 .trellis/ 元数据;只需读取 git 历史(git log、git status、git diff)并运行 Python 脚本。
主要能力:一键添加会话,自动追加到 journal-N.md,超过 2000 行时自动新建文件;自动检测分支上下文(可用 --branch 覆盖,否则按 task.json 到当前 git 分支,缺失值优雅省略);更新 index.md(会话总数 +1、最后活跃时间、行数统计、历史);自动提交 .trellis/workspace 与 .trellis/tasks 变更。
使用方式:先获取上下文并检查任务:python3 ./.trellis/scripts/get_context.py --mode record。对实际已完成的任务归档(依据工作状态而非 task.json 的 status 字段):python3 ./.trellis/scripts/task.py archive <task-name>。再一键添加会话,方法一:python3 ./.trellis/scripts/add_session.py --title "Session Title" --commit "hash1,hash2" --summary "Brief summary of what was done";方法二:通过 stdin 传入详细内容,cat << 'EOF' | python3 ./.trellis/scripts/add_session.py --stdin --title "Title" --commit "hash"。其他命令:python3 ./.trellis/scripts/task.py list 列出活跃任务。
适用场景:在人工测试并提交代码后,需要归档已完成任务并记录会话进度、提交哈希与摘要时。
限制:仅应在人工测试并提交代码后使用;不要直接运行 git commit;归档判断依据实际工作状态,代码已提交或验收标准已满足即可归档,不必等待 PR,也不要因 status 仍为 planning 或 in_progress 而跳过归档。其他细节暂未提供。