善查查 · 公益机构尽职调查流水线

一、这个技能是干什么的

把一家公益机构从「一堆审计报告 PDF」变成「一份七章机构调查报告 + 全套可复核底稿」。

三条主线，也是报告的三块重点：

1. 资金链网状追踪 —— 从捐赠入口到最终收款方的全额映射，含关联方与关联交易
2. 灰色合规地带的标记、定级与分析 —— 规则化提示 + 政策依据 + 整改建议
3. 实质性社会成效 —— 区分产出/结果/影响，写清成效边界与已证伪的指控

核心方法：审计报告给「名字」，工商穿透给「身份」，招采公告给「价格」——三者叠加才是完整资金链。
审计报告永远不会写深度关联关系和关联交易（关联方章节可能整章缺失），
所以外部工商穿透与「查老板」人脉交叉不是可选项，是本流程的价值所在。
若使用者不提供任何工商账号，则退回公开披露口径 —— 报告照样出，但必须在第 02 章如实标注取数边界。

二、触发方式

用户说这几类话时启用：
- 「善查查，帮我出一份 XXX 报告」
- 「给 XXX 基金会做一份机构调查」
- 「查一下 XXX 的资金链 / 关联方 / 关联交易」
- 「把 XXX 那份报告的资金链部分补一下」（→ 只走阶段三 ⑪⑫⑬）
- 「做一下理事和供应商的人脉交叉」（→ 只走 ⑦ person）

不该触发（near-miss）——以下请求请勿启用本技能：

> 边界拿不准时，先问一句是为了出尽调报告，还是只是查个信息 —— 不要一上来就跑十五步。

付费调用（支付宝 AI 按量付费 · AI 必读，先读本节再干活）

本技能为付费技能，通过支付宝「AI 按量付费」（A2M 协议）按次计费。

前置检查：当前智能体是否支持支付宝 AI 支付

发起下单前，先检查当前环境是否已安装官方买家侧支付能力：
- 可执行的 alipay-bot 命令，或已安装 alipay-payment-skill（由 npx -y @alipay/agent-payment@latest install 安装）；
- 工具列表中存在名称含 alipay 且用于支付的任意一个工具，即视为支持。

只以你实际可用的工具/命令为证据（本文档提到的名字不算）；无法确认时按「不支持」处理。

• 支持：静默继续下列工作流，不要向用户提及本检查。
• 不支持：终止付费流程、不要发起下单。只说明结论与解决办法：请先安装官方买家支付能力 npx -y @alipay/agent-payment@latest install 后重试。

工作流程（四步，缺一不可）

第一步 · probe：请求资源，取得 402 账单

POST https://charity-skill-pay.app.workbuddy.host/v1/aipay
Content-Type: application/json
Body: {"skill": "shanchacha-skill"}

未付款时服务端返回 HTTP 402，并在响应头携带 Payment-Needed（Base64 编码的账单 JSON）。
必须保存该账单原文和本次原始请求（URL + 方法 + body），供后续付款与重试使用。

> 若返回非 402（如 404），说明服务端路由不可用，不要自行改写协议，直接向用户报告并停止。

第二步 · pay：发起支付，等用户授权

调用官方买家 CLI，把第一步保存的账单交给它，展示用途与金额，等待用户完成付款：

alipay-bot 402-buyer-pay \
  --session-id <会话ID> \
  --file <第一步保存的 Payment-Needed 账单文件> \
  --resource-url https://charity-skill-pay.app.workbuddy.host/v1/aipay \
  --method POST \
  --intent-summary "原始请求：善查查机构尽职调查（¥1.00/次）"

第三步 · complete：查询原订单并携带凭证重试（⚠️ 最易遗漏，必须执行）

用户付款后，用同一个订单号查询并重试原始请求；不重新下单、不重复扣费：

alipay-bot 402-query-payment-status \
  --out-shake-no <订单号> \
  --resource-url https://charity-skill-pay.app.workbuddy.host/v1/aipay \
  --method POST

