≈2.6k tokens on demand. Your agent reads this file only when SKILL.md points to it.
Changelog
[0.8.2] - 2026-09-30
文档完善
- 补记
set-fields 列表写入陷阱:列表是整体替换而非追加——传 {"任务": [新增一条]} 会清空该列表原有全部条目。schema 校验(每行需 source)拦不住"漏传其余条目",新条目带合法 source 时校验直接通过、数据已丢失。追加前必须先读全量、原条目+新条目一起传,写入后立刻复核条数与关键 id
- 补记 yaml 条数统计陷阱:
案件时间线 之外还有 法定期限、开庭与听证、工时记录 等多个日期列表,跨列表 grep -c "^- 日期: " 得到的数字与目标列表无关,曾把"没丢数据"误判成"丢了 40 多条"、又靠该误判掩盖真丢 7 条。须按顶级键切片或用 show 统计,写入前 cp case.yaml 留底
[0.8.1] - 2026-08-20
- 案件短码支持可选后缀(同日多案/一案拆分)(用户指出:6 位日期前缀是建档日期非唯一 ID,一天接多案前缀必撞):
CASE_DIR_RE 从 ^(\d{6})\s 扩为 ^(\d{6}(?:-[A-Za-z0-9]+)?)\s——目录名如 250609-A 沉睡的法则 著作权-从方 可被发现,短码 250609-A 全链路可用(show/list/add-task/validate/render)
- case-dashboard
dashboard_server.py 同步(发现正则 + display_name 剥离正则)
- extract 扫描跳过
.legacy/.archive- 文件与隐藏目录(避免误扫归档件)
- 真实数据验证:12 案件共存(存量 10 无影响 + 新增 250609-A/B),validate 双案通过
[0.8.0] - 2026-08-16
backfill-work 工时回补命令(用户拍板:按已有法律文书倒推完成的工作量):
- 扫描案件目录工作产物(02 分析/03 研究/05 证据取证/06 文书/08 法院文书审阅/09 庭审整理/10 报告),日期取文件名 YYMMDD 前缀(无则 mtime)
- 按 日期×目录类型 分组合并(每条列出文件名,大批量如批量取证翻倍封顶);默认 dry-run,--apply 落盘(经引擎,更新历史留痕"工时回补")
- 消费项目 8 案件已全量回补:146 组 +117h(合计 120h;251231 28.5h 居首)
- 下限软化:auto 改为"参考默认"(文书·研究 1h,核查·沟通·整理 0.5h;出庭 2h 为实务底线),契约措辞同步
[0.7.2] - 2026-08-16
- 工时合理外扩(用户拍板:AI 生成快但人工核查成本真实,计费需合理冗余):
log-work 时长三态:实际值优先(用户明示)|auto 按类型下限外扩(文书/研究 1h、核查/沟通/整理 0.5h、出庭 2h;类型可从内容关键词推断,可 --type 显式)|? 待补(仅限用户明确不想估时)
- 更新历史标注 auto 来源;SKILL 收尾流程/DataRules//progress 契约同步
- 回填两条历史待补记录(251202/251231,整理类下限 0.5h)
- 推断测试:起草→文书 1h、查看证据→核查 0.5h、电话→沟通 0.5h、明示 3h 优先、待补不计入
[0.7.1] - 2026-08-16
- AI 工作即留痕(用户拍板:文书均经 AI 协作完成,工时要边完成边记录):
log-work 时长支持 ?(待律师补录):AI 不臆造时长;总工时只计已知;视图显示 ⏳待补
- SKILL.md 收尾流程新增必做步骤:log-work(内容/产出文书/关联任务自动携带,时长未知传 ?)
- schema:工作记录.时长 number|null(null=待补,不计入总工时)
- 已按此原则补录本迭代真实 AI 协作工作(251202 档案迁移/文书绑定、251231 建档 enrich,时长待补)
[0.7.0] - 2026-08-16
log-work 工时记录命令(用户指出关键缺口:"什么时候完成了什么工作"无落点):
- schema 增补三:工时统计新增
工作记录[](日期/时长/内容/律师/关联任务/关联文件/source)——结构化真值(计费依据),工时记录.md 降为手工便签/打印件
log-work <短码> <时长小时> <内容> [--date/--lawyer/--task/--file]:追加记录 + 自动重算总工时 + 更新历史 + 视图刷新
- show 输出工时统计;render md/html 新增工时节/页签(累计+本月+明细表);看板详情概览工时卡(📄 可开关联文书)
- new-case 模板同步(工时统计带 工作记录: [])
- 修复:render_html 缺 table 辅助(V2 重写遗留)
[0.6.1] - 2026-08-15
- 案件视图.html 全面改版(用户反馈:内容堆叠→页签化):
- 吸附顶栏:案件名 + 生命周期徽章(按状态着色)+ 阶段(🔒锁定标识)+ 五页签(带计数角标)
- 页签:概览(信息网格/当事人/审级/关联/争议焦点)· 任务(进度条 + 三列看板卡片)· 期限与开庭(大数字剩余天数卡片,红/橙/绿/已抵消)· 时间线(竖向节点轨道,完成实心/待办空心)· 证据与费用
- 打印友好:@media print 隐藏页签并展开全部内容
- 仍为零依赖单文件(纯 CSS + 15 行 vanilla JS),8 案件已重新生成
[0.6.0] - 2026-08-15
- 新增
render 命令(视图渲染):case.yaml → 案件视图.md + 案件视图.html(一页纸派生视图:概览徽章/当事人/任务三态 checkbox/期限红橙绿/开庭/时间线/证据/费用/审级/关联案件/争议焦点;html 零依赖单文件可打印)
- 写入即刷新:commit_write 后自动刷新已存在的视图文件(不主动创建)——视图永远与 case.yaml 同步,无需 hooks;
--stdout 可在会话内直接输出 md
- 消费项目 8 案件已全量生成视图;自动刷新经往返测试(写入→[x]→还原)
[0.5.1] - 2026-08-15
- 新增
set-fields 子命令:通用字段补充(@file 或内联 JSON 深合并;列表整体替换;已结案/锁定阶段保护;写入前校验)——补齐 migrate 无法覆盖的字段级事实
- 消费项目数据统一收尾完成:251202 表格任务全量转换(12 条含状态/负责人/备注)+ 当事人 + TSA 证据索引;250519 补审级记录(杨礼红/立案/判决日期)+ 两次质证一次开庭 + 第三人东台医保中心 + 双原告;251112 补开庭排期(2026-09-23 在线庭审,自传票 PDF 提取);260127/260221/251229 当事人与案件名称规范化;260221 阶段修正为一审
- 遗留人工项缩减为:250519/251231 已结案律师确认(数据已据判决书/调解书核实);251112 举证期限已逾期提示(2026-05-13)
[0.5.0] - 2026-08-15
- M4 存量迁移完成:
migrate 子命令(默认 dry-run / --apply / --enrich JSON 深合并)+ A/B/C/D/none 五种转换器;存量行一律 source=user(AI 不覆写);生成档案先过 validate 不过即跳过
- 消费项目 8 案件全量迁移:B 直迁(阶段注释归一)、A 双 yaml 合并、C 富内容映射(证据/索赔/家属参与人)、D checkbox 转换(日期规范化 + 表格任务警告)、none 骨架 + 事实 enrich;原 yaml 归档 .legacy.yaml、叙事文档统一固定名 案件信息.md
- 修复:B 类带注释阶段值归一(一审(法院已立案)→一审)、时间线空日期/[待定] 行跳转叙事、D 类表格头误读防护
[0.4.1] - 2026-08-15
- 决策 #047:skill 间协作为主,去除 subagent 依赖——状态同步流程内化进 SKILL.md("工作流收尾状态同步"节,主 Agent 直执行:加载状态 → 盘点产出 → 映射判断 → CLI 写回 → 校验汇报);消费项目删除 CaseSync subagent,Workflow v2.1 / DataRules / AgentMapping / /progress 引用同步为 skill 协作路径
[0.4.0] - 2026-08-15
- M3b 轻量写回入口落地(消费项目规则层):
DataRules.md 会话契约规则(自动加载):show 加载 / CLI 写回 / 人工覆盖保护 / 工作流收尾 / 文件分工速查
case-sync subagent(CaseSync.md,SubagentStandards 规范):工作流收尾语义判断面,经本引擎写回,永不手改 yaml
/progress 命令:明确操作直路由 CLI、语义复杂派发 case-sync、查看类走 show/dashboard
- Workflow v2.1 收尾强制原则(七场景 Reporter 后必派 case-sync);AgentMapping v2.4 属主交接(case.yaml 写入=case_store,Scheduler 只计算);Scheduler 工作流程同步改造
[0.3.0] - 2026-08-14
- M2 写入引擎落地
scripts/case_store.py(~470 行,stdlib + PyYAML):
- 子命令:show(阶段按 锁定>手填>推断 解析、期限告警三级+抵消过滤)/ list(存量案件标 unmigrated)/ add-task / set-status / add-deadline(类型按名称推断)/ set-stage(--lock/--unlock)/ validate(schema §5 六条规则)
--actor user|ai 操作者模型:source=user 行与锁定阶段仅接受 user;"已结案"不提供写命令
- 并发安全:旁车锁
<case.yaml>.lock 锁定读-改-写全周期(首版仅锁写入瞬间,并发测试 1/5 暴露丢失更新,修复后 5/5,见 DEC-008)
- 每次写入自动追加 更新历史 + 刷新 同步.最后同步时间;写入前 schema 校验拦截
- 路径解算:--root > SUITAGENT_ROOT > cwd 向上发现(符合红线,不依赖
__file__)
- 测试:虚构 fixture 全链路验证(张三/李四民间借贷案,无真实案件数据)
[0.2.1] - 2026-08-14
- schema v4.0 同日增补(8 案件材料盘点 + CaseBoard 字段对照驱动):新增 关联案件 / 审级记录 / 开庭与听证 / 其他诉讼参与人 / 扩展信息 五节;meta.业务领域 路由键、刑事程序阶段(侦查/审查起诉)、律师费.计费方式、证据索引.取证方式;§1 总览表加层级列(core / 对抗性 / litigation,16 节)
- 新增 schema §7 类型档案(Profile)与非诉扩展机制:core 层通用 + profiles/<领域>.md 惰性立项 + new-case/case_store/dashboard 三方配套演进;§8 增补记录(含刻意不入库清单)
[0.2.0] - 2026-08-14
- M3a-1 契约定稿:
references/schema.md v4.0——13 顶层节字段字典 × 消费者、行键/source 规则、v3.0→v4.0 章节处置表、存量 5 格式映射要点、6 条校验规则、最小完整示例;references/contract.md v1.0——会话加载/写回流程、变更分流表、人工覆盖保护、工作流收尾(M3b 起)、异常处理
- 命名对齐 new-case DEC-011/012:上下文指针为常量路径(
../案件信息.md、工时记录.md)
- 上游模板同步升级完成(new-case v1.4.0 / DEC-015 / Task-016)
[0.1.0] - 2026-08-14
- 骨架创建:SKILL.md(职责、五条开发红线、与 new-case/case-dashboard 的生命周期接力)、目录结构(scripts / references)
- 由 case-dashboard skill 拆分而来(决策 #046):数据层独立,承接 M2 写入引擎、M3a 数据模型、M3b 轻量写回入口、M4 存量迁移、M6 监控 hooks
- 设计依据:消费项目 SuitAgent《case-dashboard 与数据真值统一方案》v1.4
- 经 skill-manager 符号链接安装到 SuitAgent
- 尚未实现:case_store.py(M2)、schema.md / contract.md(M3a)