用途:save-work 用于持久化已完成的工作,把待办项正式归档为完成项,并让工作记录可被检索。
主要能力:扫描 work/*/README.md 中 frontmatter 为 status: done 且仍列在 project.md 的 Pending Work 下的条目;对每个完成项执行 asta documents add 建立索引,生成或更新 work/index.yaml;把 project.md 中对应行从 Pending Work 移到 Completed Work,并去掉 (status: ...) 标记;最后将 README、数据产物、project.md 和 index.yaml 一起提交到 git。
必要用法:索引命令为 README_PATH="$(pwd)/work/<slug>/README.md" 后执行 asta documents add "file://${README_PATH}" --root work --name="<one-line summary from project.md>" --summary="<paste the Goal section's first paragraph>" --tags="asta-assistant,work,<slug>" --mime-type="text/markdown"。若 work/index.yaml 不存在,首次 asta documents add 会创建它。提交时显式暂存文件,不使用 git add -A:git add project.md work/index.yaml work/<slug>/README.md work/<slug>/data,随后 git diff --cached --stat 检查,再 git commit -m "work(<slug>): <one-line summary>"。可逐个 slug 提交,也可合并提交。最后打印已保存的 slug 列表和提交哈希。
适用场景:在 asta 工作流中完成一个或多个工作项后,需要归档、索引并记录到版本控制时使用。
限制:不推送到远程;不删除 work 目录,目录保留在磁盘上作为自然语言报告的来源;不修改未完成条目的状态;不在 git 仓库中时跳过提交。其余细节暂未提供。