重试时通过 Payment-Proof 请求头携带支付凭证，body 与第一步完全一致。
服务端验付通过后返回 HTTP 200 + 付费内容。

> ⚠️ 不携带 Payment-Proof 重试，就永远拿不到付费内容。这一步是 Agent 最常漏的。

第四步 · 状态不明先查单，不重复付款

支付处理中或结果不明时，先查询原订单状态再决定下一步；
不得重新下单、不得追加付款、不得重复发送回执。

服务端职责（由已部署网关承担，本技能不重复实现）

以上能力也可通过本包 scripts/shanchacha-paid.mjs 的 probe / pay / complete 子命令编排调用：

node scripts/shanchacha-paid.mjs probe   --state-dir .state/SESSION_KEY
node scripts/shanchacha-paid.mjs pay     --state-dir .state/SESSION_KEY --session-id SESSION_KEY
node scripts/shanchacha-paid.mjs complete --state-dir .state/SESSION_KEY --out-shake-no OUT_SHAKE_NO

三、环境与前置条件

依赖：playwright, openpyxl, pypdf, websocket-client, httpx, cryptography, rapidocr-onnxruntime, onnxruntime==1.20.1, pypdfium2, numpy, opencv-python-headless（均已装）。

> ⚠️ onnxruntime 必须锁 1.20.1。1.22 及以上在本机会 DLL load failed ... 动态链接库(DLL)初始化例程失败，
> 装完别顺手升级。重装命令：
> pip install --only-binary=:all: "onnxruntime==1.20.1"

前置检查第一件事：跑 python shanchacha.py status，看清环境、登录态、流水线进度。

硬性限制（要如实告诉用户，不要假装能做）

1. 扫描件必须先 OCR：审计报告有相当比例是纯图片扫描件（某文体类大型公募基金会 253 页、某医疗救助类基金会 186 页）。
   audit 会报出哪些是扫描件，ocr 负责补齐。OCR 没跑完之前，不要凭印象写那些年份的数字——
   上一版某文体类大型公募基金会报告里 2020 年"重要关联方 5 家"就是二手转述，标了 P0 待补。
2. 登录态会过期，但没有任何账号是必需的：先跑 auth check 体检。掉了就 auth ensure
   用你自己的账号重登一次（本地保存，长期复用）。账号是用户自己的：脚本不代登录、不碰密码、不上传凭证。
   有几个同类账号就登几个，多源交叉验证更稳；一个都没有 → 建议免费注册风鸟；
   不想用这类账号也完全可行 —— 退回公开披露口径出报告，第 02 章如实标注取数边界。
3. 工商数据有边界：未登录只有基础工商信息；股东穿透、查老板等深度字段需 VIP。
   没有账号不等于出不了报告，只是第 02 章的证据链更依赖公开披露（慈善中国年报/审计报告/招采公告）。
4. 不碰使用条款红线：只用于用户自身的合规尽调，控制频率，不做数据转售或公开分发。

换人使用：每个使用者都要登录自己的账号（2026-09-11 实测）

结论：不能共用一套登录态。 新使用者第一次跑 auth ensure 时，脚本会在他自己的常驻浏览器里
弹登录页，他用自己的微信/手机号登录，凭证落在他本机 profile。不要把当前 profile 复制给别人——
既是使用条款问题，也会互相挤掉登录态。

取数优先级（使用者自选；脚本只提示、不强制）：

> ✅ 没有任何账号是"必需"的。 auth check 只是一份体检报告，退出码恒为 0、不阻断流程：
> 有号就登（有几个登几个、多源交叉），没号就靠公开披露，"不想用"也完全可行。
> 唯一要守住的纪律：没有账号时不要在报告里假装做过工商穿透 —— 如实写"未做穿透 / 未查到"。

四、流水线（分三阶段，共十五个子步骤）

每一步都通过统一入口调用，产出自动作到机构交付包里。

cd "~/.workbuddy/skills/shanchacha/tools"     # ~ 即当前用户主目录（Windows 下形如 %USERPROFILE%）
python shanchacha.py <子命令> [--org "机构全称"]

