Skip to content

CSlawyer1985/legal-skillhub / skills/ai-legal-case-workflow

ai-legal-case-workflow

Verified

由程建都律师基于一线诉讼办案流程开发的中国民事诉讼 AI 协作技能,面向执业律师和诉讼团队,覆盖民事一审 1–7 七阶段与民事二审 A0–A6 专门路径(判决上诉与三类受控裁定上诉)。适用于读取卷宗、建立事实时间线和证据矩阵,分析诉讼时效、管辖、保全、费用及上诉期限,形成起诉状、答辩状、上诉状、证据目录、质证意见、庭审提纲、客户报告和交付归档底稿;支持原告、被告、上诉人、被上诉人及多方上诉场景,并可按阶段局部执行。它不是单一文书生成提示词,而是一套将材料读取、证据分析、策略形成、文书组建和质量检查组织为可复用、可追溯闭环的 AI 辅助办案工作流。刑事、行政、再审、执行、无具体材料的纯咨询、利益冲突及结果承诺不适用;涉外、港澳台、知识产权、海事海商和破产衍生诉讼仅做识别、风险提示与专项核验闸门。所有输出均为律师工作底稿,不能替代原件核对、现行法核验和执业律师最终判断。

references/usage-and-faq.md

View on GitHub
# 使用示例、反模式与常见问题

首次使用、需要判断是否适用、出现误用风险或需要解释使用方式时,读取本文件。

## 目录

