evidence-catalog-generator

name	evidence-catalog-generator
description	当用户需要【把证据材料整理成证据目录】时使用。触发词：证据目录、理证据、证据整理、材料清单。 输出：结构化证据目录（每组：名称/来源/证明对象）。不做：法律定性、证明力评价、法条检索。

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，避免把真实作者、单位、修订记录或自定义属性带入公开文件。

案件材料纪律（2026-08-22 新增）

1. 材料性质先确认：生成/编辑案件证据目录前先确认材料性质（案件材料 or 公开资料）；案件材料一律本地处理，不上传外部服务。
2. raw/ 只读：原始材料目录只读不修改，不得在原始材料目录覆盖或写入文件；输出到独立目录。
3. 目录整理 ≠ 证明力评价：本技能只整理目录，不做证明力评价、法律定性和法条检索；但可记录「用户主张的证明目的」（标注为当事人主张）。
4. 状态字段：每条证据增加状态字段：来源已见 / 仅文件名 / 待核对 / 页码待补。
5. 输出可追溯：输出文件路径、版本、模板来源和 metadata 检查结果；重跑版本递增。
6. 不擅自读取真实案件文件：没有用户要求时不自动读取或上传真实案件文件；用户未提供材料时用占位符生成。
7. 与 docx-editing 对接带版本：生成 DOCX 后交给 docx-editing 做格式或复核时，必须携带文件版本，防止旧版被误改。

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	[待补: 页码]
status	状态（来源已见/仅文件名/待核对/页码待补）	no	待核对

See references/data_schema.md for the full mapping.

Workflow / 工作流程

1. 检查用户提供的材料和模板，不复用本地私有模板。
2. 将材料整理为证据条目：编号、证据名称、证据来源、证明事项、页码。
3. 对缺失信息使用 [待补: 字段名]，不替用户猜事实。
4. 如果提供模板，替换模板中的占位符并写入第一张证据目录表。
5. 如果没有模板，生成一个纯占位的通用证据目录。
6. 输出后给用户一份检查清单：缺失字段、模板 metadata、页码、表格行数。
7. 末尾提示用户：如需修改目录中的具体条目、调整格式或添加批注，可让我用 docx-editing 打开编辑。

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