> 下文出现的 ~\... 均为开发机示例路径，
> 换机器请整体替换为自己的路径；改路径不必动代码 —— 用环境变量覆盖即可：
> SHANCHACHA_ORG_ROOT（机构交付根目录）、SHANCHACHA_PY（python）、
> SHANCHACHA_OUT（底稿输出）、SHANCHACHA_CHROME（Chromium 可执行文件）。

阶段一 · 资料准备

⓪ 从慈善中国自动取原始资料（推荐先做）

python shanchacha.py cszg search --org "中国XX基金会"   # 先看有没有、ID 是多少
python shanchacha.py cszg pull   --org "中国XX基金会"   # 全量：下载 + 逐标签截图 + 文本快照

→ 自动检索机构 → 打开公开详情页 → 下载全部可下载项（年报/年检报告/审计报告/章程），
并逐标签截图（基本信息 15 个子标签 + 6 个主标签）。
产出落在 原始资料\慈善中国-{年报,审计报告,章程,页面截图}\ 与 慈善中国-抓取记录\。
这一步能顶掉大量人工搬运——尤其审计报告与章程，后面 audit/ocr 直接接手。

> ⚠️ 该站有反爬：连续快速访问约 16 次会被整体拦到滑块验证页（slideCaptcha）。
> 工具内置限速（CSZG_PACE，默认 2.5 秒）；站点若弹出人机校验，脚本按页面提供的验证流程处理，通过与否取决于站点，不保证成功，失败即转人工。使用者需自行确认符合该站点使用条款；
> 自动失败会转人工（把窗口推前台请你滑一下）。附件下载接口不受拦截影响，已抓到的 rid 仍可取。

① new — 建机构脚手架

python shanchacha.py new --org "中国XX基金会"

→ 之后请用户把审计报告/年报/章程/制度放进 原始资料\。

② audit — PDF 文本层体检（先做这一步）

python shanchacha.py audit --org "中国XX基金会"

→ 报出每个 PDF 是 OK / THIN / SCAN。审计报告里扫描件占比很高，先摸清家底再往下走。

③ ocr — 扫描件 OCR 还原

python shanchacha.py ocr --org "中国XX基金会" --workers 3
python shanchacha.py ocr --org "..." --only 2020     # 只跑指定年份

→ 约 16 秒/页，必须放后台任务跑。逐页缓存支持断点续跑。
产出 02_过程数据/报告文本/<原名>.ocr.txt。OCR 没跑完不要写那些年份的数字。

④ extract — 报告 PDF → 文本

python shanchacha.py extract --org "中国XX基金会"

→ 报出「可直接解析 / OCR 补齐 / 仍需 OCR」。已有 .ocr.txt 的会自动采用 OCR 文本。

⑤ targets + people — 生成取证清单

python shanchacha.py targets --org "中国XX基金会" --top 40
python shanchacha.py people  --org "中国XX基金会"

→ 自动从"大额支付对象/关联方"段落抽主体并分级。
先 --dry 看一遍，自动抽取会混进会计师事务所、银行之类的噪声，人工剔除后再落盘。

阶段二 · 取证

⑥ auth / browse / login — 备好浏览器与账号（穿透前的准备，不阻断）

# 1) 账号体检：看看有哪些号可用（有几个登几个，多源交叉）
python shanchacha.py auth check          # 只体检，永远退出码 0；有号没号都不拦流程
python shanchacha.py auth ensure         # 想登录时：在你当前常驻浏览器里开登录页，等你登
python shanchacha.py auth ensure --site 天眼查 --wait 900   # 也可点名补某站
# 2) 常驻浏览器（必须在后台任务里跑，否则命令一结束浏览器就被回收）
python shanchacha.py browse --serve

