Legal Client Brief

客户简报

产品定位与路由

生成面向既有客户的高频信息触达包。典型频率是每日、每周或重大事件触发，目标是持续提供有用信息并维护关系，不重复制作完整行业研究。

用户需要形成长期可展示的月报或季报时，改用 legal-industry-report。本技能不得把上一期全文换日期后重新发布；没有有效增量时，应输出“本期无值得触达的重要变化”，而不是凑条目。

真实能力边界

本技能负责“跑一期”：读取画像、限定窗口、检索、核验、起草三个渠道稿、校验和本地打包。纯 cron、launchd 或 CI 只能重新打包已有 Markdown；周期性研究必须由能联网研究的 Agent 调度器触发。

本技能不发送微信、朋友圈、公众号、邮件或客户系统消息，不自动去掉 DRAFT，不修改信源白名单。所有发布动作由律师在本技能之外完成。

输入与配置

首次使用复制并填写：

1. config/report-profile.example.md → config/report-profile.md：品牌、编辑人和简报视觉。
2. config/audience-profile.example.md → config/audience-profile.md：既有客户的去标识化行业画像、业务重点和风险主题。
3. config/sources-whitelist.example.txt → config/sources-whitelist.txt：正文与两个渠道稿允许引用的域名。
4. 可选：config/industry-rules.local.example.yaml → config/industry-rules.local.yaml：细分行业补充规则。

真实配置由根目录 .gitignore 排除；前三项缺一即停止，不用默认值生成客户向草稿。

每期参数：

权限与安全边界

本技能会把脱敏关键词发送给白名单内公开网站或用户授权数据库，读取本地配置和模板，并写入 Markdown、HTML、PDF、元数据与复核清单。

客户画像只写行业、规模区间、业务阶段和风险主题；避免真实客户全称、联系人账号、未公开经营数据和无必要的自然人信息。白名单外页面可作线索发现，但不得进入事实链、正文、朋友圈稿或公众号稿。

单期生成流程

1. 加载窗口与画像：检查配置，确认 cadence / period_start / period_end / previous_cutoff。

2. 解析行业规则：

   bashCopy code
   python3 scripts/resolve_industry_rules.py \
     --industry "<行业>" \
     --mode brief \
     --output <追踪计划.json>
   

   规则包给出应监测事件和客户相关性问题，但候选信源仍必须经过本地白名单。

3. 只找增量：记录标题、发布者、发布日期、URL、是否在窗口内、相对上期的新变化、与客户画像的关系及采用/剔除理由。

4. 选择 1—5 条信号：优先选“新、真、与客户有关、能转化为行动”的事项。没有足够价值时不凑数。

5. 核验案例：案例必须有案号、法院、裁判日期、核验链接与核验日期；无法核验则写“本期未收录可核验案例”。

6. 起草三件套：

   • templates/brief-skeleton.md：完整简报，解释变化、客户相关性和行动建议。
   • templates/moments-copy.md：朋友圈短文案，突出一个核心信号和一个行动提示。
   • templates/wechat-draft.md：公众号文章草稿，适合移动阅读并保留信源与免责声明。

7. 运行门禁：

   bashCopy code
   python3 scripts/validate_report.py \
     --kind brief \
     --input <客户简报_DRAFT.md> \
     --whitelist config/sources-whitelist.txt
   
   python3 scripts/validate_channels.py \
     --moments <朋友圈_DRAFT.md> \
     --wechat <公众号_DRAFT.md> \
     --whitelist config/sources-whitelist.txt \
     --brief <客户简报_DRAFT.md>
   

8. 构建草稿包：

   bashCopy code
   python3 scripts/build_report.py \
     --kind brief \
     --input <客户简报_DRAFT.md> \
     --moments-copy <朋友圈_DRAFT.md> \
     --wechat-draft <公众号_DRAFT.md> \
     --profile config/report-profile.md \
     --audience-profile config/audience-profile.md \
     --whitelist config/sources-whitelist.txt \
     --cadence weekly \
     --period-start <YYYY-MM-DD> \
     --period-end <YYYY-MM-DD>
   

9. 可视与人工复核：把 PDF 全页渲染为图片，检查紧凑度、表格、裁切和异常空白；逐条打开信源，复核法律含义与渠道表达。

10. 停在 DRAFT：只报告本地路径、自动门禁结果和待人工判断事项。

三渠道写作纪律

• 完整简报：回答“发生了什么、为什么与这类客户有关、现在能做什么”。
• 朋友圈：一个核心判断、最多三个要点、一个轻量行动提示；不堆链接、不写确定性个案结论。
• 公众号：标题和导语可传播，正文仍须保留事实边界、来源和免责声明；不得把营销口号写成法律结论。
• 三份稿件的事实、日期和结论方向必须一致；渠道压缩只能减少信息，不能改变事实。

输出契约

• 客户简报_<audience>_<cadence>_<period_end>_DRAFT.md
• 同名 .html、.pdf、.meta.json、.checklist.md
• 朋友圈_<audience>_<period_end>_DRAFT.md
• 公众号_<audience>_<period_end>_DRAFT.md

元数据状态固定为 DRAFT，绑定三份 Markdown、PDF、画像、白名单和品牌配置的哈希。

Hard Fail

出现任一项即停止：

• 三个必需配置缺失、为空或 report_kind 不是 brief。
• 任一三件套文件缺失 _DRAFT 文件名或正文 DRAFT 标识。
• 残留占位符、[P?] 或独立的 ...。
• 任一文件出现白名单外 URL。
• 重点变化不在窗口内，或没有说明相对上期的新变化。
• 案例证据字段不全且未改写为“本期未收录可核验案例”。
• 三份稿件事实冲突，或把行业信息写成针对具体客户的确定性法律意见。
• PDF 为空、非 A4、明显裁切/重叠/乱码或存在异常空白页。
• 任何自动发送、外部推送或自动去掉 DRAFT 的路径。

自动门禁不证明法律判断与渠道传播效果正确；律师复核前保持 NOT_VERIFIED。

调度

按部署环境只读取一份：

• Agent 自动化平台：deploy/workbuddy-deploy.md
• OpenClaw 或其他 Agent 调度器：deploy/openclaw-deploy.md
• 纯 cron / launchd / CI 能力边界：deploy/generic-cron-deploy.md

依赖

Python 包统一安装：

bashCopy code
python3 -m pip install -r scripts/requirements.txt
python3 -m playwright install chromium

Mermaid CLI 为可选依赖：npm install -g @mermaid-js/mermaid-cli。缺失时降级为代码块；脚本不会自动安装。

按需读取

• 行业规则：references/industry-rules.yaml
• 完整简报与渠道模板：templates/brief-skeleton.md、templates/moments-copy.md、templates/wechat-draft.md
• 人工复核：templates/checklist-template.md
• 视觉规范：references/design-spec.md
• 故障排查：依次运行 validate_industry_rules.py、industry_rules_selftest.py、validate_report_selftest.py、validate_channels_selftest.py