| name | related-party-identification |
|---|---|
| description | Use when a user asks to identify, discover, check, or investigate related parties, hidden related parties, customer or supplier relationships, equity or control links, or CICPA company data for a Chinese audit. 用于关联方识别与核查，包括隐藏关联方、客户供应商关系、股权控制关系和中注协工商数据。 |
把本技能当作 AI 对话工作手册。由 AI 在后台完成环境检查、注协取数、候选扩展和核查；用户只需说单位名称、在官方网页完成登录、通过 Windows 文件选择窗口选资料，并在范围扩大时作出确认。
候选不等于关联方，红旗不等于硬关联，自动判断不等于最终关联方结论。最终认定必须由审计人员结合准则、交易背景及进一步审计程序完成。
| 用户现有资料 | 入口 | AI 的第一步 |
|---|---|---|
| 只有被审计单位名称 | 主动发现 | 确认工商注册全称，从该单位向外寻找候选 |
| 已有若干公司名称或客户、供应商名单 | 名单核查 | 打开 Windows 文件选择窗口；只接受 XLSX、CSV、TXT 名单，不解析总账或明细账 |
| 已有注协导出目录 | 已有数据 | 直接选择目录并核查，跳过登录和联网查询 |
信息不够时只问一个自然语言问题，不向用户展示内部参数、子命令或脚本调用。
- 先使用
scripts/related_party_workflow.py做环境预检。要求 Windows 与 Python 3.9 及以上；缺少第三方包时说明用途、安装位置和影响，安装前征得用户同意，优先使用%LOCALAPPDATA%\related-party-identification\venv独立环境。不需要 Playwright。 - 每次联网任务都先自动验证现有登录态。有效就直接查询；无效时首选当前用户平时使用的 Firefox。电脑没有 Firefox 时，先推荐 Mozilla 官方安装路线；用户坚持使用 Edge 或 Chrome 时，改走 OpenCLI 浏览器扩展。扩展由本技能从 Gitee 国内镜像的固定版本准备，同事不需要安装 Node、整套 OpenCLI 命令行或另一个浏览器空间。
- Firefox 路线直接按 Windows 日常方式打开原有个人配置；Edge/Chrome 路线先确认 OpenCLI 扩展已经启用，再打开用户平时的浏览器和原有个人配置。两条路线都允许浏览器保存的用户名和密码照常使用，不要求关闭已经打开的浏览器，不打开扩展弹窗页面。后台检测到登录成功后继续原任务，不要求用户复制任何技术数据。
- 登录失败时按账号权限、验证码、网络连接、会话过期四类说明下一步；不要要求用户接触浏览器内部数据，也不要在对话中索取密码或登录凭据。
- 主动发现先对被审计单位取得本技能固定的 20 个关联方核查维度。先按 10+10 分两批；批量接口连续失败第 1、2 次时仍按原未完成组重试，只有连续第 3 次失败才停止批量并把所有尚未完成的维度改为逐个下载。中间任何一次批量成功都把连续失败次数清零。已经完成或明确无数据的维度不重复下载；单维度仍失败则保留进度并暂停，20 个维度闭环前不得进入候选扩展。闭环后再按持股比例不低于 20% 扩展候选，初始 2 层、最多 5 层，候选超过 100 家时暂停确认。扩展候选不逐家导出 20 个维度。
- 名单核查只查询被审计单位和用户明确提供的公司。遇到多个可能的名称列时，列出表头让用户选；不得自行猜测。
- 已有数据入口不得创建注协客户端或要求登录。选择目录后直接运行核查，并明确本次结论只覆盖该目录实际包含的数据。
- 所有注协请求串行执行：每分钟最多 15 次、每小时最多 300 次；普通查询随机等待 2—5 秒，导出轮询随机等待 10—20 秒，成功批次之间随机等待 15—30 秒。同一时刻只允许一个下载任务在途。遇到限速提示按等待策略暂停，不并发冲击接口。这里是本技能的保守自我约束，不是注协官方公布限额。
- 输出后先讲范围，再讲高风险证据、可疑红旗、数据缺口和建议审计程序。客户、供应商表中的“关联方名称”是公开交易关系的对手方名称：公开客户关系、公开供应商关系只作为候选，不能单独形成风险证据，更不能直接写成“关联方”或“未披露”。
- 安装依赖、Firefox 或 OpenCLI 前，先取得用户明确同意；未同意则 🛑 STOP 并保留任务状态。
- 主动发现超过 2 层或候选超过 100 家时，展示新增范围和来源；未确认则 🛑 STOP。
- 出现重名主体、多个名称列或不完整导出数据时，先让用户选择或确认影响；未确认则 🛑 STOP。
- 单维度经过两个完整轮询窗口仍失败，或同名证据文件哈希冲突时，保留全部批次 ZIP 和状态并 🛑 STOP；不得带着数据缺口进入候选扩展。
- 已有数据入口一旦触发登录或联网，立即 🛑 STOP，返回离线核查入口。
| 触发条件 | 第一处理动作 | 仍然失败时 |
|---|---|---|
| Windows 文件或文件夹选择窗口没有出现 | 只重试打开一次 | 🛑 STOP，说明当前运行环境无法弹窗；不得要求用户键入本地路径 |
| Edge/Chrome 的 OpenCLI 扩展没有在后台连接 | 确认扩展已启用且普通浏览器窗口已打开，再重试一次 | 改为推荐 Firefox；不要打开扩展弹窗页面 |
| Gitee 扩展文件下载或校验失败 | 保留任务状态，稍后重试同一固定版本 | 改走 Firefox 路线；不要使用未校验文件 |
| 页面已经登录但官方接口验证仍失败 | 保留任务并重新打开官方页面验证一次 | 停止重复尝试，按账号权限、网络连接或会话过期分流 |
| 维度批量接口失败 | 连续第 1、2 次仍批量重试未完成组；批量成功则计数清零 | 连续第 3 次失败后，逐个下载所有尚未完成维度；单维度仍失败则暂停并报告具体维度 |
完整逐句引导和异常分流见 references/user-flow.md。
- 每次调用先验证，能用就直接用；失效才进入浏览器登录。
- 首选 Firefox；Edge/Chrome 使用 OpenCLI 扩展。始终使用当前用户原有个人配置，不另建浏览器空间，不依赖 Playwright。
- Edge/Chrome 缺少扩展时，先推荐 Firefox；用户选择 OpenCLI 后，使用
opencli-setup从 Gitee 国内镜像准备固定版本，并一次只引导一个安装动作。 - 不自动打开任何扩展弹窗页面。安装完成后，OpenCLI 在后台连接本技能，用户只需要在平时的浏览器里正常登录。
- 登录成功后保存可复用的登录状态，下次调用仍先实际验证，不按固定天数猜测是否有效。
- 登录状态只保存到当前 Windows 用户，不要求使用者接触或传递登录数据。
- 日志、任务状态和报告不输出账号登录内容。
按七类有效核查证据输出结果：工商指纹、关键人员、客商画像、股权控制、历史痕迹、担保资金链、无形资产共用。高风险证据必须查清；可疑红旗用于安排进一步程序。公开客户关系和公开供应商关系只用于扩充候选范围，不属于上述七类有效核查证据。详细阈值和案例只在需要解释结果时读取 references/rules.md 与 references/cases.md。
使用 scripts/related_party_workflow.py 统一编排任务，使用 scripts/related_party_check.py 生成核查报告。新版 20 维任务按状态文件恢复，成功维度不重下；旧版一次请求全部维度的等待任务原样保留，但不在线续跑。任何时候都不得把下载中心“最新任务”误当成本次结果。
主动发现入口把候选链路单独写入 <公司名称>_主动发现候选清单.xlsx；它用于说明“为什么查到这家公司”，不是关系认定。核查引擎只对本次实际取得的数据做全图比对。
报告是多 sheet Excel，结构见下方"输出格式"。重点看：
- 汇总 sheet：是否为关联方的判断 + 命中维度 + 风险等级
- 各维度证据 sheet：每条命中的具体字段值（地址、电话原文等）
工具只负责"识别嫌疑"，不替审计师下结论。对每个 🔴 硬关联，审计师应：
- 实施进一步程序（函证、实地走访、资金流水核对）
- 询问管理层，要求披露
- 评估对审计意见的影响
交付多 sheet Excel 核查报告，至少包含汇总判断、各类原始证据、任务范围、输入数据概览、数据质量与限制。核查报告命名为 <公司名称>_关联方核查报告.xlsx；主动发现入口另交付 <公司名称>_主动发现候选清单.xlsx 及每家候选的发现路径；在线取数的基础数据放在同一交付目录下的 <公司名称>_注协原始导出 文件夹。
本技能已经内置搜索、详情、股东、主要人员、股权、子公司发现以及 20 个关联方核查维度的批量导出和连续三次失败后逐项下载能力，不依赖另一个技能目录。Firefox 登录读取和 Edge/Chrome 的 OpenCLI 本地桥接也已内置；OpenCLI 扩展文件从 Gitee 国内镜像固定版本取得并逐文件校验。客户、供应商、最终受益人和变更记录没有独立查询接口，只能从维度导出批次取得；主动发现入口只保证被审计单位本身取得这 20 个维度。客户、供应商文件仅提供公开交易关系中的对手方名称，不能把表头中的“关联方名称”按字面解释为会计准则意义上的关联方。
完整文件和字段映射见 references/dimensions.md；详细规则、阈值和证据分级见 references/rules.md。
- 不要把候选、红旗或自动判断直接写成最终关联方结论；应保留证据和待核实事项。
- 不要向用户索取密码、Cookie 或浏览器内部数据；登录失效时只走 Firefox 或 Edge/Chrome + OpenCLI 路线。
- 不要猜测重名主体、公司名称列或用户想查的范围；存在歧义就停下确认。
- 不要重新走全部维度一次打包下载，不要把已经成功的维度带入重试组；也不要给扩展候选逐家导出 20 个维度或绕过 2 层、100 家和每次扩层的确认点。
- 不要在已有数据入口触发登录或联网，也不要把缺失维度当成“未发现关系”。
- 用户没有提供自报关联方名单时，不要使用“未披露”或“披露不完整”定性。
- 工具只识别"嫌疑"，不下"是关联方"的最终结论：最终认定需审计师结合准则（CAS 36 / CSA 1323）判断。报告里"是否关联方"列是基于规则的初判，供审计师参考。
- 企业名称必须用工商全称：否则 cicpa 导出会匹配 0 家。
- 数据时效：工商数据有滞后（变更、注销可能未及时更新），核查结果需结合函证、走访等程序验证。
- 已注销公司查不到：部分造假空壳公司事后注销，cicpa 可能无数据。这种情况报告里会标注"数据缺失"。
- 亲属关系受限于公开数据：工商数据不直接提供亲属关系，只能通过"同名+同姓+同地址"间接推断，需谨慎。
- 只需要核对函证地址，不需要关联方候选或关系证据
- 只需要查看一家公司的单项工商详情，不需要关联方核查报告
- 只需要会计准则层面的关联方认定咨询，不需要工商取证或候选发现
references/user-flow.md—— 非技术用户逐句引导、异常分流和范围确认references/rules.md—— 七类有效核查证据详解（识别原理、具体规则、阈值、红旗信号、监管出处）references/cases.md—— 处罚案例库（监管认定的过错 → 对应核查规则）references/dimensions.md—— 注协 20 个关联方核查维度与本技能规则的映射references/SOURCES.json与NOTICE—— 内置数据层的来源、基线版本和本地改造说明scripts/related_party_check.py—— 核查引擎主脚本
作者：nigo 微信公众号：逆行的狗