S6 迎检材料整理 Skill（street-inspection-kit）
街道办迎检是"材料明明做过但找不到"与"缺项到检查当天才发现"的高频痛点。本 Skill 本 Skill 把"检查清单 × 本地材料"二维结构压成一条端到端流水线：清单解析 → 材料索引 → 三档匹配 → 缺项识别 → 对照台账 → 汇报初稿，全程本地处理，所有输出经业务负责人审核定稿。
不可突破的红线
- 不虚构补造材料：缺失只如实列缺项清单，AI 不生成虚假的会议记录、活动照片或工作台账。
- 不替代保密审查：涉及密级文件须按街道保密制度单独流转，Skill 不接触、不传输、不缓存明文。
- 不做检查应对策略：不提供"如何应付检查""如何包装成绩"类建议，只做客观材料归集。
- 不替代业务判断：材料是否符合检查口径、能否作为有效佐证，由业务负责人判断。
- 不做纸质档案数字化：纸质材料扫描录入由人工完成，本 Skill 处理已数字化的材料。
- 不直接对外提交：所有输出为内部备检材料，必须经业务负责人审核定稿。
- 不替生成不存在的历史数据：未匹配材料的检查点，汇报中只生成框架并标【待补充】，不补写。
- 材料库只读：Skill 对原始材料文件只读，不修改、不删除、不移动。
一、核心能力速查
| 功能 | 描述 | 触发关键词 |
|---|---|---|
| 检查清单解析 F1 | 解析 Word/PDF/文字清单，命中 6 大类模板或走通用解析 | 上传清单、解析巡察提纲 |
| 本地材料库 F2 | 扫描本地文件夹、构建 BM25 + 语义向量融合索引 | 构建材料库、索引材料 |
| 匹配与缺项识别 F3 | 三档状态判定 + 责任科室推断 + 缺项清单生成 | 匹配材料、识别缺项 |
| 时效性校验 F6 | 检测过期制度、旧版数据，给出基线比对 | 检查时效、过期提醒 |
| 对照台账 F4 | 按清单顺序生成 Excel 台账，状态颜色 + 图形符号双标识 | 生成台账、导出对照 |
| 汇报初稿 F5 | 按清单结构生成 Word 汇报，附溯源对照表 | 生成汇报、写初稿 |
| 学习闭环 F2.5 | 人工修正本地累积，仅本地存储，绝不进对外模型 | 修正记录、学习 |
| 流水线编排 | F1→F2→F3→F6→F4→F5 一站式 | 一键迎检、跑全流程 |
二、标准工作流程
前置条件
- Python 3.11+
- 操作系统：Windows 10+ / macOS 12+ / 信创 Linux（统信 UOS、麒麟 V10）
- 文件夹：用户指定材料存放目录（只读权限）
- 终端可执行权限（本地 AI BOX / 桌面客户端）
步骤
- 环境初始化
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev,ocr,embed]"
- 构建材料库（一次或定期）
street-inspection init --library-id demo --root /path/to/材料 --ocr-confirmed
- 执行迎检流程
street-inspection run \
--list /path/to/巡察清单.docx \
--material-root /path/to/材料 \
--library-id demo \
--output-dir ./data/output
- 查询检索（可选）
street-inspection query --library-id demo "安全生产隐患排查台账"
- 审核与定稿
- 打开
./data/output/ledger.xlsx，人工核对匹配状态 - 打开
./data/output/report.docx，基于汇报初稿润色 - 分管领导最终导出与归档
三、任务状态机
| 阶段 | 状态 | 进入条件 | 退出条件 |
|---|---|---|---|
| 0 立项 | draft | PRD 完成 | 三方评审通过 |
| 1 内测 | mvp | P0 + 性能骨架完成 | 红线硬测试通过 |
| 2 试点 | pilot | 党政办真实验证 | 业务验收报告 |
| 3 推广 | scale | 2–3 科室 | 模板库 ≥ 5 类 |
| 4 全面 | full | 全街道上线 | 运营数据达标 30 天 |
MatchStatus 状态机（PRD 4.2.1）：
MATCHED ↔ PARTIAL → MISSING
MATCHED → PARTIAL → MISSING（单向降级合法）
MISSING → MATCHED（人工修正可越界；自动判定禁止）
GapStatus 状态机：
OPEN → ASSIGNED → UPLOADED → CLOSED
↘ REJECTED
四、数据合规与安全
- 全本地处理：默认零外网；白名单机制仅在用户显式开启后生效
- 文件只读：Skill 对原始材料文件只读，不修改、不删除、不移动
- 访问控制：RBAC 模型，按文件夹 × 科室双轴；越权访问拦截率 100%
- 审计日志：结构化 JSON，保留 180 天
- OCR 隐私：本地引擎，图片不出本机；带敏感字段的图片二次确认才参与 OCR
- 学习闭环：v1 表仅本地存储，绝不进对外模型训练
五、性能与容量
| 指标 | 数值 |
|---|---|
| 清单解析 P95 | ≤ 30 秒 |
| 材料索引 P95 | ≤ 1 分钟 |
| 关键词检索 P95 | ≤ 1 秒 |
| 语义检索 P95 | ≤ 3 秒 |
| 匹配与缺项识别 P95 | ≤ 30 秒 |
| 台账生成 P95 | ≤ 10 秒 |
| 汇报初稿生成 P95 | ≤ 60 秒 |
| 端到端 P95 | ≤ 30 分钟 |
| 内存峰值 | ≤ 8 GB |
| 容量上限 | 5000 份材料 / 库 |
六、交付形态
| 输出物 | 文件格式 | 命名约定 | 标识 |
|---|---|---|---|
| 对照台账 | Excel .xlsx | ledger_v1.xlsx | v1 模板冻结 |
| 汇报初稿 | Word .docx | report_v1.docx | GB/T 9704—2012 |
| 缺项清单 | JSON | gaps_v1.json | 仅内部流转 |
| 索引数据库 | SQLite | library.sqlite | 本地加密 |
| 向量库 | FAISS | vectors.faiss | 本地 |
| OCR 缓存 | 图片 + JSON | ocr_cache/<hash> | 30 天滚动清理 |
七、交付前自检
- [ ] 红线三项硬测试全部通过
- [ ] P0 性能指标全部满足
- [ ] 单元测试覆盖率 ≥ 70%
- [ ] 端到端流水线可成功跑通真实清单 + 真实材料
- [ ] 涉密材料硬隔离机制验证通过
- [ ] 审计日志完整性验证通过
- [ ] 灰度发布准入条件全部满足
八、何时不用本 Skill
| 场景 | 原因 |
|---|---|
| 翻译类需求 | 走专门翻译 Skill |
| 通用文档摘要 | 走通用写作 Skill |
| 公文写作通用底稿 | 走通用写作 Skill |
| 直接对外提交报审 | 需业务负责人审核后由 OA 系统提交 |
| 涉密材料 | 需走保密制度独立流程 |
| 纸质档案 | 数字化由人工完成 |
| 跨域语言（中英文混合公文） | 多语言 Skill |
九、常见问题 FAQ
Q1：清单上传后命中不到模板怎么办？
A：Skill 自动走通用解析，并在控制台提示。通用解析对大类、检查点、所需材料的字段抽取准确率 ≥ 95%。
Q2：材料库满了怎么处理？
A：提示"材料库已满"。建议按年度拆分多个 library_id（如 2024、2025）。
Q3：误匹配怎么修正？
A：当前版本提供 CLI 修正入口（v1.1 提供 UI 修正）。学习闭环会把修正记入本地 v1 表，下次同类材料自动参考。
Q4：OCR 是否必须开启？
A：默认关闭。开启需二次确认；含敏感字段（人脸、身份证号、车牌）的图片二次确认后才参与。
Q5：涉密材料如何保护？
A：涉密文件不进 Skill 工作流；保密员执行硬隔离；任何外发动作都会被审计日志记录。
Q6：汇报的"成效显著"等表述会自动加吗？
A：不会。PRD 红线禁止使用无材料支撑的定性表述；缺失项自动生成【待补充】框架。
Q7：扫描件 PDF 怎么上传？
A：当前版本要求文字版。扫描件需先 OCR（生产环境用 PaddleOCR），OCR 结果进入材料库后即可匹配。
Q8：多语言支持吗？
A：当前版本仅中文。民族地区多语言需求列入 v2.0。
Q9：如何升级到 v1.1？
A：v1.1 引入 F7 缺项分派跟踪 + UI 修正。索引格式版本号写入 metadata，迁移期 ≥ 30 天。
Q10：发生红线违规怎么办？
A：任何红线违规触发 Skill 立即停用，审计日志全量上报街道保密员。回滚条件零容忍。
十、参考文件
config/settings.yaml：阈值、性能基线、OCR 规则、汇报版式config/templates.yaml：6 大类预置清单模板config/dept_mapping.yaml：材料类型 → 责任科室映射config/thesaurus.yaml：材料类型同义词词典docs/USER_GUIDE.md：用户操作手册docs/ADMIN_GUIDE.md：管理员手册docs/API.md：HTTP API 文档docs/DEPLOYMENT.md：部署手册docs/DELIVERY.md：交付清单