> 为什么账号体检要放在这里、而不是报告出完之后：资金链/关联方是第 02 章的主体，
> 穿透结论会反转定性（见第五节第 4 条）。若先出报告再补穿透，第 02 章与结论都要重写，
> 违背"最小改动"铁律。所以在动笔之前先把能取的穿透数据取齐。
>
> 账号怎么关联：用 auth ensure 时脚本只负责打开登录页 + 检测成功 + 落盘，
> 登录动作由你本人完成（扫码/验证码）。凭证只存本机
> ~\.workbuddy\shanchacha\profile 与 login_state.json，不上传任何服务器、不代管密码。
> 跨机构复用，登录一次长期可用，过期了重登一次即可。
>
> 没有账号怎么办：不用卡住 —— 直接往下走，穿透取数退回公开披露口径，
> 但报告第 02 章要如实标注"未做工商穿透 / 未查到"，不能拿二手信息补空。

⑦ fetch — 列表页批量（用你已登录的账号）

python shanchacha.py fetch --all        # 或 --p0 / --name "上海均奕"

⑧ deep — 详情页深挖（股东/高管/变更）

python shanchacha.py deep --all

⑨ person — 查老板（本流程的杀手锏）

python shanchacha.py person --org "中国XX基金会"

→ 对治理层（理事/监事）与交易对手自然人逐个查其在营企业，并与供应商名单自动交叉。
这是回答"有没有'人'层面的利益闭环"的唯一手段。

⑩ build — 生成穿透底稿

python shanchacha.py build --org "中国XX基金会"

阶段三 · 成稿交付

⑪ chapters — 列出章节锚点

python shanchacha.py chapters --org "中国XX基金会"

⑫ assemble — 安全替换指定章节

python shanchacha.py assemble --org "中国XX基金会" --chapter 2 --src "...\ch2.html"

→ 自动备份 + 锚点校验。新章节文件必须含 id="s2"，否则中止（防误删）。

⑬ export — 落交付包 + 渲染 PDF

python shanchacha.py export --org "中国XX基金会" --v 1

⑭ 同步资料库 — 把 HTML 上传到 WorkBuddy 资料库（一键命令，已固化进技能包）

# 1) 先换票（ToolSearch → DeferExecuteTool，skill_id=library），拿到 token
# 2) 一键同步：建文件夹→首传→记录 node_block_id；改版自动原地更新（URL 不变）
printf '%s' "<token>" | python shanchacha.py sync --org "中国XX基金会" --token-stdin
# 指定源 / 只检查不上传：
python shanchacha.py sync --org "XX" --token-stdin --src "其它报告.html"
python shanchacha.py sync --org "XX" --token-stdin --dry

• 脚本自动定位资料库 skill（SHANCHACHA_LIBRARY_DIR / CODEBUDDY_SKILL_DIR 或内置默认路径），无需手动拼 LIB 变量。
• 首次：建分类文件夹「机构调查报告（善查查）」→ 导入 HTML（挂到文件夹下）→ 记录 node_block_id。
• 改版：用 --node-block-id 原地更新，URL 不变（避免资料库堆出 v1/v2/v3 多个链接）。
• 回执的 node_block_id / url 写入 02_过程数据/资料库同步.json，并回填 交付说明.md（标记 <!-- LIBRARY_SYNC --> 幂等替换）。
• 沙箱模式（X_IDE_IS_CLOUDSTUDIO=true）免 token，由 auth-proxy 注入身份；客户端模式必须带 token。
• 回执给 KS_IMPORT_OK 里的 url。不上传数据库绑定（报告是纯展示静态页）。

> ⚠️ 这一步是固定程序，漏做不会报错——出完报告务必跑一次 sync，否则报告只落在本地交付包、没进资料库（仁泽首跑就因跳过这步、报告没进库）。以后每次 export 出新版，紧接着 sync 一次即可原地更新。

上传前先跑图片外链硬门检查（报告一般全是内联 SVG，<img> 数为 0，直接通过）。

⑮ verify — 完整性自证（出报告前必跑）

python shanchacha.py verify --org "中国XX基金会"          # 三层全跑
python shanchacha.py verify --org "..." --layer 1         # 只查采集完整性

