用途:case-progress 管理案件进度与状态台账,是案件 case.yaml 的唯一写入引擎,负责新增任务、推进任务、登记期限、更新案件阶段、校验与存量迁移,并提供案件进度监控对账。当前状态为 v0.1.0 骨架。
主要能力:scripts/case_store.py 提供 CLI,含 show、list、add-task、set-status、add-deadline、set-stage、set-fields、validate、migrate、render 等子命令(audit、report 留待 M6)。render <短码> 生成案件视图.md 与案件视图.html 派生视图,每次写入自动刷新已存在的视图文件。references/schema.md 为 case.yaml v4.0 字段字典的唯一权威版本。references/contract.md 定义会话契约:会话开始用 show 加载状态,结束经 CLI 写回,禁止手改 yaml。
使用方式:写入须经本引擎,流程为 schema 校验、行级 source 保护、flock、临时文件加 os.replace 原子替换。其他技能经 subprocess 调用本 CLI,禁止跨技能 Python import。/progress 命令支持自然语言驱动任务、期限与阶段操作。工作流收尾时主 Agent 直接执行:show 加载状态、盘点产出、映射语义变更、CLI 写回、log-work 记录工时、validate 后输出变更清单。
限制与陷阱:set-fields 列表为整体替换而非追加,追加前须先读出全量再一并传入,写入后复核条数与关键 id。统计 yaml 列表条数必须按顶级键切片,避免跨列表误判。路径解算禁止 file.resolve(),项目根用 cwd 向上发现或 --root、SUITAGENT_ROOT 指定。运行时数据不得落入 skill 目录。期限需含起算日与法律依据,不确定列入待确认项。M6 的 hooks 监控为远期规划。具体收费、价格与平台信息暂未提供。