All skills
cat-xierluo avatar

/case-progress

@b57837b

案件进度与状态台账管理。案件 case.yaml 的唯一写入引擎(新增任务、推进任务、登记期限、更新案件阶段、校验、存量迁移),Agent 会话的进度加载与写回契约,以及案件进度监控对账。当用户或 Agent 需要"更新案件进度/推进任务/登记期限/更新案件阶段/同步案件状态/校验或迁移案件数据/查看案件结构化状态"时使用。不要用于:看板展示与周研判(用 case-dashboard)、案件建档初始化(用 new-case)。

Use this Skill: https://skilld.dev/gh/cat-xierluo/legal-skills/case-progress

This session only. Nothing lands on disk.

CHANGELOG.md

≈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)

Source: SKILL.md on GitHub

No alerts29d3 checks · Risk SAFE
  • Gen Agent Trust Hub29d

    The case-progress skill is a legal management tool designed to track case statuses, deadlines, and tasks using a structured YAML database. It provides a secure CLI engine for data manipulation and view rendering. The analysis found no malicious behavior or security risks, noting only standard functional components like PDF text extraction and file system management.

  • Socket29d

    No alerts

  • Snyk29d

    Risk: LOW · No issues

Signed by skilld at b57837b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 19 hours ago.

Activeupdated 2 months ago
homepage
https://github.com/cat-xierluo/legal-skills
author
杨卫薪律师(微信ywxlaw)
version
0.1.0

README badge

README badge for cat-xierluo/legal-skills/case-progress