→ 产出 02_过程数据/完整性自证报告.md，退出码 = FAIL 项数。逐条核完再定稿（详见第五节）。

五、如何保证完整、可提取、不遗漏（三层自证）

问题：慈善中国分页、按需 AJAX、弹窗附件、扫描件、格式混杂 —— 任何一环静默失败都会丢信息。
而"丢了没丢"若靠人眼比对，换个人来用必然翻车。所以把这三件事做成机器自证：

一条命令跑完三层：

python shanchacha.py verify --org "中国XX基金会"              # 三层全跑
python shanchacha.py verify --org "..." --layer 1             # 只查采集完整性
python shanchacha.py verify --org "..." --report <报告.html>   # 附带必查项覆盖

FAIL = 必处理（丢数据/坏文件）；WARN = 需人工确认一次。逐条核完再出报告。

三层的落地细节（换人用也不会漏）：
- 采集：每张表都记录「页面声明 N 条」，抓完立刻与实抓行数对比。该机构实证：理事会声明 19 条，
旧版跨页去重误删成 18 行，verify 当场报 FAIL（已修：去重改为只在跨页之间做，页内重复保留）。
- 解析：原始资料/ 每个文件都必须在 报告文本/ 有对应 .txt；文本提取覆盖.json 逐份记录
格式/策略/字数/判定。扫描件 PDF 若无 .ocr.txt 就报 pdf:NEED_OCR，绝不假装读到了。
- 分析：references/必查清单.md 是唯一的"分析不遗漏"清单，verify 第③层直接拿它对报告。

> 换人使用的关键：这三层都不依赖账号 —— 采集与解析是公开数据，分析清单是文本比对。
> 别人拿到技能，只要跑 verify，就能自己发现"哪里没下全、哪里没提取到、哪里没分析"。

五.二、评测基线（让 skill 可回归 · v0.9）

v0.7 的 verify 是对单次跑出来的产物做体检；v0.9 的 eval 是对一份已知正确结果的 case 做回归测试。

eval_set/                       ← ⚠️ 本机回归用，**不随分发包走**（含真实机构数据）
├── base-a-2024.json          ← 基线①：中等非公募（docx审计+PDF年报）→ 19/19+3/3+2/2 = 100
├── base-b-2025.json          ← 基线②：中小公募（全PDF年报·无独立审计）→ 12/12+1/1+1/1 = 100
├── base-c-2025.json          ← 基线③：亿级公募（扫描PDF+cszg页面文本）→ 16/16+3/3+2/2 = 100
└── *.report.html             ← 各 case 上次跑的报告（带颜色、绿黄红）

> ⚠️ eval_set/ 不进分发包。 这些基线里是真实机构的名称、统一社会信用代码与理事监事
> 信息，属于尽调结论，不能随公开分发包外发（sc_pack.py 已把 eval_set 列入 SKIP_DIRS）。
> 别人装完之后要跑回归，请按 references/eval_baseline_模板.md 用自己的机构自建基线。

思路：把已知正确结果的 case 反向提炼成"必须出现的关键词"，每次 skill 迭代完跑一遍 eval，看分有没有掉。
三个 case 特意覆盖三种量级与三种年报形态，确保任何迭代改动都能在差异形态上回归：docx 审计报告路径 / 全 PDF 年报(无审计)路径 / 扫描件PDF + cszg 页面文本路径。

核心产物：
- tools/sc_eval.py —— 跑分引擎（build_corpus 含四层：顶层产物 / 报告文本 / 工商抓取 / cszg 页面文本）
- references/eval_baseline_模板.md —— schema 手册
- eval_set/base-a-2024.json / base-b-2025.json / base-c-2025.json —— 三个基线

支持 4 类测试：
| 类型 | 用途 |
|---|---|
| expectations (must_hit) | 一项里的关键词全部命中 → HIT；缺失 → MISS；部分命中 → PARTIAL |
| red_flags | 同上，但权重更高（×0.3） |
| negative_tests.expect_keyword_in_json | 产物文件里必须有 |
| negative_tests.forbidden_keyword | 整库都不该出现 |
| negative_tests.forbidden_pair | 两词必须不同段出现（专测"误识别 X 为 Y"） |

