tongban government policy understanding — 理解政府政策（tongban）

上海办事指南 概述 使用此技能将用户的上海服务需求映射到可能的市政部门和公共服务项目。首先使用捆绑的参考数据；仅当本地数据不足或用户需要当前政策确认时，才浏览官方网站。

工作流程 识别用户的角色：

• 个人：居民、户口、证件、社会保险、医疗保险、住房、旅行、公共服务或个人许可。
• 法人：公司、组织、许可、登记、年检、税务、投资、贸易、建设、知识产权或雇主服务。

如果不清楚，搜索两者并说明每个结果属于哪个角色。 提取请求中的关键词：业务对象、操作、证件/许可/材料、生活事件、行业、部门线索和在线/离线偏好。 规范同义词，例如 公司/企业 -> 法人， 户口/落户 -> 户籍， 医保 -> 医疗保障， 市场监管/营业执照 -> 市场监管局。 搜索本地参考资料：

• 首先使用 references/index.md 进行部门和常用关键词的定位。
• 使用 references/service_items.jsonl 查找确切的项目记录。
• 使用 rg 搜索中文关键词和部门名称。
• 始终也搜索 references/required_items.json 和 references/required-items.md；这些是用户指定的必须包含的项目名称，可能不出现在公共市政项目列表 API 中。
• 使用 references/departments.json 扩展部门缩写为官方名称和代码。

返回 1-5 个候选项，按匹配度排名。 对于每个候选项，包括：

• 部门角色（个人或法人）
• 主要项目和子项目
• 项目类型
• 是否有在线办理（st_net）
• 官方指南候选 URL
• 简单的下一步

显式处理不确定性：

• 如果少于两个强关键词匹配，询问一个澄清问题或呈现低置信度候选项。
• 如果多个部门可能适用，按部门分组并解释区别线索。
• 对于时间敏感的政策、材料、窗口、费用或资格，告诉用户在官方“一网通办”页面或拨打上海政府服务热线 021-12345 进行验证。

数据文件

• references/index.md：紧凑的人类可读索引和示例。
• references/service_items.jsonl：每行一个规范化的服务项目。

关键字段包括 department_name、department_short_name、department_code、role、item_name、subitem_name、item_type、st_net、item_id、item_code、source_url、guide_url 和 detail_status。

• references/departments.json：市政部门名称、简称和代码。
• references/required_items.json 和 references/required-items.md：用户指定的必需项目名称。

将这些用作覆盖保证，但区分 official_status=matched 和 official_status=needs_verification。

响应规则

• 不要声称服务可以肯定在线完成；当 st_net 为是时说“公开事项数据标记为可网上办理”。
• 如果本地记录缺乏详细信息，不要编造必需材料、截止日期、费用或窗口地址。
• 对于所有可行的建议，始终包含至少一个官方来源 URL。
• 对于 official_status=needs_verification 的必需项目，说明该项目作为必需别名/名称包含，但未在当前公共市政项目列表数据集中找到；要求用户在“一网通办”、“随申办”或 021-12345 上验证后再采取行动。
• 保持答案的实用性：首先是部门，然后是匹配事项，最后是下一步。
• 提醒用户，当前的官方页面和 021-12345 是最终资格和处理详细信息的权威来源。

刷新数据 仅当用户要求刷新或重建数据时，使用以下脚本：

• python3 scripts/fetch_zwdt.py --output references/raw_items.json
• python3 scripts/normalize_data.py --input references/raw_items.json --output references/service_items.jsonl
• python3 scripts/build_reference.py --input references/service_items.jsonl --output-dir references
• python3 scripts/validate_data.py --items references/service_items.jsonl --departments references/departments.json

fetcher 使用仅公共页面和 API，不登录，不提交政府服务表单。