/case-progress

case.yaml v4.0 字段字典（唯一权威契约）

版本: 4.0（2026-08-14 定稿） 权威声明：本文件是 case.yaml 的唯一字段契约。new-case 模板生成、case_store 引擎校验、M4 存量迁移、case-dashboard 渲染，一律以本文为准；其他 skill 引用版本号，不复制内容。 上位设计：消费项目 SuitAgent《case-dashboard 与数据真值统一方案》v1.6（§3 数据真值规范，决策 #045/#046）。

0. 设计原则

1. 状态与叙事分离：case.yaml 只存可计算状态；案情细节在 <案件ID>案件信息.md（叙事文档），经 上下文.叙事文档 指针关联。
2. 字段准入：每个字段必须标注消费者（dashboard / agent / lawyer / new-case / case_store），无消费者不收录。
3. 人工覆盖保护：行级 source: user|ai；AI 永不覆写 source=user 的行；生命周期状态=已结案 仅手工标记；程序阶段锁定=true 时 AI 不得改写程序阶段。
4. 数据卫生：
   • 日期一律 YYYY-MM-DD（模糊年份允许 YYYY-MM）；禁止 2025年10月、待定 等混排
   • 占位符统一 null，说明写进对应 备注 字段；禁止 [待确认]、__________、空串冒充
   • 枚举值纯净不带 emoji（⭐/✅ 等由展示层添加）
   • 金额为数值（默认 CNY），不带单位、不带千分位
   • 禁止绝对路径；所有路径相对 case.yaml 所在目录
5. 行键（稳定身份）：列表行的身份用业务键，不用数组下标——AI 重排后人工修改不错位。

状态三态（全库统一，替代各格式旧值）：todo / in_progress / done。

1. 顶层结构总览（16 节 × 层级 × 消费者）

层级说明：core = 一切业务领域通用；对抗性 = 诉讼及商标异议/专利无效等对抗性非诉通用；litigation = 诉讼专用（非诉项目这些节为空或省略）。

2. 字段字典

2.1 meta

2.2 案件基本信息

2.3 当事人与代理

我方当事人[] / 对方当事人[]，行键 姓名|角色：

律师[]：姓名（✅）、角色（主办律师|协办律师）、执业证号、所属律所、source。

其他诉讼参与人[]（行键 姓名|角色）：{姓名: str✅, 角色: str✅（第三人/对方代理人/鉴定人/证人等）, 备注: str|null, source}——覆盖材料盘点中真实出现的追加第三人、对方代理律师（判决书/传票所载）。

2.4 法定期限（list，v3.0 按名索引 dict → 列表化）

2.5 任务（list，唯一任务真源）

2.6 案件时间线（list）

2.7 证据索引（list，明细留 05 目录）

2.8 费用信息（二域：支出成本 + 索赔评估）

支出（map）：律师费 / 诉讼费 / 鉴定费 / 其他费用，每项 {金额: number|null, 状态: 已确定|待确定}；律师费另含 计费方式: 固定|风险|阶段（风险代理、分阶段收费为真实形态）——终结对象/扁平串/markdown 表三种结构并存。

索赔与评估（list，医疗损害等索赔导向案件用，行键 项目）：项目（✅）、金额（number|null）、计算方式（str|null）、备注（str|null）。

2.9 争议焦点与法律研究（仅索引，叙事留案件信息.md）

• 争议焦点[]：名称（✅，行键）、状态（三态：todo 待识别 / in_progress 分析中 / done 已分析）
• 法律研究[]：主题（✅，行键）、状态（三态）

2.10 工时统计（聚合 + 工作记录明细）

工作记录行键 = 日期|内容；新增经 log-work 命令（自动重算总工时）。

2.11 上下文（指针，全部相对路径）

2.12 同步

2.14 审级记录（litigation，行键 = 审级）