进入版本迭代期后必做：每次改完一个工具，跑一次 shanchacha.py eval 看分变化。
若总分掉 ≥3 分，必须找出掉分项（看 <case_id>.report.html 的 MISS 项）再发版。

六、我要做的判断（不只跑脚本）

脚本只负责取数与搬运，报告质量取决于这些判断：

1. 报告正文必须我写（流水线不代写）。先读 references/报告规范.md 定骨架，
   第 02 章按"五层"（流入/沉淀/流出/关联节点/人脉交叉）组织，配一张 SVG 资金链网络图。
   关键认知：本 skill 没有任何"自动生成全部七章报告"的命令。chapters 只列锚点、
   assemble 只做单章锚点替换（假设已有含 s1~s6 锚点的基础报告 HTML）、export 只做
   "复制 HTML + 渲染 PDF"。所以七章报告由我（AI）手作：按 报告规范.md 写一个完整的
   报告.html（含 <h2 id="s0">～<h2 id="s6"> 全部锚点、CSS、目录、SVG 资金链图、风险表），
   再用 shanchacha.py export --org X --src 报告.html --v 1 渲染交付。
   assemble 只在"只改某一章、其他章不动"的最小改动场景用，不是生成入口。
2. 每个数字都要能溯源。转引、倒推、估算的必须标注来源；查不到写"未查到"。
3. 风险标记按 references/风险规则.md 打，输出"主体 | 风险项 | 等级 | 依据"。
   规则是提示不是结论，措辞用"建议/需关注/高亮预警"。
4. 穿透后要回头改定性。今天验证过的典型：
   - 名义上的"关联闭环"在股权层被证伪（经销商 = 商业关系，不是股权关联）→ 必须明写"股权层不成立"
   - 公司名含知名集团但实为自然人持股 → 标为"名称巧合"，避免误导
   - 原本存疑的供应商其实是某大集团全资子公司且有资质 → 降级
5. 区分"立案/质疑"与"认定违规"。供应商被立案 ≠ 基金会违规。
   属地部门已澄清的指控必须标注"已澄清"，不能当结论用。
6. 保留原目录结构。用户明确要求：只补充/更新指定章节，
   其他章节"因为新查询的关联和交易等必须修改时再修改"——最小改动。

7. 终版纪律（硬约束，2026-09-17 立）：报告 HTML 每一版都必须是可直接交付的成品。
   正文禁止出现任何 vN —— 唯一例外是封面/页脚的 报告版本 vN。
   （v2 已用年报核对）/v1 曾写/v3 补入/本版/本轮/待补入 vN/以 vN 为准
   一律不许写。
   ⚠️ 修订/更正 不在一刀切禁止之列 ——「章程历次修订记录」「核实并更正」是正当业务用语，
   只有自述修订（特此更正/予以更正/勘误）才算违规。
   数据拿不到时写成结论（「该字段公开渠道未披露」），不是写成进度（「本轮未取得」）。
   过程性说明的唯一归宿是 交付说明.md。详见 references/报告规范.md 第七章。
   export 在拷贝前跑 check_final_edition，命中即 exit 2 拒绝出包（--force 才放行）；
   同一环节还校验 01_底稿/ 必须非空，并把旧版自动移入 02_过程数据/版本备份/。
   交付包根目录只保留当前版的报告 html/pdf。

