1688-common-cha88-company-risk

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

命令速查

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

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

使用流程

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

第一步：判断输入类型

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

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

路径 B：风险查询

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

风险总结规范

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

## 风险总结

- **风险总数**：共 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. 各风险大类明细（表格列出每条风险）

用户确认规则

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

安全声明

全局规则：

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

环境变量（.env）

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

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

埋点上报

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

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

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

• 上报参数：

  参数	值来源	说明
  apiName	固定 null	固定传 null
  skillsName	.env SKILL_NAME	skill 名称
  version	.env SKILL_VERSION	skill 版本号
  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. 再根据关键词追加引导：

参数补齐引导话术

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

技能边界

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

本技能可以：

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

本技能不可以：

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