一案跨多审级时每审级一行（借鉴 CaseBoard case_instances 的简化）：{审级: enum✅（一审|二审|再审|执行|仲裁）, 法院案号: str|null, 承办法官: str|null, 法院联系方式: str|null, 立案日期: date|null, 结案日期: date|null, 结案方式: str|null（判决|调解|撤诉|裁定）, source}。meta.法院案号 为当前审级案号的快捷方式，二者不一致时以本表为准；法官/助理/书记员、法院电话（判决书与传票中的真实信息）落此表。

2.15 开庭与听证（litigation，行键 = 日期|类型|次序）

{日期: date✅, 类型: enum✅（开庭|听证|谈话|质证）, 地点: str|null, 法庭: str|null, 事项: str✅, 次序: int|null（第几次）, 来源文件: str|null, 状态: enum✅（todo=已排期未开|done=已进行）, source}——材料盘点确认：多轮庭审跨月进行、听证传票含完整时间/地点/法庭号为真实形态；M5 月历视图的直接数据源。时间线仍记一条对应事件（事件类型=开庭），明细在本表。

2.16 扩展信息（core，类型档案插件容器）

扩展信息: {}        # 非诉/领域插件的命名空间，如：{商标: {申请号: ..., 类别: [...], 续展截止: ...}, 专利: {...}}

规则见 §7：容器机制现在定型，具体字段惰性定义（某类非诉项目实际接入时才立档案，遵循字段准入原则）。litigation 案件此节保持空 map 或省略。

2.17 更新历史（追加式）

{日期: date, 操作者: str（case_store/律师名/agent 名）, 动作: str, 细节: str}——统一五种旧字段集（action/更新原因/备注/版本 语义并入 动作/细节）。

3. v3.0 → v4.0 章节处置表（模板升级与 B 类直迁依据）

4. 存量格式 → v4.0 映射要点（M4 迁移依据）

迁移安全：--dry-run 输出前后 diff；原文件改 .legacy 归档不删；迁移前 git tag。

5. 校验规则（case_store validate 依据）

1. 必填字段齐全且类型正确；枚举值在 §2 定义范围内
2. 所有日期匹配 ^\d{4}-\d{2}(-\d{2})?$；金额为数值
3. 每个列表行含合法 source；任务 id 全局唯一
4. 程序阶段锁定=true 时记录最后修改者为 user
5. 无绝对路径（^/ 或盘符开头即报错）
6. 生命周期状态=已结案 的案件：提示确认（只应经手工操作产生）

6. 最小完整示例

模板版本: "4.0"
meta:
  案件短码: "260101"
  目录标识: "260101 张三与李四民间借贷纠纷"
  律所案号: null
  法院案号: null
  创建日期: "2026-01-01"
案件基本信息:
  案件名称: "张三与李四民间借贷纠纷案"
  案由: "民间借贷纠纷"
  案件类型: "民事"
  管辖法院: "某某市某某区人民法院"
  生命周期状态: "进行中"
  程序阶段: "诉前准备"
  程序阶段锁定: false
  律所立案日期: "2026-01-01"
  法院立案日期: null
  预计结案: null
  标的额: 500000
  标的额备注: "借款本金及利息"
当事人与代理:
  我方当事人:
    - 姓名: "张三"
      角色: "原告"
      类型: "自然人"
      证件号码: null
      联系方式: null
      住址: null
      法定代表人: null
      扩展信息: {}
      source: "user"
  对方当事人:
    - 姓名: "李四"
      角色: "被告"
      类型: "自然人"
      证件号码: null
      联系方式: null
      住址: null
      法定代表人: null
      扩展信息: {}
      source: "user"
  律师:
    - {姓名: "杨卫薪", 角色: "主办律师", 执业证号: null, 所属律所: null}
法定期限: []
任务:
  - id: "task_001"
    名称: "起草起诉状"
    状态: "in_progress"
    优先级: "high"
    截止日期: null
    负责人: "Writer"
    描述: "借款返还之诉"
    source: "ai"
案件时间线:
  - {日期: "2026-01-01", 事件类型: "律所立案", 事项: "接受委托建档", 重要程度: 2, 来源文件: null, 状态: "done", source: "user"}
