SZZZ Case Study Lite|案例分析技能
SZZZ Case Study Lite 基础版。用于对用户已有的本地 PDF、DOCX、DOC 民事裁判文书执行批量提取、案号去重、增量入库、逐案专家摘要、Master Report、案例库问答和原文回溯。用户要求分析判决书、整理本地案例库、追加新案例或向已提取材料提问时使用;不包含外部案例检索和 Obsidi... Skill: SZZZ Case Study Lite|案例分析技能 Owner: szzzcode Summary: SZZZ Case Study Lite 基础版。用于对用户已有的本地 PDF、DOCX、DOC 民事裁判文书执行批量提取、案号去重、增量入库、逐案专家摘要、Master Report、案例库问答和原文回溯。用户要求分析判决书、整理本地案例库、追加新案例或向已提取材料提问时使用;不包含外部案例检索和 Obsidi... Tags: latest:3.0.1 Version history: v3.0.1 | 2026-07-23T03:13:00.723Z | user 同步 Lite v3.0.1:完善本地案例库流程、增量去重、材料追问与 DOC 支持;补充八股仙人作者介绍,并统一为基础版命名。 v1.2.1 | 2026-04-02T07:10:41.445Z | user v1.2.1: 更新技能显示名称
Rank
62
Safety
84
Downloads
1.9k
Updated
Oct 9, 2026
Version
3.0.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.9K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 1.9K downloadsadoption · observed Oct 9, 2026
- Latest release
- 3.0.1release · observed Jul 23, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: medium.
clawhub skill install s17f4fw36493ycafm4dtns9vh583psmg:szzz-case-study-lite- Python environment detected. Create a strict virtual environment (`python -m venv .venv`) before installing dependencies to prevent system-level package conflicts.
- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-szzzcode-szzz-case-study-lite/snapshot"
Documentation
CLAWHUB
43,787 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: szzz-case-study-lite description: SZZZ Case Study Lite 基础版。用于对用户已有的本地 PDF、DOCX、DOC 民事裁判文书执行批量提取、案号去重、增量入库、逐案专家摘要、Master Report、案例库问答和原文回溯。用户要求分析判决书、整理本地案例库、追加新案例或向已提取材料提问时使用;不包含外部案例检索和 Obsidian 导出。 --- # SZZZ Case Study Lite|案例分析技能 ## 作者 八股仙人,长期关注法律实务、文档自动化与 AI 工作流,分享面向中文法律文本处理的工具和方法。 小红书 @八股仙人|AI工作流<br> 微信公众号 @八股仙人<br> 微博 @八股仙人AI 把用户已有的本地裁判文书整理为准确、可溯源、可持续增量更新的案例库。 ## 执行协议 不要自行另写临时代码扫描或统计文件。提取、去重、进度和数量对账均以 `scripts/main.py` 为准。 运行脚本时,将工作目录设为本 `SKILL.md` 所在的技能目录。不要假定技能安装在 `~/.claude`;以下相对路径适用于任意安装位置。 ### Step 1:扫描与建库 用户提供包含 `.pdf`、`.docx` 或 `.doc` 的文件夹后,运行: ```bash python3 scripts/main.py init "[项目路径]" ``` PDF 保留页码标记;DOCX 直接提取;DOC 在 macOS 使用 `textutil`,其他系统优先使用 LibreOffice。转换器不可用或提取为空时,如实报告,不生成空白 raw 文件。 ### Step 2:去重与纳入范围 `init` 自动执行: - 对民事判决书、民事裁定书按“案号 + 文书类型”去重; - 纳入执行异议、案外人异议、执行复议等实质争议类执行裁定; - 纳入典型案例、指导性案例、裁判要旨等参考材料; - 无标准案号时使用正文相似度辅助去重; - 把重复、范围排除和提取失败情况写入 `law_analysis_results/dedup_report.txt`。 ### Step 3:逐案专家摘要 初始化后运行: ```bash python3 scripts/main.py focus "[项目路径]" ``` 每批只处理脚本派发的材料。读取 `prompts/analyzer-logic.md`,穷尽原文中的全部争议焦点,逐份生成摘要。 摘要必须: - 保存到 `law_analysis_results/individual_cases/`; - 使用 `案号-文书类型-当事人简称-案由-摘要.md`; - 无法确认的信息写“原文未披露”,不得推测; - 每批落盘后再次运行 `focus`,直到脚本明确提示队列清空。 ### Step 4:三个后续方向 队列清空并完成数量对账后,先阅读全部单案摘要,提炼三个高频、重要的争议焦点 A、B、C,再向用户提供: 1. 提供具体案情或问题,从案例库检索并在必要时回溯原文; 2. 从 A/B/C 中选择一个,作为 Master Report 的重点专题; 3. 提供自定义报告关键词。 不要默认直接生成 Master Report。 ### Step 5:Master Report 用户确认专题后运行: ```bash python3 scripts/main.py report "[专题词]" "[项目路径]" ``` 读取脚本生成的 `master_data.json`、全部单案摘要及 `prompts/master-report-logic.md`,生成与 Pro 相同结构、带案号来源的实务报告,并保存为: ```text law_analysis_results/Master_Report.md ``` ## 增量处理 既有项目加入新文书后再次运行 `init`。如果发现唯一的新材料,立即运行: ```bash python3 scripts/main.py focus_incremental "[项目路径]" ``` 持续处理到增量队列清空。汇报时必须分别说明“本轮增量数量”和“全库累计数量”。增量完成后,除三个常规方向外,还应提供“只围绕本轮增量案件提问”的选项;除非用户要求,不扩大到全库。 ## 既有案例库问答 用户向已提取材料提问时,按问题精度逐层回溯: 1. **宏观统计、趋势和分布**:优先读取 `Master_Report.md`;没有报告时汇总 `individual_cases/`。 2. **案件比较、裁判规则和法律适用**:读取相关单案摘要进行交叉分析。 3. **最相似案件、特定事实、抗辩原话、证据或日期金额**:必须读取对应 `source_texts/*-raw.md`,不能只依赖摘要。 回答采用“结论—原文证据对齐—实务评论”结构,明确说明来自哪份摘要或 raw 原文。摘要与 raw 不一致时以 raw 为准;原文没有披露时明确回答“判决书原文未披露此细节”。 再次运行 `init` 且没有新材料时,向用户提供:案例库问答、重写 Master Report、结束本轮或明确确认后重置。 ## 功能边界 Lite 只处理用户已有的本地材料,不调用元典或其他外部案例库,也不写入 Obsidian Vault。需要外部类案检索、动态选案、元典归档或 Obsidian 知识库时,使用 SZZZ Case Study Pro。
README.md
# SZZZ Case Study Lite|案例分析技能
八股仙人,长期关注法律实务、文档自动化与 AI 工作流,分享面向中文法律文本处理的工具和方法。
小红书 @八股仙人|AI工作流<br>
微信公众号 @八股仙人<br>
微博 @八股仙人AI
SZZZ Case Study Lite 是一个免费的本地民事裁判文书研究工具。它可以把用户已有的案例材料整理成可检索、可更新、可回溯原文的本地案例库。
**当前版本:v3.0.1**
## 特色功能
这不只是一个生成摘要的工具,而是一套从材料整理到持续维护的本地案例研究流程。
```mermaid
flowchart LR
A[导入案例材料] --> B[文本提取]
B --> C[识别与去重]
C --> D[单案专家摘要]
D --> E[专题分析报告]
E --> F[追问与原文回溯]
F --> G[补充新案例]
G --> C
```
| 特色能力 | 可以做什么 |
|---|---|
| 完备的摘要体系 | 从案情和诉辩,到争议焦点、裁判逻辑、裁判结果与实务提示,形成统一的单案摘要 |
| 完整的研究流程 | 串联提取、去重、逐案分析、专题报告、追问和原文核对 |
| 多格式材料提取 | 批量处理 PDF、DOCX 和旧式 DOC,并为 PDF 保留页码标记 |
| 重复案例排除 | 按“案号 + 文书类型”去重,无标准案号时辅助进行正文相似去重 |
| 追问与进度看板 | 继续比较案件、核对具体事实,并查看全库、已完成、待处理和待启动增量数量 |
| 增量分析与维护 | 随时补充新案例,只处理新增材料,逐步沉淀为可持续维护的本地案例库 |
整个流程只处理用户提供的本地文件,不自动联网检索案例。
## 安装
仓库可以放在任意目录,不要求安装到 `~/.claude`。先克隆仓库并安装 Python 依赖:
```bash
git clone https://github.com/szzzcode/szzz-case-study-lite.git
cd szzz-case-study-lite
python3 -m pip install -r scripts/requirements.txt
```
Windows 环境如果没有 `python3` 命令,可以把上述命令及下文命令中的 `python3` 改为 `python`。
### 在不同 AI 工具中使用
脚本本身不依赖 Claude、Cursor、WorkBuddy 或其他特定 AI 工具。不同工具的技能目录和导入方式可能不同:
- 如果工具支持读取 `SKILL.md`,按照该工具的说明,把整个仓库放入或导入其技能目录;
- 如果工具暂不支持 `SKILL.md`,仍然可以直接运行下面的 Python 命令,再让 AI 读取生成的摘要、报告和 raw 原文;
- 不要只复制 `SKILL.md`,脚本和 `prompts/` 模板也需要保留在仓库中。
## DOC 支持
- macOS:使用系统自带的 `textutil`,通常不需要额外安装;
- Windows/Linux:需要安装 LibreOffice,并确保 `soffice` 或 `libreoffice` 命令位于 PATH;
- 转换器不可用或转换失败时,系统会明确报告,不生成空白文本。
扫描型 PDF 需要先进行 OCR,否则可能无法提取正文。
## 使用
以下命令默认在仓库根目录运行。
首次扫描、提取和去重:
```bash
python3 scripts/main.py init "[案例文件夹]"
```
逐案摘要:
```bash
python3 scripts/main.py focus "[案例文件夹]"
```
加入新文件后,再次执行 `init`。检测到增量材料时运行:
```bash
python3 scripts/main.py focus_incremental "[案例文件夹]"
```
用户确认报告方向后:
```bash
python3 scripts/main.py report "[专题词]" "[案例文件夹]"
```
查看处理进度:
```bash
python3 scripts/main.py next "[案例文件夹]"
```
## 输出结构
```text
案例文件夹/
└── law_analysis_results/
├── status.json
├── dedup_report.txt
├── source_texts/
│ └── 原文件名-raw.md
├── individual_cases/
│ └── 案号-文书类型-当事人简称-案由-摘要.md
├── master_data.json
└── Master_Report.md
```
## 摘要完成后的三个方向
1. 提供具体案情或问题,从既有案例库检索并在必要时回溯 raw 原文;
2. 从系统归纳的三个高频争议焦点中选择一个,生成 Master Report;
3. 提供自定义报告关键词。
向案例库提问时,宏观问题可以先读取 Master Report,案件比较读取单案摘要,涉及特定事实、证据、金额或日期时应回到 `source_texts/*-raw.md` 核对。
## 多工具使用提醒
同一份仓库可以被不同 AI 工具读取,不会因为使用 Cursor、WorkBuddy 或 Claude 而改变案例数据。但不要让两个工具同时处理同一个案例文件夹,以免它们同时更新 `status.json`。
不同案例文件夹可以分别处理,互不影响。
## 重要提醒
本工具生成的内容用于辅助法律研究。案号、金额、裁判结果、证据原话和法律依据应回到 raw 原文核对。裁判文书没有披露的信息,不应由模型推测补充。
## 许可
本项目采用 MIT License。英文法律文本及中文参考译文见 [LICENSE](./LICENSE)。
## Lite 与 Pro
Lite 是免费公开版,提供完整的本地案例研究流程;Pro 在此基础上增加元典外部类案检索、动态选案、归档校验和 Obsidian 案例知识库等专业功能。_meta.json
{
"ownerId": "kn78hvtf4bv7xe2va6xqtejtps833bha",
"slug": "szzz-case-study-lite",
"version": "3.0.1",
"publishedAt": 1784776380723
}scripts/requirements.txt
# SZZZ Case Study Lite - Python 依赖 # 安装方法:python3 -m pip install -r requirements.txt # PDF 解析 pdfplumber>=0.10.0 # DOCX 文档读取 python-docx>=0.8.11 # 旧式 DOC:macOS 使用系统 textutil;其他系统需另行安装 LibreOffice。
CHANGELOG.md
# SZZZ Case Study Lite 更新日志 ## v3.0.1 - 2026-07-20 - README 新增作者介绍和社交平台信息,并把 Lite/Pro 简要区别移至结尾。 - `SKILL.md` 补充“八股仙人”作者介绍和社交平台信息,便于在 ClawHub 页面直接展示。 - 技能展示名称统一为“SZZZ Case Study Lite|案例分析技能”,并将版本称呼统一为“基础版”。 - README 改用可在任意目录运行的通用安装与使用命令。 - 新增 Claude、Cursor、WorkBuddy 等多工具使用说明和同项目并发提醒。 - 脚本改为根据自身位置定位依赖、提示模板和后续命令,移除 `~/.claude` 硬编码。 - `SKILL.md` 改用相对于技能根目录的脚本路径。 - LICENSE 保留英文 MIT 原文并追加中文参考译文。 ## v3.0.0 - 2026-07-19 - 单案摘要模板和 Master Report 模板与 SZZZ Case Study Pro 保持一致。 - 新增 `main.py` 总控脚本和 `law_analysis_results/` 项目结构。 - 新增案号 + 文书类型去重、无标准案号正文相似去重和去重报告。 - 新增 `status.json`、增量侦测、增量摘要队列和全库数量对账。 - 摘要完成后提供案例库问答、三大高频焦点报告和自定义关键词三个方向。 - 新增既有材料分层问答规则;精确事实和证据问题必须回溯 raw 原文。 - 正式支持旧式 DOC:macOS 使用 `textutil`,其他系统使用 LibreOffice。 - Lite 与 Pro 的边界调整为“完整本地闭环”与“外部检索、Obsidian 增强”。 ## v2.0.0 - 2026-07-19 - 项目和技能统一更名为 `szzz-case-study-lite`。 - `SKILL.md` 改用精简、标准的技能元数据,并明确 Lite/Pro 功能边界。 - PDF 提取文本增加页码标记,方便摘要回到原文核对。 - 修正旧版误将 `.doc` 当作 `.docx` 读取的问题;现在会提示先转换格式。 - 文本为空、扫描件或文件损坏时不再生成空白 TXT。 - 批量文件按名称稳定排序,并改进错误提示和退出状态。 - 同名 PDF、DOCX 同时存在时使用格式后缀,避免提取结果相互覆盖。 - 增加 MIT 许可证。 ## v1.2.1 - 2026-04-02 - Judgment Analyzer 历史版本。 - 支持本地 PDF、Word 文本提取、逐案摘要和批量综合报告。
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/szzzcode/skills/szzz-case-study-lite",
"sourceUrl": "https://clawhub.ai/szzzcode/skills/szzz-case-study-lite",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T23:08:42.516Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-szzzcode-szzz-case-study-lite/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-szzzcode-szzz-case-study-lite/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T23:08:42.516Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.9K downloads",
"href": "https://clawhub.ai/szzzcode/szzz-case-study-lite",
"sourceUrl": "https://clawhub.ai/szzzcode/szzz-case-study-lite",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T23:08:42.516Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "3.0.1",
"href": "https://clawhub.ai/szzzcode/szzz-case-study-lite",
"sourceUrl": "https://clawhub.ai/szzzcode/szzz-case-study-lite",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-23T03:13:00.723Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-szzzcode-szzz-case-study-lite/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-szzzcode-szzz-case-study-lite/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 3.0.1",
"description": "同步 Lite v3.0.1:完善本地案例库流程、增量去重、材料追问与 DOC 支持;补充八股仙人作者介绍,并统一为基础版命名。",
"href": "https://clawhub.ai/szzzcode/szzz-case-study-lite",
"sourceUrl": "https://clawhub.ai/szzzcode/szzz-case-study-lite",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-23T03:13:00.723Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