8. 每个"成功"都必须能指到证据，不能只指到"我执行过了"（硬约束，2026-09-17 立）。
   整条流水线出现过的 bug，根因几乎都是同一个：成功信号不是从证据得出，而是从"这个动作我做过"推出。
   具体形态与修法：
   - 退出码：子脚本"零命中/空产出"必须返回非零，入口必须原样透传（raise SystemExit(main() or 0)）。
   少任何一环，"硬阻断"就退化成假绿灯 —— 实测同一份脏报告，直调 sc_export.py 得 exit 2，
   走总入口却得 exit 0。sc_pack.py 已把这变成打包前的固定检查（凡有 __main__ 却无
   任何非零退出路径的脚本即 FAIL），不靠人记得。
   - 空产出不许落盘、不许报 OK：0 关键人 / 0 家主体 / 0 条关联方，都不算"跑完了"。
   打印 [OK] …（共 0 人）、[√] 已保存 都是错的 —— 下游会把空清单当有效输入。
   - 判据要件名，不要件数：check_digest 一开始只查"有没有 .xlsx"，于是空表也算通过；
   改成"底稿必须非空"才拦得住。
   - "我扫过了"不等于"没命中"：体检/校验必须把"扫描口径 + 命中数"打出来，否则会出现
   "实测正文含 17 处版本痕迹却报 0 残留"这种谎报（sc_export.py 的 BANNED 清单因此改为
   从 references/报告规范.md 的 ``banned-regex 块**单一来源**读取，两边不一致即告警）。 - **文档与代码只有一份真相**：默认值、禁用规则、依赖清单、界面文案，改了代码就必须同步改文档 （本轮实测踩到两处：SKILL.md 的默认值、README 的export示例，都还在说上一版的话）。 - **体检不能满屏假阳性**：一个"每次都报一堆不需要管的东西"的体检，只会被--force` 掉，
   然后连真问题一起放过。规则要分级（阻断 / 待确认），且必须能区分代码面与文档面。
   自检话术：说"做完了"之前，先能指着证据说出——退出码是几、断言是什么、文件内容长什么样、
   外部回执写了什么。指不出来，就是没做完。

七、目录规范（不得随意变）

<ORG_ROOT>\<机构全称>\
├── 原始资料\                            用户投放处
└── <机构全称>调查报告<YYYY年M月D日>\      交付包
    ├── <机构全称>_机构调查报告_v<N>.html
    ├── <机构全称>_机构调查报告_v<N>.pdf
    ├── 交付说明.md
    ├── 01_底稿\
    ├── 02_过程数据\{工商抓取,报告文本,章节源文件,版本备份}\
    └── 03_脚本归档\

所有交付物都落在这个机构文件夹里，不落桌面。

八、踩过的坑（照抄别重犯）

九、参考文件

• references/工作流.md — 十四个子步骤全量命令与说明
• references/报告规范.md — 七章骨架、第 02 章五层结构、HTML 技术约定、写作纪律（含 ```banned-regex 单一来源）
• references/风险规则.md — 单主体 R1—R9 / 交易结构 N1—N8 / 治理合规 G1—G8
• references/必查清单.md — 分析覆盖必查项（verify 第③层据此扫报告查漏）
• references/eval_baseline_模板.md — 评测基线 schema 手册（回归测试用）
• references/打包与分发.md — 打包上传 / 发给同行的维护者须知（使用者可跳过）
• templates/交付说明模板.md — 交付包里的说明文档模板

十、迭代

这个技能会持续演进。用户补充新机构材料后，如果发现：
- 新的风险规则 → 追加到 references/风险规则.md
- 新的数据源或更优取数路径 → 更新 references/工作流.md 与 tools/
- 新的报告结构偏好 → 更新 references/报告规范.md

遇到规则误判（如把集团子公司标成小微企业）时，当场修规则文件，不要只在对话里说。

十一、发版

本包只含当前有效规则，不含变更历史 —— 变更史属维护者资料，写在包外。

发版须同步两处：① 顶部 version: 字段（SemVer X.Y.Z，禁止写 vX.Y）；
② 归档文件夹 / zip 名带 vX.Y.Z。

十二、打包与分发

见 references/打包与分发.md（面向要把本 skill 打包上传 / 发给同行的维护者，使用者可跳过）。

一条命令跑完全流程：python shanchacha.py pack —— 建快照 → 分发前体检 → 打 zip → 开箱模拟，
版本号自动读 frontmatter。不要手工打包。