证据索引:
  - {名称: "借款合同", 类型: "书证", 来源: "原告提供", 证明目的: "借贷关系成立", 状态: "done", 目录位置: "05 - 📎 证据材料/", source: "user"}
费用信息:
  支出:
    律师费: {金额: null, 状态: "待确定"}
    诉讼费: {金额: null, 状态: "待确定"}
    鉴定费: {金额: null, 状态: "待确定"}
    其他费用: {金额: null, 状态: "待确定"}
  索赔与评估:
    - {项目: "借款本金", 金额: 500000, 计算方式: null, 备注: null}
争议焦点与法律研究:
  争议焦点:
    - {名称: "利息约定效力", 状态: "in_progress"}
  法律研究: []
工时统计: {总工时: 0}
上下文:
  叙事文档: "../案件信息.md"
  工时记录: null
  关键报告: []
同步: {最后同步时间: "2026-08-14T22:00:00", 材料指纹: null, 状态过期: false}
更新历史:
  - {日期: "2026-08-14", 操作者: "new-case", 动作: "创建档案", 细节: "v4.0 模板生成"}

注：示例中顶层 模板版本 与 meta 分立仅为示意——实现时 模板版本 归入 meta 首字段（见 §2.1），yaml 键序以 new-case 模板为准。

7. 类型档案（Profile）与非诉扩展机制

问题：律师业务不止诉讼（new-case 已有 商标/专利/咨询 预设），但各领域字段差异大（商标要申请号/类别/续展，专利要年费/审查阶段），诉讼核心字段（审级/开庭/争议焦点）对非诉无意义。

机制（三层，借鉴 CaseBoard 的 case_type 二分 + 我们的字段准入原则）：

1. core 层（§1 表标注 core/对抗性的节）：一切案件必填——meta（含 业务领域 路由键）、案件基本信息（生命周期状态通用；程序阶段按档案取枚举）、当事人与代理（我方=客户方）、任务、时间线、费用、上下文、扩展信息、同步、更新历史。
2. 类型档案：每个非诉领域的专属字段定义为其档案，落 case-progress/references/profiles/<领域>.md（如 trademark.md），内容 = 该领域的 扩展信息.命名空间 字段表 + 程序阶段枚举 + 额外节定义；惰性立项——某领域第一个真实项目接入 case.yaml 时才创建档案，字段必须逐一过字段准入原则（有消费者才收录），不做投机设计。
3. 配套演进：new-case 对应预设升级为生成 core + 扩展信息.<领域> 骨架；case_store 的 validate 按业务领域加载对应档案校验；dashboard 对未知领域节做通用渲染（key-value 表格降级）。

接入流程（以商标为例）：新建商标项目（new-case trademark 预设）→ 发现无 trademark 档案 → 按该项目真实材料起草 profiles/trademark.md（走本 schema 的评审）→ new-case 模板补骨架 → 完成。存量诉讼案件不受影响（业务领域=诉讼，litigation 节生效）。

8. 材料盘点驱动的增补记录（2026-08-14，v4.0 同日未发布增补）

对 8 个真实案件目录全量盘点（逐案证据与案号留消费项目私有仓库，不入本公开契约）+ CaseBoard 字段对照后的增补：新增节：关联案件[]（前置案件作证据/撤诉后另诉/并行调解子程序）、审级记录[]（多审级多案号）、开庭与听证[]（多轮庭审/听证传票含时间地点法庭号）、扩展信息（非诉容器）、其他诉讼参与人[]（追加第三人/对方代理人）；字段增补：meta.业务领域、程序阶段加 侦查/审查起诉（刑事案件）、律师费.计费方式（风险代理/分阶段）、证据索引.取证方式（可信时间戳）。刻意不入库（保持状态/叙事/文件三分离）：鉴定材料与音视频文件的组织（目录治理）、送达与邮寄凭证（文件级）、IDLE_HANDOFF 自动化状态（idle-task-runner 运行时）、执行追踪与邮寄记录（CaseBoard 有，当前无真实材料需求，留给 profile 惰性定义）。

变更记录