- [触发示例](#触发示例说什么话激活本技能)
- [反模式](#反模式禁止事项)
- [常见问题](#常见问题faq)
- [完整输出样例](#完整输出样例)
- [实战案例参考](#实战案例参考)

## 触发示例(说什么话激活本技能)

以下用户原话均可触发本技能,覆盖各阶段入口。如果拿不准怎么说,直接用最自然的表达即可。下面列出常见问法和变体供参考。

### 全流程启动类

这些表达会从头启动全部流程:

- "帮我分析这个案件卷宗,材料在 XX 文件夹,我是原告方"
- "我要起诉一个买卖合同纠纷,帮我从头到尾准备材料"
- "对方把我告了,帮我应诉"
- **更多变体**:
  - "我有个合同纠纷的案子,客户给了一堆材料,你先帮我看看"
  - "这个案子的材料都在这个文件夹里,帮我梳理一下案情"
  - "刚接了一个案子,我需要准备应诉,从哪里开始?"
  - "一审判决刚送达,我代理原告,帮我核对期限并准备上诉"
  - "对方已经上诉,我方需要准备二审答辩"

### 单阶段入口类(含变体)

如果案件已经到某个阶段,可以直接用对应阶段的关键词切入,不需要从头执行。

**阶段1(诉前分析)**
- "帮我分析这个案件卷宗"
- 变体:"这个案子材料很多,帮我理一下时间线和争议焦点" / "先帮我看看材料,评估主要胜败风险"

**阶段2(主体核查)**
- "查一下被告 XX 公司的涉诉情况和财产线索"
- 变体:"帮我做一下对方公司的背景调查" / "评估一下被告有没有可执行的财产" / "查查这公司的底,看是不是空壳"

**阶段3(起诉材料,仅原告方)**
- "帮我写起诉状和证据目录"
- 变体:"我要立案了,帮我准备立案材料包" / "帮我起草起诉状,再把证据整理一下" / "诉讼请求怎么写,帮我设计一下"

**阶段4(反诉分析)**
- "对方反诉了,帮我分析反诉的请求权基础"
- 变体:"对方答辩状到了,逐条帮我分析一下" / "对方提了反诉,看看他有哪些站不住脚的地方"

**阶段5(应诉材料包)**
- "帮我写答辩状,核实里面引用的法条"
- 变体:"准备应诉材料,答辩状+证据目录+法条核实都要" / "帮我整理一套完整的应诉材料"

**阶段6(庭审)**
- "明天开庭,帮我准备庭审提纲和发问提纲"(庭前)
- "庭审记录在这里,帮我写庭后代理意见"(庭后)
- 变体:"快开庭了,帮我列个开庭提纲" / "庭审结束了,法官要求庭后提交代理词"

**阶段7(格式交付)**
- "把这些文书转成 Word 格式交法院"
- 变体:"帮我生成交法院的正式文书" / "给客户出一个简化版报告" / "按归档标准整理一下文件"

### 二审阶段组入口类

**A0(入口、期限与费用)**
- "一审判决刚收到,先核对能不能上诉、期限和上诉费"
- 变体:"这是管辖权异议裁定,帮我检查裁定上诉期限" / "两家公司都上诉了,分别核对提交和缴费状态"

**A1–A3(裁判拆解、上诉审计与增量)**
- "把一审判决的败诉理由、证据采信和法律适用逐项拆开"
- "对方上诉状到了,逐项分析并建立二审应对策略"
- "二审发现一份新证据,评估能否提交以及还缺什么"

**A4–A6(文书、审理和交付)**
- "根据已确认的上诉请求起草民事上诉状和证据目录"
- "二审马上开庭,准备争点、发问和新证据质证提纲"
- "二审判决已经送达,做原审与二审裁判对比和客户报告"

### 不适用场景(不会触发或应拒绝)

- 刑事案件、行政案件("帮我分析这个刑事案卷" → 拒绝,本技能仅覆盖民事)
- 民事再审和执行不进入本版专门路由;可以使用材料读取、时间线、证据矩阵和一般争点分析等通用辅助,但必须说明边界
- 二审模块只处理民事判决上诉和不予受理、管辖权异议、驳回起诉三类通常可上诉裁定;其他裁定及专项救济不套用普通上诉模板
- 法律咨询但无具体案件材料("我有一个法律问题想咨询" → 可直接回答,不需走本流程)
- 预测判决结果("帮我预测这个案子能判多少" → 本技能提供策略分析,不做结果预测)
- 代理双方("我同时代理原告和被告" → 拒绝,利益冲突)
- 非法律任务("帮我写个合同" → 仅起草/审核合同不是本技能范围,但作为案件证据的合同分析是)

## 反模式(禁止事项)

以下做法会导致严重后果(程序失误、法源错误、数据泄露),必须避免:

| 反模式 | 后果 | 正确做法 |
|--------|------|----------|
| ❌ 凭训练记忆引用法条 | 可能造成法源错误并削弱论证可信度 | 必须通过当前可用的权威来源实时核实,标注核实来源和日期 |
| ❌ 跳过卷宗中"看似不重要"的文件 | 遗漏关键证据(演示案件中通话录音文字版是核心证据) | 阶段1逐份读取全部文件,一个不漏 |
| ❌ 跳阶段执行(如未建立事实底座直接写起诉状或上诉状) | 前序事实锚点缺失,后续文书事实错误 | 一审用 `start_stage`,二审用 `start_phase`;跳转前确认所依赖产出已存在 |
| ❌ 子代理产出未经主代理审核直接采用 | 幻觉内容流入正式文书 | 主代理必须审核并提出具体修改意见,形成闭环 |
| ❌ 未经分级、授权和链路审查就把真实案件材料交给外部模型 | 可能违反律师保密义务并造成越权处理 | 按绿色、黄色、红色、红线四级边界审查;红线数据不得进入普通 AI 链路或外部代理 |
| ❌ 混用一审七阶段与二审 A0–A6 路由,或用本技能处理刑事、行政、再审和执行 | 程序期限、角色和模板可能误用 | 先确认 `procedure`;一审与二审参数、流程和模板相互隔离,其他程序只作边界提示 |
| ❌ 没有送达证据就认定上诉截止日 | 裁判日期不等于送达日期,可能造成期限误判 | A0 核验送达证、电子回执或其他原始记录;缺失时保持 `unverified` |
| ❌ 把双方上诉合并为一份轨道 | 请求、期限、费用和答辩关系相互污染 | 为每一份上诉建立独立 `appeal_track`,再运行交叉一致性检查 |
| ❌ 预测或承诺判决结果 | 违反律师执业规范 | 只做策略分析和风险评估,表述为"可能""存在较大空间" |
| ❌ 时效/管辖到立案阶段才发现问题 | 程序性败诉风险,不可逆 | 阶段1的步骤6、步骤7强制完成时效与管辖分析 |
| ❌ MCP 一次失败就切换备选或报错 | 网络抖动被误判为工具不可用 | 先判断重复调用是否安全;平台支持且无重复写入等副作用时,同一调用最多发起3次(含首次)后回退 |
| ❌ 庭审后才考虑调解 | 错失庭前调解最佳时机 | 阶段5的 mediation-assessor 前置完成调解预研 |

### 新手常见错误(不致命但影响效率)

以下做法通常不会导致严重后果,但会让流程不顺畅、产出质量打折:

| 常见错误 | 为什么不好 | 改进方法 |
|----------|-----------|----------|
| ⚠️ 第一次用就要求读完全部参考文件 | 参考文件总量已超过入口文件的数倍,一次读完既慢又挤占上下文 | 只读 `SKILL.md`,再按其中的“参考文件加载表”取当前阶段需要的模块 |
| ⚠️ 不确定该走原告还是被告路径就直接说"帮我办案" | 流程会停下来确认立场,多一轮往返 | 直接说明身份:"我是原告方/被告方" |
| ⚠️ 把所有材料放桌面或散落各处 | AI 找不到材料,反复询问路径 | 集中放入一个文件夹,用绝对路径指定 |
| ⚠️ 跳过阶段1直接写文书 | 缺少事实锚点,写的文书可能和材料对不上 | 至少快速过一遍阶段1(时间线+争议焦点+证据清单) |
| ⚠️ 对 AI 出来的文书直接复制粘贴 | 未标注的疏忽可能成为执业风险 | 人工审核每一处关键事实和法律引用,在文件上标注审核痕迹 |
| ⚠️ 网络慢就反复点击重试 | 可能造成重复查询、重复写入或额外费用 | 先确认上一调用已结束,再按工具重试规则处理 |

---

## 常见问题(FAQ)

**Q1:我没有案件材料,能先咨询个法律问题吗?**
本技能定位是"办案"而非"咨询",需要卷宗材料作为输入。纯法律咨询(如法条解释)可以直接提问,不必走本流程。

**Q2:MCP 工具一个都没连接,还能用吗?**
可以执行不依赖外部查询的材料读取、时间线和证据整理,但阶段2主体核查、法源核实等产出只能标记为 `partial` 或 `blocked`,不能写成完整完成。无法核实的引用统一标注 `【未经工具核实,仅供参考】`。可使用的平台和权威来源不同,不要求固定连接某个产品。

**Q3:案件已经到庭审阶段了,还要从头开始吗?**
不用。一审可以从阶段6、二审可以从 A5 切入,但都要快速检查前序事实、证据和程序底座是否存在。缺失时只补做当前任务依赖的部分,不假装前序质量门已经通过。

**Q4:原告和被告都在办,能用两次吗?**
不能同时代理双方(利益冲突)。本技能的"双路径"指你代理其中一方时选择对应路径。

**Q5:子代理并行会消耗很多 Token 吗?**
会明显增加。实际倍数取决于子任务数量、材料规模和平台实现,未经实测不作固定倍数承诺。简单案件可设 `parallel_enabled=false`,技能在任务不复杂时也会自动串行。

**Q6:AI 写的文书能直接交法院吗?**
不能。AI 产出是工作底稿,必须经执业律师审核、修改、签发。法源核实报告可以辅助校对,但不免除律师的审查义务。

**Q7:材料里有音视频文件怎么办?**
先转文字(本地工具优先,如 whisper),转写文本放入卷宗文件夹,阶段1会读取并标注关键时间段。

**Q8:技能输出和客户数据存在哪里?**
全部产出写入你指定的项目目录,技能本身不存储任何案件数据。对话内容遵循所用模型提供方的数据政策。

**Q9:用这个技能和直接跟 AI 聊天有什么区别?**
直接聊天需要你手动组织每一步("先读文件A→提取时间线→查被告工商→写起诉状→核实法条"),容易遗漏步骤。技能把这些步骤编排成标准化流程,根据任务复杂度和平台能力选择串行或并行,并附质量控制检查清单。平台不支持子代理、外部工具或格式转换时,技能会如实降级并标记未完成事项,不虚构自动化能力。

**Q10:阶段产出能直接复制粘贴用吗?**
不建议。AI 产出是工作底稿,必须经执业律师审核。建议把 AI 产出的文书作为初稿,在上面标注修改意见后定稿。即使法源核实报告来自实时检索,也仍须回看原始法源并核对效力状态;证据对应关系和事实陈述同样需要人工复核。

**Q11:我怎么知道该走哪条路径?**
先看审级。一审使用 `procedure=first_instance`,再按原告或被告选择路径。二审使用 `procedure=second_instance`,同时记录原审地位和本方是上诉人、被上诉人或双轨处理。不能同时代理利益冲突双方。

**Q12:技能后续会更新吗?怎么获取最新版本?**
技能采用三级版本号(vX.Y.Z)。当前版本为 v2.5.1,在 v2.5.0 民事二审 A0–A6 专门路径和一审七阶段基础上,适度增强 WorkBuddy 首屏摘要,不改变功能与法律规则。更新日志见技能目录下的 CHANGELOG。重新安装完整技能包即可更新,必须同时保留 `SKILL.md` 与 `references/` 的相对路径。

**Q13:是不是一定能直接生成 Word 和 PDF?**
不是。Markdown 是默认降级格式;DOCX、PDF、HTML 或图片是否能生成,取决于当前平台是否具备并允许使用相应工具。技能只有在文件实际生成并完成打开、回读或渲染检查后,才能声明该格式交付成功;否则应保留 Markdown 或其他可验证版本,并把状态标为 `partial`。

**Q14:任何民事裁定都能用二审模块上诉吗?**
不能。本版裁定上诉子路径只覆盖不予受理、管辖权异议和驳回起诉三类通常可上诉裁定。其他裁定可能适用复议、复核或特别规则,必须进入专项核验,不能套用普通裁定上诉状。

**Q15:SkillHub 评分会不会改变法律质量标准?**
不会。TRACE 评测只作为发现薄弱项的外部信号。可以通过增加真实闭环、示例、失败恢复和场景验证优化评分,但不得删除安全边界、夸大能力或以评分替代现行法和律师复核。

---

## 完整输出样例

如果想先看“实际产出长什么样”,读取 `references/complete-output-example.md`。该文件使用全虚构买卖合同欠款纠纷,完整展示:

- 用户输入和材料清单;
- 阶段1案件概要、时间线、证据矩阵、风险预检和律师裁决点;
- 阶段3起诉状与对外证据目录草稿;
- `completed`、`partial` 等运行状态如何使用;
- 法源工具失败后如何保留已完成内容、报告未核事项并从指定步骤恢复。

样例用于复用结构,不得把虚构事实、金额、日期或结论复制到真实案件。

二审输入、上诉轨道、策略选项、边界阻断和 T1–T8 场景验收见 `references/appeal-case-examples.md`。

---

## 实战案例参考

本技能基于一起已脱敏的设备买卖合同纠纷演示案件(甲设备公司 vs 乙能源公司)开发和验证。该案件完整跑通了被告方应诉路径(阶段1→2→4→5→6→7),主要数据:

- **卷宗规模**:11 份原始材料(含 PDF 扫描件、通话录音转写文本)
- **实际产出**:案件概要报告(含时间线/争议焦点/策略建议)、26 维度主体核查报告、5 份应诉材料(答辩状/证据目录/法源核实/对抗复核/总目录)、3 份庭审文书(分析报告/代理意见/调解建议)
- **并行效率**:该次演示记录中,阶段5六子代理并行相比串行约节省 60% 时间;该数值仅反映单次案例,不构成通用性能承诺
- **关键验证点**:法源核实报告曾发现 1 处凭记忆引用的法条版本错误,验证"禁止凭记忆引用"规则的必要性

已脱敏执行复盘和真实片段见 `references/case-study.md`;可连续阅读的完整虚构输出见 `references/complete-output-example.md`。前者用于理解真实执行经验和效果边界,后者用于理解文档结构和失败恢复方式。

---
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall