evidence-catalog-generator

name	evidence-catalog-generator
description	Organize user-provided evidence materials into evidence catalog entries and fill them into a user-provided or generic DOCX template. The public version contains no real case template, parties, docket numbers, facts, amounts, addresses, or local file paths.

Evidence Catalog Generator / 证据目录生成器

根据用户提供的证据材料、材料清单或已整理条目，先整理成证据目录条目，再填入用户提供的 .docx 模板；没有模板时，生成一个通用证据目录 Word 文档。公开版只保留通用结构和脚本，不随仓库分发真实案件模板或真实示例数据。

Organize user-provided evidence materials or item lists into catalog entries, then fill them into a user-provided .docx template. If no template is provided, generate a generic evidence catalog DOCX. The public version contains only generic workflow and code, with no real case template or real sample facts.

Use When / 适用场景

• 用户有一组证据材料、文件名、材料清单或证据条目，需要整理为 Word 证据目录。
• 用户提供了机构、课程、法院或团队自己的 .docx 模板。
• 用户没有模板，但接受生成一个通用占位版证据目录。
• 需要把 CSV、JSON 或 XLSX 中的证据条目批量写入表格。

Use when the user has evidence materials or item lists and wants them organized into a DOCX evidence catalog, either with their own template or with a generic placeholder document.

Privacy Rules / 隐私规则

• 不得使用维护者本地模板、真实案件模板或历史示例作为默认模板。
• 不得写死真实姓名、案号、项目名、地址、金额、账号、本机路径、公司名称或其他案卷指纹。
• 示例只能使用明显占位符，例如 [证据名称]、[证据来源]、[证明事项]、[页码]。
• 如果用户未提供字段，保留 [待补: 字段名]，不要猜测。
• 生成前提醒用户检查其模板 metadata，避免把真实作者、单位、修订记录或自定义属性带入公开文件。

Required Inputs / 必要输入

1. 用户提供的证据材料、文件名列表、材料说明，或已整理的 CSV、JSON、XLSX 条目表。
2. 输出 .docx 路径。
3. 可选：用户自己的 .docx 证据目录模板。
4. 可选：标题、案件名称、案号、提交主体、提交日期。

Data Schema / 数据结构

整理后的每条证据建议包含这些字段：

Field	中文字段	Required	Placeholder if missing
number	编号	no	自动连续编号
name	证据名称	yes	[待补: 证据名称]
source	证据来源	no	[待补: 证据来源]
purpose	证明事项 / 证明目的	yes	[待补: 证明事项]
pages	页码 / 页数	no	[待补: 页码]

See references/data_schema.md for the full mapping.

Workflow / 工作流程

1. 检查用户提供的材料和模板，不复用本地私有模板。
2. 将材料整理为证据条目：编号、证据名称、证据来源、证明事项、页码。
3. 对缺失信息使用 [待补: 字段名]，不替用户猜事实。
4. 如果提供模板，替换模板中的占位符并写入第一张证据目录表。
5. 如果没有模板，生成一个纯占位的通用证据目录。
6. 输出后给用户一份检查清单：缺失字段、模板 metadata、页码、表格行数。

Script Usage / 脚本用法

python3 scripts/generate_catalog.py \
  --input path/to/evidence_items.csv \
  --output path/to/evidence_catalog.docx \
  --title "证据目录" \
  --case-name "[案件名称]" \
  --docket-number "[案号]" \
  --submitter "[提交主体]" \
  --submit-date "[提交日期]"

使用用户模板：

python3 scripts/generate_catalog.py \
  --input path/to/evidence_items.json \
  --template path/to/user-template.docx \
  --output path/to/evidence_catalog.docx

The script requires python-docx. XLSX input additionally requires openpyxl.

File Structure / 文件结构

evidence-catalog-generator/
├── SKILL.md
├── references/
│   └── data_schema.md
└── scripts/
    └── generate_catalog.py