| 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 新增）
- 材料性质先确认：生成/编辑案件证据目录前先确认材料性质（案件材料 or 公开资料）；案件材料一律本地处理，不上传外部服务。
raw/ 只读：原始材料目录只读不修改，不得在原始材料目录覆盖或写入文件；输出到独立目录。- 目录整理 ≠ 证明力评价：本技能只整理目录，不做证明力评价、法律定性和法条检索；但可记录「用户主张的证明目的」（标注为当事人主张）。
- 状态字段：每条证据增加状态字段：
来源已见 / 仅文件名 / 待核对 / 页码待补。
- 输出可追溯：输出文件路径、版本、模板来源和 metadata 检查结果；重跑版本递增。
- 不擅自读取真实案件文件：没有用户要求时不自动读取或上传真实案件文件；用户未提供材料时用占位符生成。
- 与 docx-editing 对接带版本：生成 DOCX 后交给 docx-editing 做格式或复核时，必须携带文件版本，防止旧版被误改。
Required Inputs / 必要输入
- 用户提供的证据材料、文件名列表、材料说明，或已整理的 CSV、JSON、XLSX 条目表。
- 输出
.docx 路径。
- 可选：用户自己的
.docx 证据目录模板。
- 可选：标题、案件名称、案号、提交主体、提交日期。
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 / 工作流程
- 检查用户提供的材料和模板，不复用本地私有模板。
- 将材料整理为证据条目：编号、证据名称、证据来源、证明事项、页码。
- 对缺失信息使用
[待补: 字段名]，不替用户猜事实。
- 如果提供模板，替换模板中的占位符并写入第一张证据目录表。
- 如果没有模板，生成一个纯占位的通用证据目录。
- 输出后给用户一份检查清单：缺失字段、模板 metadata、页码、表格行数。
- 末尾提示用户：如需修改目录中的具体条目、调整格式或添加批注，可让我用 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
