1688-common-cha88-company-risk#

统一入口： python3 {baseDir}/cli.py <command> [options]

命令速查#

命令说明示例cha88_search企业搜索cli.py cha88_search --keyword "公司名称"``companyRisk公司风险查询cli.py companyRisk --socialCreditCode "91441881577945666N"``configure配置 AKcli.py configure YOUR_AK

所有命令输出 JSON： {"success": bool, "markdown": str, "data": {...}}

展示时直接输出 markdown 字段，Agent 分析追加在后面，不得混入其中。

使用流程#

Agent 先判断用户输入类型，再按对应路径执行。各命令在 AK 缺失等情况下会自行返回明确错误，Agent 按下方「异常处理」应对即可。

第一步：判断输入类型#

用户输入判断规则进入路径统一社会信用代码18 位字母数字组合→ 直接进入「风险查询」companyId明确传入 companyId→ 直接进入「风险查询」公司名称非以上格式→ 先执行「企业搜索」

路径 A：企业搜索（输入为公司名）#

text

步骤 1：执行 `cli.py cha88_search --keyword "公司名"`
步骤 2：判断搜索结果
  - 精确匹配（第一条结果的 ent_name 去除 <em> 标签后与用户输入完全一致）
    → 直接提取该企业的 socialCreditCode，进入「风险查询」
  - 非精确匹配
    → 列出搜索结果，请用户选择目标企业，确认后提取 socialCreditCode 进入「风险查询」

路径 B：风险查询#

text

步骤 1：执行 `cli.py companyRisk --socialCreditCode "信用代码"` 或 `--companyId "ID"`
步骤 2：直接输出返回的 markdown 字段（风险概览 + 各大类明细）
步骤 3：当 total > pageSize 时，自动翻页获取全部风险记录
步骤 4：输出「风险总结」（见下方规范）

风险总结规范#

在输出完 CLI 返回的 markdown 后，Agent 必须追加 一段风险总结分析，格式如下：

text

## 风险总结

- **风险总数**：共 X 条风险记录
- **风险分布**：按大类列出各类风险数量（如：监管措施 X 条、司法风险 X 条、经营风险 X 条）
- **最新风险**：取时间最近的 1-3 条风险，简述风险类型、时间和核心内容
- **风险分析**：基于风险记录综合分析该企业的主要风险点
- **注意事项**：针对发现的风险给出建议（如：关注行政处罚后续整改情况、留意诉讼进展等）

如无风险记录，总结为：该企业暂未发现公开风险记录，风险状况良好。

入参规则#

调用 companyRisk 时：

• --socialCreditCode / --companyId： 至少传一个，二选一即可。
• --page（默认 1）、 --pageSize（默认 10）：分页参数。
• 接口请求体格式（参考）： {"companyId":"","pageSize":"10","page":"1","socialCreditCode":"91441881577945666N"}

返回内容速读#

• total：风险记录总数
• riskMap：按 mainType（如"监管措施"、"司法风险"）分组的风险列表
• 每条记录关键字段： level（风险等级）、 subType（子类型）、 time、 companyName、 contentChinese（详情 JSON）

CLI 已自动渲染为 markdown：

1. 风险概览（按 mainType 聚合 + 等级分布）
2. 各风险大类明细（表格列出每条风险）

用户确认规则#

• 风险查询为只读操作， 参数明确时直接执行，无需额外确认。
• 用户提供公司名 + 搜索结果精确匹配时， 无需确认直接继续。
• 用户提供公司名 + 搜索结果非精确匹配时， 列出结果请用户选择。

安全声明#

风险级别命令Agent 行为只读companyRisk风险查询为只读操作，参数明确时直接执行配置configure写入本地 AK 配置文件

全局规则：

1. 所有查询为只读操作，不涉及业务数据写入。
2. 参数明确时，可直接执行查询。
3. 参数不明确时，先向用户追问确认后再执行。

环境变量（.env）#

项目根目录的 .env 文件存储 skill 基础信息，供埋点上报等模块读取。发布到不同环境时可直接替换该文件中的变量值。

变量默认值说明SKILL_NAME``1688-common-cha88-company-riskskill 名称SKILL_VERSION``0.5.0skill 版本号SKILL_CHANNEL``1688claw发布渠道

已存在的系统环境变量优先级高于 .env，CI/CD 注入的变量不会被覆盖。

埋点上报#

每次 CLI 命令执行时，自动向 skill 网关上报一次调用记录，用于统计 skill 调用次数。

• 实现位置： scripts/_tracker.py -> report_skill_usage()，在 cli.py 的 main() 中每次命令执行后自动调用

• 上报接口： POST /api/reportSkillsUsage/1.0.0

• 上报参数： 参数值来源说明apiName固定 null固定传 nullskillsName``.env SKILL_NAMEskill 名称version``.env SKILL_VERSIONskill 版本号scene固定 CLI固定值channel``.env SKILL_CHANNEL发布渠道

• 失败处理：上报失败静默忽略，不影响主流程

执行前置（首次命中能力时必须）#

• 首次执行 cha88_search 前：先完整阅读 references/capabilities/cha88_search.md
• 首次执行 companyRisk 前：先完整阅读 references/capabilities/companyRisk.md
• 首次执行 configure 前：先完整阅读 references/capabilities/configure.md
• 同一会话内后续重复调用可复用已加载知识；仅在规则冲突或文档更新时重读。

异常处理#

任何命令输出 success: false 时：

1. 先输出 markdown 字段（已包含用户可读的错误描述）
2. 再根据关键词追加引导：

markdown 关键词Agent 额外动作"AK 未配置" 或 "签名无效" 或 "401"提示用户当前查询能力所需鉴权未就绪，请补充有效 AK 或检查鉴权配置后重试"参数缺失"提示用户补充 --socialCreditCode 或 --companyId 后重试"限流" 或 "429"建议用户等待 1-2 分钟后重试"格式异常"建议用户稍后重试或检查参数其他仅输出 markdown 即可

参数补齐引导话术#

"请输入公司名称、统一社会信用代码（18 位）或 companyId，我将为您查询该企业的风险信息。例如：查一下萍乡市能华加油站的公司风险。"

技能边界#

本技能只用于企业法务风险查询与分析，不处理其他企业信息查询。

本技能可以：

• 查询中国大陆企业的风险记录（经营异常、行政处罚、监管措施、被执行人、失信被执行人、司法案件等）
• 按风险大类聚合展示概览
• 自动翻页获取完整风险列表
• 综合分析并总结企业风险
• 通过公司名搜索企业以获取信用代码（仅作为风险查询的前置步骤，不单独提供企业搜索服务）

本技能不可以：

• 单独查询企业工商信息、注册资本、法人代表、股东结构、专利商标等（请使用 cha88-base 等其他工具）
• 单独搜索企业列表（企业搜索仅用于风险查询前置，不作为独立能力对外提供）
• 查询非中国大陆企业（如美国、日本公司）
• 查询个人身份信息
• 修改或更新企业风险数据（仅查询）