行业报告

产品定位与路由

生成一份可供不特定潜在客户阅读的正式行业法律报告。典型频率是每月或每季度，目标是建立专业品牌、支持公开分发和形成业务入口；它不是内部速记，也不是针对具体客户的法律意见。

维度	`legal-industry-report`	`legal-client-brief`
使用阶段	月度/季度全面研究	日常/每周增量跟踪
核心关系	面向市场与潜在客户	维护既有客户关系
信息范围	行业全景、结构与趋势	截止日前后发生的变化
视觉语气	正式、机构化、可长期留存	紧凑、易扫读、适合社交渠道
交付状态	`PUBLIC_REVIEW`	`DRAFT`
发布动作	律师复核后另行发布	律师复核后另行发布

用户要发朋友圈、公众号日常更新，或只追踪最近一个周期时，改用 legal-client-brief。用户要按月/季形成完整行业作品时，使用本技能。

输入与缺口处理

输入	必填	默认	用途
`industry`	是	无	行业名称及口径
`region`	否	全国	政策、产业集群与企业范围
`period`	否	季度	月度或季度报告周期
`focus`	否	全景	劳动、知识产权、投融资、数据、跨境等
`as_of`	否	执行日	事实与有效性截点
`preferred_sources`	否	规则包	用户指定主管部门、协会、数据库或材料

缺 industry：停止并只追问这一项。
行业名称存在多个统计口径：列出候选口径与影响，不自行选第一个。
缺区域或重点：使用默认值，并在“研究边界与方法”写明。
行业规则未命中：使用通用规则，同时标记 needs_custom_pack: true，先补行业问题与信源，不冒充精准行业研究。
外部数据库不可用：切换到官方公开渠道或写“未采集/待复核”，不得补写推测值。

权限与安全边界

本技能会联网检索公开材料，读取本技能模板与用户明确提供的配置，并在用户指定目录写入 Markdown、HTML、PDF 和元数据。查询前对客户、案件和内部经营信息做最小必要脱敏。

本技能不会自动发送、上传、发布、安装依赖、扩张访问权限或读取用户全局 .env。公开报告避免出现真实客户名、未公开经营数据和无必要的自然人身份信息。

首次配置

复制 config/report-profile.example.md 为 config/report-profile.md，填写品牌、编号、主办律师与视觉主题。
如需增加细分行业，复制 config/industry-rules.local.example.yaml 为 config/industry-rules.local.yaml。
如需排除域名，复制 config/source-blacklist.example.txt 为 config/source-blacklist.local.txt。

真实配置由根目录 .gitignore 排除。正式 PDF 前必须补齐 report-profile.md；预览可使用去具体化配置。

研究与生成流程

固化研究边界：确定 industry / region / period / focus / as_of，写明不覆盖范围。
解析行业规则：
```
python3 scripts/resolve_industry_rules.py \
  --industry "<行业>" \
  --mode report \
  --output <研究计划.json>
```
如存在本地补充，增加 --overlay config/industry-rules.local.yaml。读取输出中的研究问题、必备维度、指标、风险视角、信源角色和时效规则。
建立证据账本：每个关键结论记录“来源事实 / 模型归纳 / 律师判断 / 待核验事项”，并保留标题、发布者、日期、URL、检索时间和统计口径。
全面采集：覆盖宏观与规模、产业链、竞争格局、区域集群、政策监管、代表企业、争议风险和法律服务机会。规则包是最低清单，不是结论模板。
处理冲突：来源口径不一致时并列披露，不平均、不拼接成虚假确定值。
起草报告：使用 templates/report-skeleton.md。正式报告以解释和证据为主，不写成新闻摘要堆叠。

运行门禁：

python3 scripts/validate_report.py --kind report --input <行业报告.md>

构建交付件：

python3 scripts/build_report.py \
  --kind report \
  --input <行业报告.md> \
  --profile config/report-profile.md

最终复核：把 PDF 全页渲染为图片，检查封面、章节节奏、中文字体、表格、页码、裁切和空白页；律师再复核事实、有效性、法律判断和公开表达。

信源与判断纪律

按 references/industry-rules.yaml 选择“什么问题应查哪些一手来源”，按 references/source-priority.md 判断证据强度。
官方原文可单独证明其发布内容；行业规模、份额、趋势和影响判断原则上需两个独立来源。
只有一个来源时紧邻结论标注 [单一信源]，并写明能证明与不能证明的范围。
每条政策写发布机关、发布日期、施行日期和状态；无法确认有效性时标“待核验”。
每个关键数据写统计期、指标定义、区域口径和来源。转载同一稿件不算独立来源。
上市公司披露只能证明披露主体及文件所述事项；不得自动外推为全行业事实。
企业数据库未返回不等于不存在；使用“未见所查公开来源记录”并列明检索范围。

输出契约

默认生成到 Markdown 所在目录或 output_dir：

行业报告_<industry>_<region>_<period>_<YYYYMMDD>.md：权威源稿。
同名 .html：可检查的渲染中间件。
同名 .pdf：A4 正式复核版。
同名 .meta.json：PUBLIC_REVIEW 状态、生成时间、文件哈希、信源 URL 与配置哈希。

报告必须包含：执行摘要、研究边界与方法、行业结构与市场、竞争格局与代表企业、政策监管与区域、法律风险与争议、服务机会与行动建议、附录与信源。

Hard Fail

出现任一项即不得交付：

残留占位符、[P?] 或独立的 ...。
免责声明缺失或晚于执行摘要。
关键事实无可点击来源，或单一来源未披露。
行业规则未命中却未披露通用回退。
主体识别有多个候选却自动选第一项。
把行业一般信息写成具体客户法律意见。
PDF 为空、存在非 A4 页面、明显裁切/重叠/乱码、异常空白页，或未做最终可视复核。

自动门禁只证明结构、信源和文件属性，不证明法律判断正确；律师完成语义复核前保持 NOT_VERIFIED。

依赖

系统依赖

依赖	安装方式
Python 3.10+	macOS: `brew install python`<br>Linux: `sudo apt-get install python3`
Chromium	`python3 -m playwright install chromium`
Mermaid CLI（可选）	`npm install -g @mermaid-js/mermaid-cli`；缺失时降级为代码块

Python 包

Markdown、PyYAML、BeautifulSoup、Jinja2、Playwright 与 PyMuPDF 统一安装：

python3 -m pip install -r scripts/requirements.txt

脚本在依赖缺失时给出安装提示，不会自动安装。

按需读取

行业规则与信源：references/industry-rules.yaml、references/source-priority.md
企业与隐私纪律：references/data-discipline.md
报告结构：templates/report-skeleton.md
视觉规范：references/design-spec.md、references/palette-presets.md
故障排查：依次运行 validate_industry_rules.py、industry_rules_selftest.py、validate_report_selftest.py

legal-industry-report