cat-xierluo 客户简报
产品定位与路由
生成面向既有客户的高频信息触达包。典型频率是每日、每周或重大事件触发，目标是持续提供有用信息并维护关系，不重复制作完整行业研究。
| 维度 | legal-client-brief |
legal-industry-report |
|---|---|---|
| 使用阶段 | 日常/每周增量跟踪 | 月度/季度全面研究 |
| 核心关系 | 既有客户维护 | 市场展示与潜客获取 |
| 信息范围 | 本窗口内的新变化 | 行业全景、结构与趋势 |
| 交付 | 简报 + 朋友圈 + 公众号 | 一份正式报告 |
| 视觉语气 | 紧凑、移动端友好 | 正式、机构化、可留存 |
| 状态 | 永远先停在 DRAFT |
PUBLIC_REVIEW |
用户需要形成长期可展示的月报或季报时，改用 legal-industry-report。本技能不得把上一期全文换日期后重新发布；没有有效增量时，应输出“本期无值得触达的重要变化”，而不是凑条目。
真实能力边界
本技能负责“跑一期”：读取画像、限定窗口、检索、核验、起草三个渠道稿、校验和本地打包。纯 cron、launchd 或 CI 只能重新打包已有 Markdown；周期性研究必须由能联网研究的 Agent 调度器触发。
本技能不发送微信、朋友圈、公众号、邮件或客户系统消息，不自动去掉 DRAFT，不修改信源白名单。所有发布动作由律师在本技能之外完成。
输入与配置
首次使用复制并填写：
config/report-profile.example.md→config/report-profile.md：品牌、编辑人和简报视觉。config/audience-profile.example.md→config/audience-profile.md：既有客户的去标识化行业画像、业务重点和风险主题。config/sources-whitelist.example.txt→config/sources-whitelist.txt：正文与两个渠道稿允许引用的域名。- 可选：
config/industry-rules.local.example.yaml→config/industry-rules.local.yaml：细分行业补充规则。
真实配置由根目录 .gitignore 排除；前三项缺一即停止，不用默认值生成客户向草稿。
每期参数：
| 参数 | 必填 | 默认 | 说明 |
|---|---|---|---|
period_start / period_end |
是 | 无 | 增量信息窗口 |
cadence |
是 | 无 | daily、weekly 或 event |
industry_keywords |
否 | 客户画像 | 本期检索词 |
previous_cutoff |
否 | 上期截止日 | 去重和判断新变化 |
max_items |
否 | 5 | 重点变化上限 |
权限与安全边界
本技能会把脱敏关键词发送给白名单内公开网站或用户授权数据库，读取本地配置和模板，并写入 Markdown、HTML、PDF、元数据与复核清单。
客户画像只写行业、规模区间、业务阶段和风险主题；避免真实客户全称、联系人账号、未公开经营数据和无必要的自然人信息。白名单外页面可作线索发现，但不得进入事实链、正文、朋友圈稿或公众号稿。
单期生成流程
加载窗口与画像：检查配置，确认
cadence / period_start / period_end / previous_cutoff。解析行业规则：
python3 scripts/resolve_industry_rules.py \ --industry "<行业>" \ --mode brief \ --output <追踪计划.json>规则包给出应监测事件和客户相关性问题，但候选信源仍必须经过本地白名单。
只找增量：记录标题、发布者、发布日期、URL、是否在窗口内、相对上期的新变化、与客户画像的关系及采用/剔除理由。
选择 1—5 条信号：优先选“新、真、与客户有关、能转化为行动”的事项。没有足够价值时不凑数。
核验案例：案例必须有案号、法院、裁判日期、核验链接与核验日期；无法核验则写“本期未收录可核验案例”。
起草三件套：
templates/brief-skeleton.md：完整简报，解释变化、客户相关性和行动建议。templates/moments-copy.md：朋友圈短文案，突出一个核心信号和一个行动提示。templates/wechat-draft.md：公众号文章草稿，适合移动阅读并保留信源与免责声明。
运行门禁：
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>构建草稿包：
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>可视与人工复核：把 PDF 全页渲染为图片，检查紧凑度、表格、裁切和异常空白；逐条打开信源，复核法律含义与渠道表达。
停在 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 包统一安装：
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