{"id":"1023bc67-c848-45d0-a452-2ca883b818e5","entityType":"agent","slug":"clawhub-financial-ai-analyst-initiation-of-coverage-or-deep-div","name":"Initiation of Coverage Agent","canonicalUrl":"https://www.xpersona.co/agent/clawhub-financial-ai-analyst-initiation-of-coverage-or-deep-div","canonicalPath":"/agent/clawhub-financial-ai-analyst-initiation-of-coverage-or-deep-div","generatedAt":"2026-10-10T04:43:28.104Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T02:24:14.216Z","emptyReason":null},"description":"依托东方财富数据库，面向沪深京港美上市公司（A 股、港股、美股、北交所），生成首次覆盖报告或深度研究报告。 当用户提及「首次覆盖」「首次覆盖报告」「初始覆盖」「深度研究」「深度报告」「个股深度」「公司深度」「标的深度分析」，或要求对某只股票/上市公司撰写全面、体系化的研究报告时，必须触发本 Skill。 即使用户... Skill: Initiation of Coverage Agent Owner: financial-ai-analyst Summary: 依托东方财富数据库，面向沪深京港美上市公司（A 股、港股、美股、北交所），生成首次覆盖报告或深度研究报告。 当用户提及「首次覆盖」「首次覆盖报告」「初始覆盖」「深度研究」「深度报告」「个股深度」「公司深度」「标的深度分析」，或要求对某只股票/上市公司撰写全面、体系化的研究报告时，必须触发本 Skill。 即使用户... Tags: coverage:1.0.3, financial:1.0.3, latest:1.0.4, report:1.0.3, research:1.0.3, stock:1.0.3 Version history: v1.0.4 | 2026-04-17T11:18:37.457Z | user Publish 1.0.4 v1.0.3 | 2026-04-10","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 9.8K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s172qfps754dhtdynwv0gwshes83mtd4:initiation-of-coverage-or-deep-dive","sourceUrl":"https://clawhub.ai/financial-ai-analyst/initiation-of-coverage-or-deep-dive","homepage":"https://clawhub.ai/financial-ai-analyst/skills/initiation-of-coverage-or-deep-dive","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/financial-ai-analyst/initiation-of-coverage-or-deep-dive","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/financial-ai-analyst/skills/initiation-of-coverage-or-deep-dive","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":77,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"依托东方财富数据库，面向沪深京港美上市公司（A 股、港股、美股、北交所），生成首次覆盖报告或深度研究报告。 当用户提及「首次覆盖」「首次覆盖报告」「初始覆盖」「深度研究」「深度报告」「个股深度」「公司深度」「标的深度分析」，或要求对某只股票/上市公司撰写全面、体系化的研究报告时，必须触发本 Skill。 即使用户..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:24:14.216Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:24:14.216Z","emptyReason":null},"stars":null,"forks":null,"downloads":9838,"packageName":null,"latestVersion":"1.0.4","tractionLabel":"9.8K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:24:14.216Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T02:24:14.216Z","lastCrawledAt":"2026-10-09T02:24:14.216Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T02:24:14.216Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.4","createdAt":"2026-04-17T11:18:37.457Z","changelog":"Publish 1.0.4","fileCount":4,"zipByteSize":8128},{"version":"1.0.3","createdAt":"2026-04-10T11:02:24.819Z","changelog":"- Updated output format specification for report responses to a simpler, fixed template including only title, content, attachments, and share link. - Changed default output directory for attachments from a relative path without dot to one prefixed by `./`. - Clarified that if only one attachment (PDF or DOCX) is present, only that attachment line should be listed. - Specified that if neither attachment is available, output \"完整报告：暂无可用附件\". - Removed previous multi-section template; now only the content field is required and extra sections are prohibited. - Expanded content field handling: use the interface `content` when available, otherwise extract summary from attachment to ensure non-empty content.","fileCount":3,"zipByteSize":6705},{"version":"1.0.2","createdAt":"2026-04-03T12:39:44.640Z","changelog":"delete useless environment","fileCount":3,"zipByteSize":6484},{"version":"1.0.1","createdAt":"2026-04-03T09:53:44.990Z","changelog":"- 增加对东方财富数据库的依赖与说明，需配置 EM_API_KEY 环境变量作为接口鉴权。 - 明确要求安装 httpx Python 依赖，补充安装命令说明。 - 技能描述与触发条件优化，更加突出“必须触发”及与其他技能（如业绩点评/事件点评）的区分。 - 新增或调整 INITIATION_OF_COVERAGE_OR_DEEP_DIVE_OUTPUT_DIR 附件输出目录配置指引。 - 报告生成脚本命令增加 --query 参数写法，提升调用规范。","fileCount":3,"zipByteSize":6510},{"version":"1.0.0","createdAt":"2026-03-27T10:28:12.711Z","changelog":"- Initial release of the \"initiation_of_coverage_or_deep_dive\" skill for generating full initiation/deep-dive research reports on listed companies. - Supports A-shares, HK, US, and Beijing Stock Exchange listed companies; triggers on user requests mentioning initiation, deep-dive, or comprehensive stock research. - Implements a unified workflow: entity recognition, market validation, and full report generation via a single script, returning structured output with report text, attachments, and links. - Handles exceptions with clear user prompts for missing or unsupported entities, invalid input, or service failures. - Distinguished from earnings/incident/industry research scenarios, which are out of scope for this skill.","fileCount":3,"zipByteSize":5963}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s172qfps754dhtdynwv0gwshes83mtd4:initiation-of-coverage-or-deep-dive","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-financial-ai-analyst-initiation-of-coverage-or-deep-div/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-financial-ai-analyst-initiation-of-coverage-or-deep-div/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-financial-ai-analyst-initiation-of-coverage-or-deep-div/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-financial-ai-analyst-initiation-of-coverage-or-deep-div/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-financial-ai-analyst-initiation-of-coverage-or-deep-div/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-financial-ai-analyst-initiation-of-coverage-or-deep-div/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T04:43:28.103Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-financial-ai-analyst-initiation-of-coverage-or-deep-div/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-financial-ai-analyst-initiation-of-coverage-or-deep-div/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-financial-ai-analyst-initiation-of-coverage-or-deep-div/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-financial-ai-analyst-initiation-of-coverage-or-deep-div/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T02:24:14.216Z","emptyReason":null},"readme":"Skill: Initiation of Coverage Agent\n\nOwner: financial-ai-analyst\n\nSummary: 依托东方财富数据库，面向沪深京港美上市公司（A 股、港股、美股、北交所），生成首次覆盖报告或深度研究报告。 当用户提及「首次覆盖」「首次覆盖报告」「初始覆盖」「深度研究」「深度报告」「个股深度」「公司深度」「标的深度分析」，或要求对某只股票/上市公司撰写全面、体系化的研究报告时，必须触发本 Skill。 即使用户...\n\nTags: coverage:1.0.3, financial:1.0.3, latest:1.0.4, report:1.0.3, research:1.0.3, stock:1.0.3\n\nVersion history:\n\nv1.0.4 | 2026-04-17T11:18:37.457Z | user\n\nPublish 1.0.4\n\nv1.0.3 | 2026-04-10T11:02:24.819Z | user\n\n- Updated output format specification for report responses to a simpler, fixed template including only title, content, attachments, and share link.\n- Changed default output directory for attachments from a relative path without dot to one prefixed by `./`.\n- Clarified that if only one attachment (PDF or DOCX) is present, only that attachment line should be listed.\n- Specified that if neither attachment is available, output \"完整报告：暂无可用附件\".\n- Removed previous multi-section template; now only the content field is required and extra sections are prohibited.\n- Expanded content field handling: use the interface `content` when available, otherwise extract summary from attachment to ensure non-empty content.\n\nv1.0.2 | 2026-04-03T12:39:44.640Z | user\n\ndelete useless environment\n\nv1.0.1 | 2026-04-03T09:53:44.990Z | user\n\n- 增加对东方财富数据库的依赖与说明，需配置 EM_API_KEY 环境变量作为接口鉴权。\n- 明确要求安装 httpx Python 依赖，补充安装命令说明。\n- 技能描述与触发条件优化，更加突出“必须触发”及与其他技能（如业绩点评/事件点评）的区分。\n- 新增或调整 INITIATION_OF_COVERAGE_OR_DEEP_DIVE_OUTPUT_DIR 附件输出目录配置指引。\n- 报告生成脚本命令增加 --query 参数写法，提升调用规范。\n\nv1.0.0 | 2026-03-27T10:28:12.711Z | user\n\n- Initial release of the \"initiation_of_coverage_or_deep_dive\" skill for generating full initiation/deep-dive research reports on listed companies.\n- Supports A-shares, HK, US, and Beijing Stock Exchange listed companies; triggers on user requests mentioning initiation, deep-dive, or comprehensive stock research.\n- Implements a unified workflow: entity recognition, market validation, and full report generation via a single script, returning structured output with report text, attachments, and links.\n- Handles exceptions with clear user prompts for missing or unsupported entities, invalid input, or service failures.\n- Distinguished from earnings/incident/industry research scenarios, which are out of scope for this skill.\n\nArchive index:\n\nArchive v1.0.4: 4 files, 8128 bytes\n\nFiles: scripts/generate_deep_research_report.py (10015b), skill-card.md (2699b), SKILL.md (7152b), _meta.json (154b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: initiation-of-coverage-or-deep-dive\ndescription: >\n  依托东方财富数据库，面向沪深京港美上市公司（A 股、港股、美股、北交所），生成首次覆盖报告或深度研究报告。\n  当用户提及「首次覆盖」「首次覆盖报告」「初始覆盖」「深度研究」「深度报告」「个股深度」「公司深度」「标的深度分析」，或要求对某只股票/上市公司撰写全面、体系化的研究报告时，必须触发本 Skill。\n  即使用户仅表述为「帮我写一份 XX 公司的研究报告」而未出现「深度」「首次覆盖」等词，也应触发。\n  不适用于业绩点评、财报点评、事件点评等场景。\nmetadata:\n  {\n    \"openclaw\": {\n      \"requires\": {\n        \"env\":[\"EM_API_KEY\"]\n      },\n      \"install\": [\n        {\n          \"id\": \"pip-deps\",\n          \"kind\": \"python\",\n          \"package\": \"httpx\",\n          \"label\": \"Install Python dependencies\"\n        }\n      ]\n    }\n  }\n---\n\n# 上市公司首次覆盖报告 / 深度研究报告生成\n\n## 概述\n\n本技能用于生成上市公司的**首次覆盖报告**或**深度研究报告**。通过调用统一脚本 `scripts/generate_deep_research_report.py`，\n一次性完成实体识别、市场校验、报告生成及结果返回。\n\n## 环境变量\n\n| 变量名 | 说明 | 默认 |\n|--------|------|------|\n| `EM_API_KEY` | 接口鉴权密钥（必填） | 无 |\n| `INITIATION_OF_COVERAGE_OR_DEEP_DIVE_OUTPUT_DIR` | 附件输出目录| `./miaoxiang/initiation_of_coverage_or_deep_dive`（相对当前工作目录） |\n\n\n## 前提条件\n\n### 1. 配置 `EM_API_KEY`\n\n```bash\n# macOS / Linux\nexport EM_API_KEY=\"your_api_key_here\"\n```\n\n```powershell\n# Windows PowerShell\n$env:EM_API_KEY=\"your_api_key_here\"\n```\n\n### 2. 安装依赖\n\n```bash\npip3 install httpx --user\n```\n\n\n## 完整工作流程\n\n### 第一步：调用报告生成脚本\n\n调用 `scripts/generate_deep_research_report.py` 脚本，将用户的**原始问句**作为参数传入。该脚本内部自动完成以下全部流程：\n\n1. **实体识别与市场校验**：调用实体识别接口，从用户问句中识别沪深京港美实体，返回标准化信息（`secuCode`、`marketChar`、`classCode`、`secuName`）；多个实体时优先取第一个；未识别到支持的实体则直接返回错误提示。\n2. **报告生成**：将校验通过的实体信息作为参数，调用首次覆盖写作接口生成完整报告。\n\n**调用方式**：\n\n```bash\npython3 {baseDir}/scripts/generate_deep_research_report.py --query \"用户原始问句\"\n```\n\n**脚本输出（JSON 格式）**：\n\n- **成功时**：返回报告全文及附件地址等完整结果，包含报告标题、各章节内容、附件地址、分享链接等。\n- **实体识别为空时**：返回错误信息 `\"目前仅支持沪深京港美实体进行首次覆盖。您提供的实体不在支持范围内，请确认后重新输入。\"`\n- **入参不合法时**：返回 `\"入参不支持，请重新检查实体类型和报告期。\"`\n- **接口调用失败/超时时**：返回 `\"报告生成服务暂时不可用，请稍后重试。\"`\n\n**处理逻辑**：\n\n- 脚本返回成功 → 进入第二步，进行结构化输出\n- 脚本返回错误提示 → 将错误提示原样返回给用户，流程终止\n\n注意：**禁止调用 任何「后台执行、稍后汇报」的方式跑本脚本**，只能在当前会话中同步等待到命令完成，拿到 stdout 的结果后再继续，否则会导致本 Skill 失败。\n\n### 第二步：结构化输出\n\n脚本返回报告全文后，按照以下固定结构进行响应输出。\n\n---\n\n## 输出格式规范\n\n接口返回后，必须严格按以下模板输出，不得增删标题、不得改变顺序、不得添加额外章节：\n\n### 标题\n直接使用接口返回的 `title` 字段，单独成行，一般格式为\"XXX公司首次覆盖报告：XXXXXX\"。\n\n### 正文\n如果接口返回的 `content` 字段有相关行业报告信息，则原文透传；\n否则读取接口返回的附件文件内容，总结相关报告信息返回，记住保证返回的正文内容非空。\n\n### 附件\n接口返回 pdf 以及 docx 格式文件的保存路径。\n\n### 分享链接\n直接使用接口返回的 `shareUrl` 字段，单独成行。\n\n文案必须按以下固定格式输出：\n\n```\n{title}\n\n{content}\n\n---\n\n**附件：**\n\n- 📄 **PDF版完整报告地址**：{pdf_file_path}\n- 📝 **Word版完整报告地址**：{word_file_path}\n\n**分享链接：**\n{shareUrl}\n```\n\n字段映射规则：\n- `{title}` = 脚本返回的 `title`\n- `{content}` = 脚本返回的 `content`\n- `{pdf_file_path}` = 脚本返回的 `pdf_file_path`\n- `{word_file_path}` = 脚本返回的 `word_file_path`\n- `{shareUrl}` = 脚本返回的 `shareUrl`\n\n当附件缺失时：\n- 若仅有一种格式，仅输出存在的那一行（PDF 或 DOCX）。\n- 若两种都不存在，输出：`完整报告：暂无可用附件`\n\n## 格式要求\n\n响应事件流中的数学公式格式规范：\n- **行内公式**：使用 `\\(...\\)` 格式（不使用 `$...$`）\n- **行间公式**：统一使用 `\\[...\\]` 格式\n- 行间公式块内部内容保持不变\n\n---\n\n## 语言与标点规范\n\n- 如果用户使用中文提问，全程使用中文回复，并使用规范中文标点（，。、；：\"\"''！？）\n- 如果用户使用英文或其他语言提问，使用对应语言回复\n- 专有名词（如公司英文名、财务术语缩写）可保留原文\n\n---\n\n## 边界与异常处理\n\n| 场景 | 处理方式 |\n|------|---------|\n| 用户未提供公司名/代码 | 礼貌询问：\"请提供您想覆盖的上市公司名称或股票代码。\" |\n| 脚本返回实体识别为空 | 原样返回：\"目前仅支持沪深京港美实体进行首次覆盖。您提供的实体不在支持范围内，请确认后重新输入。\" |\n| 脚本返回入参不合法 | 原样返回：\"入参不支持，请重新检查实体类型和报告期。\" |\n| 脚本返回接口调用失败/超时 | 原样返回：\"报告生成服务暂时不可用，请稍后重试。\" |\n| 接口返回数据缺少总结章节 | 在总结位置标注：\"（总结章节数据暂缺，请参阅附件完整报告）\" |\n| 用户要求看完整正文 | 引导用户下载附件：\"完整正文内容请查看附件中的PDF或Word版报告。\" |\n\n---\n\n## 与其他技能的区分\n\n- **首次覆盖/深度研究报告**（本技能）：针对一家公司做全面、系统性的首次覆盖或深度研究，产出完整报告\n- **业绩点评**：针对某次财报发布做简要点评，不是本技能的范围\n- **事件点评**：针对某一突发事件对公司影响做点评，不是本技能的范围\n- **行业报告**：针对某一行业做研究，不是本技能的范围\n\n如果用户的需求属于业绩点评、事件点评或行业报告，应引导至对应技能，不在本技能内处理。\n\n---\n\n## 脚本/文件说明\n\n| 脚本/文件 | 功能 |\n| --- | --- |\n| `scripts/generate_deep_research_report.py` | 统一脚本：实体识别、市场校验、调用首次覆盖写作接口生成报告，一步完成 |\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn7b4ptpdag877t9kmq8axyja182taab\",\n  \"slug\": \"initiation-of-coverage-or-deep-dive\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1776424717457\n}\n\nFile v1.0.4:skill-card.md\n\n## Description:\n\nGenerates initiation-of-coverage or deep-dive equity research reports for supported A-share, Hong Kong, U.S., and Beijing Stock Exchange listed companies using Eastmoney data.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[financial-ai-analyst](https://clawhub.ai/user/financial-ai-analyst)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and financial analysts use this skill to request comprehensive first-coverage or deep-dive research reports for supported listed companies. The skill returns a structured report response with generated content, attachment paths, and a share link when available.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends the user's original prompt to Eastmoney's report-generation API.\n\nMitigation: Avoid prompts that contain confidential, personal, or restricted information, and disclose the external data transfer to users before operation.\n\nRisk: The skill depends on EM_API_KEY for external service access.\n\nMitigation: Provide the key only through a controlled environment variable, restrict access to trusted runtimes, and rotate the key if exposure is suspected.\n\nRisk: The skill saves generated PDF and Word report files locally.\n\nMitigation: Use a scoped output directory, review generated files before sharing, and remove files when they are no longer needed.\n\nRisk: The security guidance flags unsafe redirects, unpinned dependencies, and under-scoped permissions as review concerns.\n\nMitigation: Prefer a reviewed release that disables unnecessary redirects, pins dependencies, and explicitly scopes network, environment-variable, and file-write permissions.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/financial-ai-analyst/skills/initiation-of-coverage-or-deep-dive)\n- [Eastmoney initial coverage API endpoint](https://ai-saas.eastmoney.com/proxy/app-robo-advisor-api/assistant/write/initial-coverage)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, files]\n\n**Output Format:** [Markdown response with report text, local PDF/DOCX attachment paths, and a share URL; the helper script emits JSON.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires EM_API_KEY and may save generated report attachments under a local output directory.]\n\n## Skill Version(s):\n\n1.0.4 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.3: 3 files, 6705 bytes\n\nFiles: scripts/generate_deep_research_report.py (10015b), SKILL.md (7152b), _meta.json (154b)\n\nFile v1.0.3:SKILL.md\n\n---\nname: initiation_of_coverage_or_deep_dive\ndescription: >\n  依托东方财富数据库，面向沪深京港美上市公司（A 股、港股、美股、北交所），生成首次覆盖报告或深度研究报告。\n  当用户提及「首次覆盖」「首次覆盖报告」「初始覆盖」「深度研究」「深度报告」「个股深度」「公司深度」「标的深度分析」，或要求对某只股票/上市公司撰写全面、体系化的研究报告时，必须触发本 Skill。\n  即使用户仅表述为「帮我写一份 XX 公司的研究报告」而未出现「深度」「首次覆盖」等词，也应触发。\n  不适用于业绩点评、财报点评、事件点评等场景。\nmetadata:\n  {\n    \"openclaw\": {\n      \"requires\": {\n        \"env\":[\"EM_API_KEY\"]\n      },\n      \"install\": [\n        {\n          \"id\": \"pip-deps\",\n          \"kind\": \"python\",\n          \"package\": \"httpx\",\n          \"label\": \"Install Python dependencies\"\n        }\n      ]\n    }\n  }\n---\n\n# 上市公司首次覆盖报告 / 深度研究报告生成\n\n## 概述\n\n本技能用于生成上市公司的**首次覆盖报告**或**深度研究报告**。通过调用统一脚本 `scripts/generate_deep_research_report.py`，\n一次性完成实体识别、市场校验、报告生成及结果返回。\n\n## 环境变量\n\n| 变量名 | 说明 | 默认 |\n|--------|------|------|\n| `EM_API_KEY` | 接口鉴权密钥（必填） | 无 |\n| `INITIATION_OF_COVERAGE_OR_DEEP_DIVE_OUTPUT_DIR` | 附件输出目录| `./miaoxiang/initiation_of_coverage_or_deep_dive`（相对当前工作目录） |\n\n\n## 前提条件\n\n### 1. 配置 `EM_API_KEY`\n\n```bash\n# macOS / Linux\nexport EM_API_KEY=\"your_api_key_here\"\n```\n\n```powershell\n# Windows PowerShell\n$env:EM_API_KEY=\"your_api_key_here\"\n```\n\n### 2. 安装依赖\n\n```bash\npip3 install httpx --user\n```\n\n\n## 完整工作流程\n\n### 第一步：调用报告生成脚本\n\n调用 `scripts/generate_deep_research_report.py` 脚本，将用户的**原始问句**作为参数传入。该脚本内部自动完成以下全部流程：\n\n1. **实体识别与市场校验**：调用实体识别接口，从用户问句中识别沪深京港美实体，返回标准化信息（`secuCode`、`marketChar`、`classCode`、`secuName`）；多个实体时优先取第一个；未识别到支持的实体则直接返回错误提示。\n2. **报告生成**：将校验通过的实体信息作为参数，调用首次覆盖写作接口生成完整报告。\n\n**调用方式**：\n\n```bash\npython3 {baseDir}/scripts/generate_deep_research_report.py --query \"用户原始问句\"\n```\n\n**脚本输出（JSON 格式）**：\n\n- **成功时**：返回报告全文及附件地址等完整结果，包含报告标题、各章节内容、附件地址、分享链接等。\n- **实体识别为空时**：返回错误信息 `\"目前仅支持沪深京港美实体进行首次覆盖。您提供的实体不在支持范围内，请确认后重新输入。\"`\n- **入参不合法时**：返回 `\"入参不支持，请重新检查实体类型和报告期。\"`\n- **接口调用失败/超时时**：返回 `\"报告生成服务暂时不可用，请稍后重试。\"`\n\n**处理逻辑**：\n\n- 脚本返回成功 → 进入第二步，进行结构化输出\n- 脚本返回错误提示 → 将错误提示原样返回给用户，流程终止\n\n注意：**禁止调用 任何「后台执行、稍后汇报」的方式跑本脚本**，只能在当前会话中同步等待到命令完成，拿到 stdout 的结果后再继续，否则会导致本 Skill 失败。\n\n### 第二步：结构化输出\n\n脚本返回报告全文后，按照以下固定结构进行响应输出。\n\n---\n\n## 输出格式规范\n\n接口返回后，必须严格按以下模板输出，不得增删标题、不得改变顺序、不得添加额外章节：\n\n### 标题\n直接使用接口返回的 `title` 字段，单独成行，一般格式为\"XXX公司首次覆盖报告：XXXXXX\"。\n\n### 正文\n如果接口返回的 `content` 字段有相关行业报告信息，则原文透传；\n否则读取接口返回的附件文件内容，总结相关报告信息返回，记住保证返回的正文内容非空。\n\n### 附件\n接口返回 pdf 以及 docx 格式文件的保存路径。\n\n### 分享链接\n直接使用接口返回的 `shareUrl` 字段，单独成行。\n\n文案必须按以下固定格式输出：\n\n```\n{title}\n\n{content}\n\n---\n\n**附件：**\n\n- 📄 **PDF版完整报告地址**：{pdf_file_path}\n- 📝 **Word版完整报告地址**：{word_file_path}\n\n**分享链接：**\n{shareUrl}\n```\n\n字段映射规则：\n- `{title}` = 脚本返回的 `title`\n- `{content}` = 脚本返回的 `content`\n- `{pdf_file_path}` = 脚本返回的 `pdf_file_path`\n- `{word_file_path}` = 脚本返回的 `word_file_path`\n- `{shareUrl}` = 脚本返回的 `shareUrl`\n\n当附件缺失时：\n- 若仅有一种格式，仅输出存在的那一行（PDF 或 DOCX）。\n- 若两种都不存在，输出：`完整报告：暂无可用附件`\n\n## 格式要求\n\n响应事件流中的数学公式格式规范：\n- **行内公式**：使用 `\\(...\\)` 格式（不使用 `$...$`）\n- **行间公式**：统一使用 `\\[...\\]` 格式\n- 行间公式块内部内容保持不变\n\n---\n\n## 语言与标点规范\n\n- 如果用户使用中文提问，全程使用中文回复，并使用规范中文标点（，。、；：\"\"''！？）\n- 如果用户使用英文或其他语言提问，使用对应语言回复\n- 专有名词（如公司英文名、财务术语缩写）可保留原文\n\n---\n\n## 边界与异常处理\n\n| 场景 | 处理方式 |\n|------|---------|\n| 用户未提供公司名/代码 | 礼貌询问：\"请提供您想覆盖的上市公司名称或股票代码。\" |\n| 脚本返回实体识别为空 | 原样返回：\"目前仅支持沪深京港美实体进行首次覆盖。您提供的实体不在支持范围内，请确认后重新输入。\" |\n| 脚本返回入参不合法 | 原样返回：\"入参不支持，请重新检查实体类型和报告期。\" |\n| 脚本返回接口调用失败/超时 | 原样返回：\"报告生成服务暂时不可用，请稍后重试。\" |\n| 接口返回数据缺少总结章节 | 在总结位置标注：\"（总结章节数据暂缺，请参阅附件完整报告）\" |\n| 用户要求看完整正文 | 引导用户下载附件：\"完整正文内容请查看附件中的PDF或Word版报告。\" |\n\n---\n\n## 与其他技能的区分\n\n- **首次覆盖/深度研究报告**（本技能）：针对一家公司做全面、系统性的首次覆盖或深度研究，产出完整报告\n- **业绩点评**：针对某次财报发布做简要点评，不是本技能的范围\n- **事件点评**：针对某一突发事件对公司影响做点评，不是本技能的范围\n- **行业报告**：针对某一行业做研究，不是本技能的范围\n\n如果用户的需求属于业绩点评、事件点评或行业报告，应引导至对应技能，不在本技能内处理。\n\n---\n\n## 脚本/文件说明\n\n| 脚本/文件 | 功能 |\n| --- | --- |\n| `scripts/generate_deep_research_report.py` | 统一脚本：实体识别、市场校验、调用首次覆盖写作接口生成报告，一步完成 |\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn7b4ptpdag877t9kmq8axyja182taab\",\n  \"slug\": \"initiation-of-coverage-or-deep-dive\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1775818944819\n}\n\nArchive v1.0.2: 3 files, 6484 bytes\n\nFiles: scripts/generate_deep_research_report.py (10011b), SKILL.md (6512b), _meta.json (154b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: initiation_of_coverage_or_deep_dive\ndescription: >\n  依托东方财富数据库，面向沪深京港美上市公司（A 股、港股、美股、北交所），生成首次覆盖报告或深度研究报告。\n  当用户提及「首次覆盖」「首次覆盖报告」「初始覆盖」「深度研究」「深度报告」「个股深度」「公司深度」「标的深度分析」，或要求对某只股票/上市公司撰写全面、体系化的研究报告时，必须触发本 Skill。\n  即使用户仅表述为「帮我写一份 XX 公司的研究报告」而未出现「深度」「首次覆盖」等词，也应触发。\n  不适用于业绩点评、财报点评、事件点评等场景。\nmetadata:\n  {\n    \"openclaw\": {\n      \"requires\": {\n        \"env\":[\"EM_API_KEY\"]\n      },\n      \"install\": [\n        {\n          \"id\": \"pip-deps\",\n          \"kind\": \"python\",\n          \"package\": \"httpx\",\n          \"label\": \"Install Python dependencies\"\n        }\n      ]\n    }\n  }\n---\n\n# 上市公司首次覆盖报告 / 深度研究报告生成\n\n## 概述\n\n本技能用于生成上市公司的**首次覆盖报告**或**深度研究报告**。通过调用统一脚本 `scripts/generate_deep_research_report.py`，\n一次性完成实体识别、市场校验、报告生成及结果返回。\n\n## 环境变量\n\n| 变量名 | 说明 | 默认 |\n|--------|------|------|\n| `EM_API_KEY` | 接口鉴权密钥（必填） | 无 |\n| `INITIATION_OF_COVERAGE_OR_DEEP_DIVE_OUTPUT_DIR` | 附件输出目录| `miaoxiang/initiation_of_coverage_or_deep_dive`（相对当前工作目录） |\n\n\n## 前提条件\n\n### 1. 配置 `EM_API_KEY`\n\n```bash\n# macOS / Linux\nexport EM_API_KEY=\"your_api_key_here\"\n```\n\n```powershell\n# Windows PowerShell\n$env:EM_API_KEY=\"your_api_key_here\"\n```\n\n### 2. 安装依赖\n\n```bash\npip3 install httpx --user\n```\n\n\n## 完整工作流程\n\n### 第一步：调用报告生成脚本\n\n调用 `scripts/generate_deep_research_report.py` 脚本，将用户的**原始问句**作为参数传入。该脚本内部自动完成以下全部流程：\n\n1. **实体识别与市场校验**：调用实体识别接口，从用户问句中识别沪深京港美实体，返回标准化信息（`secuCode`、`marketChar`、`classCode`、`secuName`）；多个实体时优先取第一个；未识别到支持的实体则直接返回错误提示。\n2. **报告生成**：将校验通过的实体信息作为参数，调用首次覆盖写作接口生成完整报告。\n\n**调用方式**：\n\n```bash\npython3 {baseDir}/scripts/generate_deep_research_report.py --query \"用户原始问句\"\n```\n\n**脚本输出（JSON 格式）**：\n\n- **成功时**：返回报告全文及附件地址等完整结果，包含报告标题、各章节内容、附件地址、分享链接等。\n- **实体识别为空时**：返回错误信息 `\"目前仅支持沪深京港美实体进行首次覆盖。您提供的实体不在支持范围内，请确认后重新输入。\"`\n- **入参不合法时**：返回 `\"入参不支持，请重新检查实体类型和报告期。\"`\n- **接口调用失败/超时时**：返回 `\"报告生成服务暂时不可用，请稍后重试。\"`\n\n**处理逻辑**：\n\n- 脚本返回成功 → 进入第二步，进行结构化输出\n- 脚本返回错误提示 → 将错误提示原样返回给用户，流程终止\n\n注意：**禁止调用 任何「后台执行、稍后汇报」的方式跑本脚本**，只能在当前会话中同步等待到命令完成，拿到 stdout 的结果后再继续，否则会导致本 Skill 失败。\n\n### 第二步：结构化输出\n\n脚本返回报告全文后，按照以下固定结构进行响应输出。\n\n---\n\n## 输出格式模板\n\n严格按照以下格式组织响应内容：\n\n```\n## {title}\n\n{此处放置接口返回的报告标题，一般格式为\"XXX公司首次覆盖报告：XXXXXX\"}\n\n---\n\n......此处省略多个章节，包括公司概况、业务模式、核心竞争力、财务分析、盈利预测与估值分析、风险提示等章节，如需查看详细信息，请查看附件PDF或doc.......\n\n### 第七章 总结\n\n{此处放置接口返回的\"总结\"章节完整内容}\n\n---\n\n### 附件\n\n- 📄 **PDF版完整报告地址**：{pdf_file_path}\n- 📝 **Word版完整报告地址**：{word_file_path}\n\n### 溯源\n详见附件\n\n### 分享链接\n{share_url}\n```\n\n---\n\n## 格式要求\n\n响应事件流中的数学公式格式规范：\n- **行内公式**：使用 `\\(...\\)` 格式（不使用 `$...$`）\n- **行间公式**：统一使用 `\\[...\\]` 格式\n- 行间公式块内部内容保持不变\n\n---\n\n## 语言与标点规范\n\n- 如果用户使用中文提问，全程使用中文回复，并使用规范中文标点（，。、；：\"\"''！？）\n- 如果用户使用英文或其他语言提问，使用对应语言回复\n- 专有名词（如公司英文名、财务术语缩写）可保留原文\n\n---\n\n## 边界与异常处理\n\n| 场景 | 处理方式 |\n|------|---------|\n| 用户未提供公司名/代码 | 礼貌询问：\"请提供您想覆盖的上市公司名称或股票代码。\" |\n| 脚本返回实体识别为空 | 原样返回：\"目前仅支持沪深京港美实体进行首次覆盖。您提供的实体不在支持范围内，请确认后重新输入。\" |\n| 脚本返回入参不合法 | 原样返回：\"入参不支持，请重新检查实体类型和报告期。\" |\n| 脚本返回接口调用失败/超时 | 原样返回：\"报告生成服务暂时不可用，请稍后重试。\" |\n| 接口返回数据缺少总结章节 | 在总结位置标注：\"（总结章节数据暂缺，请参阅附件完整报告）\" |\n| 用户要求看完整正文 | 引导用户下载附件：\"完整正文内容请查看附件中的PDF或Word版报告。\" |\n\n---\n\n## 与其他技能的区分\n\n- **首次覆盖/深度研究报告**（本技能）：针对一家公司做全面、系统性的首次覆盖或深度研究，产出完整报告\n- **业绩点评**：针对某次财报发布做简要点评，不是本技能的范围\n- **事件点评**：针对某一突发事件对公司影响做点评，不是本技能的范围\n- **行业报告**：针对某一行业做研究，不是本技能的范围\n\n如果用户的需求属于业绩点评、事件点评或行业报告，应引导至对应技能，不在本技能内处理。\n\n---\n\n## 脚本/文件说明\n\n| 脚本/文件 | 功能 |\n| --- | --- |\n| `scripts/generate_deep_research_report.py` | 统一脚本：实体识别、市场校验、调用首次覆盖写作接口生成报告，一步完成 |\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn7b4ptpdag877t9kmq8axyja182taab\",\n  \"slug\": \"initiation-of-coverage-or-deep-dive\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1775219984640\n}\n\nArchive v1.0.1: 3 files, 6510 bytes\n\nFiles: scripts/generate_deep_research_report.py (10083b), SKILL.md (6512b), _meta.json (154b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: initiation_of_coverage_or_deep_dive\ndescription: >\n  依托东方财富数据库，面向沪深京港美上市公司（A 股、港股、美股、北交所），生成首次覆盖报告或深度研究报告。\n  当用户提及「首次覆盖」「首次覆盖报告」「初始覆盖」「深度研究」「深度报告」「个股深度」「公司深度」「标的深度分析」，或要求对某只股票/上市公司撰写全面、体系化的研究报告时，必须触发本 Skill。\n  即使用户仅表述为「帮我写一份 XX 公司的研究报告」而未出现「深度」「首次覆盖」等词，也应触发。\n  不适用于业绩点评、财报点评、事件点评等场景。\nmetadata:\n  {\n    \"openclaw\": {\n      \"requires\": {\n        \"env\":[\"EM_API_KEY\"]\n      },\n      \"install\": [\n        {\n          \"id\": \"pip-deps\",\n          \"kind\": \"python\",\n          \"package\": \"httpx\",\n          \"label\": \"Install Python dependencies\"\n        }\n      ]\n    }\n  }\n---\n\n# 上市公司首次覆盖报告 / 深度研究报告生成\n\n## 概述\n\n本技能用于生成上市公司的**首次覆盖报告**或**深度研究报告**。通过调用统一脚本 `scripts/generate_deep_research_report.py`，\n一次性完成实体识别、市场校验、报告生成及结果返回。\n\n## 环境变量\n\n| 变量名 | 说明 | 默认 |\n|--------|------|------|\n| `EM_API_KEY` | 接口鉴权密钥（必填） | 无 |\n| `INITIATION_OF_COVERAGE_OR_DEEP_DIVE_OUTPUT_DIR` | 附件输出目录| `miaoxiang/initiation_of_coverage_or_deep_dive`（相对当前工作目录） |\n\n\n## 前提条件\n\n### 1. 配置 `EM_API_KEY`\n\n```bash\n# macOS / Linux\nexport EM_API_KEY=\"your_api_key_here\"\n```\n\n```powershell\n# Windows PowerShell\n$env:EM_API_KEY=\"your_api_key_here\"\n```\n\n### 2. 安装依赖\n\n```bash\npip3 install httpx --user\n```\n\n\n## 完整工作流程\n\n### 第一步：调用报告生成脚本\n\n调用 `scripts/generate_deep_research_report.py` 脚本，将用户的**原始问句**作为参数传入。该脚本内部自动完成以下全部流程：\n\n1. **实体识别与市场校验**：调用实体识别接口，从用户问句中识别沪深京港美实体，返回标准化信息（`secuCode`、`marketChar`、`classCode`、`secuName`）；多个实体时优先取第一个；未识别到支持的实体则直接返回错误提示。\n2. **报告生成**：将校验通过的实体信息作为参数，调用首次覆盖写作接口生成完整报告。\n\n**调用方式**：\n\n```bash\npython3 {baseDir}/scripts/generate_deep_research_report.py --query \"用户原始问句\"\n```\n\n**脚本输出（JSON 格式）**：\n\n- **成功时**：返回报告全文及附件地址等完整结果，包含报告标题、各章节内容、附件地址、分享链接等。\n- **实体识别为空时**：返回错误信息 `\"目前仅支持沪深京港美实体进行首次覆盖。您提供的实体不在支持范围内，请确认后重新输入。\"`\n- **入参不合法时**：返回 `\"入参不支持，请重新检查实体类型和报告期。\"`\n- **接口调用失败/超时时**：返回 `\"报告生成服务暂时不可用，请稍后重试。\"`\n\n**处理逻辑**：\n\n- 脚本返回成功 → 进入第二步，进行结构化输出\n- 脚本返回错误提示 → 将错误提示原样返回给用户，流程终止\n\n注意：**禁止调用 任何「后台执行、稍后汇报」的方式跑本脚本**，只能在当前会话中同步等待到命令完成，拿到 stdout 的结果后再继续，否则会导致本 Skill 失败。\n\n### 第二步：结构化输出\n\n脚本返回报告全文后，按照以下固定结构进行响应输出。\n\n---\n\n## 输出格式模板\n\n严格按照以下格式组织响应内容：\n\n```\n## {title}\n\n{此处放置接口返回的报告标题，一般格式为\"XXX公司首次覆盖报告：XXXXXX\"}\n\n---\n\n......此处省略多个章节，包括公司概况、业务模式、核心竞争力、财务分析、盈利预测与估值分析、风险提示等章节，如需查看详细信息，请查看附件PDF或doc.......\n\n### 第七章 总结\n\n{此处放置接口返回的\"总结\"章节完整内容}\n\n---\n\n### 附件\n\n- 📄 **PDF版完整报告地址**：{pdf_file_path}\n- 📝 **Word版完整报告地址**：{word_file_path}\n\n### 溯源\n详见附件\n\n### 分享链接\n{share_url}\n```\n\n---\n\n## 格式要求\n\n响应事件流中的数学公式格式规范：\n- **行内公式**：使用 `\\(...\\)` 格式（不使用 `$...$`）\n- **行间公式**：统一使用 `\\[...\\]` 格式\n- 行间公式块内部内容保持不变\n\n---\n\n## 语言与标点规范\n\n- 如果用户使用中文提问，全程使用中文回复，并使用规范中文标点（，。、；：\"\"''！？）\n- 如果用户使用英文或其他语言提问，使用对应语言回复\n- 专有名词（如公司英文名、财务术语缩写）可保留原文\n\n---\n\n## 边界与异常处理\n\n| 场景 | 处理方式 |\n|------|---------|\n| 用户未提供公司名/代码 | 礼貌询问：\"请提供您想覆盖的上市公司名称或股票代码。\" |\n| 脚本返回实体识别为空 | 原样返回：\"目前仅支持沪深京港美实体进行首次覆盖。您提供的实体不在支持范围内，请确认后重新输入。\" |\n| 脚本返回入参不合法 | 原样返回：\"入参不支持，请重新检查实体类型和报告期。\" |\n| 脚本返回接口调用失败/超时 | 原样返回：\"报告生成服务暂时不可用，请稍后重试。\" |\n| 接口返回数据缺少总结章节 | 在总结位置标注：\"（总结章节数据暂缺，请参阅附件完整报告）\" |\n| 用户要求看完整正文 | 引导用户下载附件：\"完整正文内容请查看附件中的PDF或Word版报告。\" |\n\n---\n\n## 与其他技能的区分\n\n- **首次覆盖/深度研究报告**（本技能）：针对一家公司做全面、系统性的首次覆盖或深度研究，产出完整报告\n- **业绩点评**：针对某次财报发布做简要点评，不是本技能的范围\n- **事件点评**：针对某一突发事件对公司影响做点评，不是本技能的范围\n- **行业报告**：针对某一行业做研究，不是本技能的范围\n\n如果用户的需求属于业绩点评、事件点评或行业报告，应引导至对应技能，不在本技能内处理。\n\n---\n\n## 脚本/文件说明\n\n| 脚本/文件 | 功能 |\n| --- | --- |\n| `scripts/generate_deep_research_report.py` | 统一脚本：实体识别、市场校验、调用首次覆盖写作接口生成报告，一步完成 |\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7b4ptpdag877t9kmq8axyja182taab\",\n  \"slug\": \"initiation-of-coverage-or-deep-dive\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1775210024990\n}\n\nArchive v1.0.0: 3 files, 5963 bytes\n\nFiles: scripts/generate_deep_research_report.py (10219b), SKILL.md (5784b), _meta.json (154b)\n\nFile v1.0.0:SKILL.md\n\n---\r\nname: initiation_of_coverage_or_deep_dive\r\ndescription: >\r\n  上市公司首次覆盖报告/深度研究报告生成技能。当用户提到针对上市公司的\"首次覆盖\"、\"深度研究\"、\"深度报告\"、\"个股深度\"、\r\n  \"首次覆盖报告\"、\"初始覆盖\"、\"公司深度\"、\"标的深度分析\"或要求对某只股票/上市公司做全面研究报告时，\r\n  必须触发此技能。适用于沪深京港美上市公司（A股、港股、美股、北交所）。即使用户只说\"帮我写一份XX公司的研究报告\"\r\n  也应触发。此技能不适用于业绩点评、财报点评、事件点评等场景（这些有各自独立的技能）。\r\n---\r\n\r\n# 上市公司首次覆盖报告 / 深度研究报告生成\r\n\r\n## 概述\r\n\r\n本技能用于生成上市公司的**首次覆盖报告**或**深度研究报告**。通过调用统一脚本 `scripts/generate_deep_research_report.py`，\r\n一次性完成实体识别、市场校验、报告生成及结果返回。\r\n\r\n---\r\n\r\n## 完整工作流程\r\n\r\n### 第一步：调用报告生成脚本\r\n\r\n调用 `scripts/generate_deep_research_report.py` 脚本，将用户的**原始问句**作为参数传入。该脚本内部自动完成以下全部流程：\r\n\r\n1. **实体识别与市场校验**：调用实体识别接口，从用户问句中识别沪深京港美实体，返回标准化信息（`secuCode`、`marketChar`、`classCode`、`secuName`）；多个实体时优先取第一个；未识别到支持的实体则直接返回错误提示。\r\n2. **报告生成**：将校验通过的实体信息作为参数，调用首次覆盖写作接口生成完整报告。\r\n\r\n**调用方式**：\r\n\r\n```bash\r\npython3 {baseDir}/scripts/generate_deep_research_report.py \"用户原始问句\"\r\n```\r\n\r\n**脚本输出（JSON 格式）**：\r\n\r\n- **成功时**：返回报告全文及附件地址等完整结果，包含报告标题、各章节内容、附件地址、分享链接等。\r\n- **实体识别为空时**：返回错误信息 `\"目前仅支持沪深京港美实体进行首次覆盖。您提供的实体不在支持范围内，请确认后重新输入。\"`\r\n- **入参不合法时**：返回 `\"入参不支持，请重新检查实体类型和报告期。\"`\r\n- **接口调用失败/超时时**：返回 `\"报告生成服务暂时不可用，请稍后重试。\"`\r\n\r\n**处理逻辑**：\r\n\r\n- 脚本返回成功 → 进入第二步，进行结构化输出\r\n- 脚本返回错误提示 → 将错误提示原样返回给用户，流程终止\r\n\r\n注意：**禁止调用 任何「后台执行、稍后汇报」的方式跑本脚本**，只能在当前会话中同步等待到命令完成，拿到 stdout 的结果后再继续，否则会导致本 Skill 失败。\r\n\r\n### 第二步：结构化输出\r\n\r\n脚本返回报告全文后，按照以下固定结构进行响应输出。\r\n\r\n---\r\n\r\n## 输出格式模板\r\n\r\n严格按照以下格式组织响应内容：\r\n\r\n```\r\n## {title}\r\n\r\n{此处放置接口返回的报告标题，一般格式为\"XXX公司首次覆盖报告：XXXXXX\"}\r\n\r\n---\r\n\r\n......此处省略多个章节，包括公司概况、业务模式、核心竞争力、财务分析、盈利预测与估值分析、风险提示等章节，如需查看详细信息，请查看附件PDF或doc.......\r\n\r\n### 第七章 总结\r\n\r\n{此处放置接口返回的\"总结\"章节完整内容}\r\n\r\n---\r\n\r\n### 附件\r\n\r\n- 📄 **PDF版完整报告地址**：{pdf_file_path}\r\n- 📝 **Word版完整报告地址**：{word_file_path}\r\n\r\n### 溯源\r\n详见附件\r\n\r\n### 分享链接\r\n{share_url}\r\n```\r\n\r\n---\r\n\r\n## 格式要求\r\n\r\n响应事件流中的数学公式格式规范：\r\n- **行内公式**：使用 `\\(...\\)` 格式（不使用 `$...$`）\r\n- **行间公式**：统一使用 `\\[...\\]` 格式\r\n- 行间公式块内部内容保持不变\r\n\r\n---\r\n\r\n## 语言与标点规范\r\n\r\n- 如果用户使用中文提问，全程使用中文回复，并使用规范中文标点（，。、；：\"\"''！？）\r\n- 如果用户使用英文或其他语言提问，使用对应语言回复\r\n- 专有名词（如公司英文名、财务术语缩写）可保留原文\r\n\r\n---\r\n\r\n## 边界与异常处理\r\n\r\n| 场景 | 处理方式 |\r\n|------|---------|\r\n| 用户未提供公司名/代码 | 礼貌询问：\"请提供您想覆盖的上市公司名称或股票代码。\" |\r\n| 脚本返回实体识别为空 | 原样返回：\"目前仅支持沪深京港美实体进行首次覆盖。您提供的实体不在支持范围内，请确认后重新输入。\" |\r\n| 脚本返回入参不合法 | 原样返回：\"入参不支持，请重新检查实体类型和报告期。\" |\r\n| 脚本返回接口调用失败/超时 | 原样返回：\"报告生成服务暂时不可用，请稍后重试。\" |\r\n| 接口返回数据缺少总结章节 | 在总结位置标注：\"（总结章节数据暂缺，请参阅附件完整报告）\" |\r\n| 用户要求看完整正文 | 引导用户下载附件：\"完整正文内容请查看附件中的PDF或Word版报告。\" |\r\n\r\n---\r\n\r\n## 与其他技能的区分\r\n\r\n- **首次覆盖/深度研究报告**（本技能）：针对一家公司做全面、系统性的首次覆盖或深度研究，产出完整报告\r\n- **业绩点评**：针对某次财报发布做简要点评，不是本技能的范围\r\n- **事件点评**：针对某一突发事件对公司影响做点评，不是本技能的范围\r\n- **行业报告**：针对某一行业做研究，不是本技能的范围\r\n\r\n如果用户的需求属于业绩点评、事件点评或行业报告，应引导至对应技能，不在本技能内处理。\r\n\r\n---\r\n\r\n## 脚本/文件说明\r\n\r\n| 脚本/文件 | 功能 |\r\n| --- | --- |\r\n| `scripts/generate_deep_research_report.py` | 统一脚本：实体识别、市场校验、调用首次覆盖写作接口生成报告，一步完成 |\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7b4ptpdag877t9kmq8axyja182taab\",\n  \"slug\": \"initiation-of-coverage-or-deep-dive\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1774607292711\n}","readmeExcerpt":"Skill: Initiation of Coverage Agent Owner: financial-ai-analyst Summary: 依托东方财富数据库，面向沪深京港美上市公司（A 股、港股、美股、北交所），生成首次覆盖报告或深度研究报告。 当用户提及「首次覆盖」「首次覆盖报告」「初始覆盖」「深度研究」「深度报告」「个股深度」「公司深度」「标的深度分析」，或要求对某只股票/上市公司撰写全面、体系化的研究报告时，必须触发本 Skill。 即使用户... Tags: coverage:1.0.3, financial:1.0.3, latest:1.0.4, report:1.0.3, research:1.0.3, stock:1.0.3 Version history: v1.0.4 | 2026-04-17T11:18:37.457Z | user Publish 1.0.4 v1.0.3 | 2026-04-10","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# macOS / Linux\nexport EM_API_KEY=\"your_api_key_here\""},{"language":"powershell","snippet":"# Windows PowerShell\n$env:EM_API_KEY=\"your_api_key_here\""},{"language":"bash","snippet":"pip3 install httpx --user"},{"language":"bash","snippet":"python3 {baseDir}/scripts/generate_deep_research_report.py --query \"用户原始问句\""},{"language":"text","snippet":"{title}\n\n{content}\n\n---\n\n**附件：**\n\n- 📄 **PDF版完整报告地址**：{pdf_file_path}\n- 📝 **Word版完整报告地址**：{word_file_path}\n\n**分享链接：**\n{shareUrl}"},{"language":"bash","snippet":"# macOS / Linux\nexport EM_API_KEY=\"your_api_key_here\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: initiation-of-coverage-or-deep-dive\ndescription: >\n  依托东方财富数据库，面向沪深京港美上市公司（A 股、港股、美股、北交所），生成首次覆盖报告或深度研究报告。\n  当用户提及「首次覆盖」「首次覆盖报告」「初始覆盖」「深度研究」「深度报告」「个股深度」「公司深度」「标的深度分析」，或要求对某只股票/上市公司撰写全面、体系化的研究报告时，必须触发本 Skill。\n  即使用户仅表述为「帮我写一份 XX 公司的研究报告」而未出现「深度」「首次覆盖」等词，也应触发。\n  不适用于业绩点评、财报点评、事件点评等场景。\nmetadata:\n  {\n    \"openclaw\": {\n      \"requires\": {\n        \"env\":[\"EM_API_KEY\"]\n      },\n      \"install\": [\n        {\n          \"id\": \"pip-deps\",\n          \"kind\": \"python\",\n          \"package\": \"httpx\",\n          \"label\": \"Install Python dependencies\"\n        }\n      ]\n    }\n  }\n---\n\n# 上市公司首次覆盖报告 / 深度研究报告生成\n\n## 概述\n\n本技能用于生成上市公司的**首次覆盖报告**或**深度研究报告**。通过调用统一脚本 `scripts/generate_deep_research_report.py`，\n一次性完成实体识别、市场校验、报告生成及结果返回。\n\n## 环境变量\n\n| 变量名 | 说明 | 默认 |\n|--------|------|------|\n| `EM_API_KEY` | 接口鉴权密钥（必填） | 无 |\n| `INITIATION_OF_COVERAGE_OR_DEEP_DIVE_OUTPUT_DIR` | 附件输出目录| `./miaoxiang/initiation_of_coverage_or_deep_dive`（相对当前工作目录） |\n\n\n## 前提条件\n\n### 1. 配置 `EM_API_KEY`\n\n```bash\n# macOS / Linux\nexport EM_API_KEY=\"your_api_key_here\"\n```\n\n```powershell\n# Windows PowerShell\n$env:EM_API_KEY=\"your_api_key_here\"\n```\n\n### 2. 安装依赖\n\n```bash\npip3 install httpx --user\n```\n\n\n## 完整工作流程\n\n### 第一步：调用报告生成脚本\n\n调用 `scripts/generate_deep_research_report.py` 脚本，将用户的**原始问句**作为参数传入。该脚本内部自动完成以下全部流程：\n\n1. **实体识别与市场校验**：调用实体识别接口，从用户问句中识别沪深京港美实体，返回标准化信息（`secuCode`、`marketChar`、`classCode`、`secuName`）；多个实体时优先取第一个；未识别到支持的实体则直接返回错误提示。\n2. **报告生成**：将校验通过的实体信息作为参数，调用首次覆盖写作接口生成完整报告。\n\n**调用方式**：\n\n```bash\npython3 {baseDir}/scripts/generate_deep_research_report.py --query \"用户原始问句\"\n```\n\n**脚本输出（JSON 格式）**：\n\n- **成功时**：返回报告全文及附件地址等完整结果，包含报告标题、各章节内容、附件地址、分享链接等。\n- **实体识别为空时**：返回错误信息 `\"目前仅支持沪深京港美实体进行首次覆盖。您提供的实体不在支持范围内，请确认后重新输入。\"`\n- **入参不合法时**：返回 `\"入参不支持，请重新检查实体类型和报告期。\"`\n- **接口调用失败/超时时**：返回 `\"报告生成服务暂时不可用，请稍后重试。\"`\n\n**处理逻辑**：\n\n- 脚本返回成功 → 进入第二步，进行结构化输出\n- 脚本返回错误提示 → 将错误提示原样返回给用户，流程终止\n\n注意：**禁止调用 任何「后台执行、稍后汇报」的方式跑本脚本**，只能在当前会话中同步等待到命令完成，拿到 stdout 的结果后再继续，否则会导致本 Skill 失败。\n\n### 第二步：结构化输出\n\n脚本返回报告全文后，按照以下固定结构进行响应输出。\n\n---\n\n## 输出格式规范\n\n接口返回后，必须严格按以下模板输出，不得增删标题、不得改变顺序、不得添加额外章节：\n\n### 标题\n直接使用接口返回的 `title` 字段，单独成行，一般格式为\"XXX公司首次覆盖报告：XXXXXX\"。\n\n### 正文\n如果接口返回的 `content` 字段有相关行业报告信息，则原文透传；\n否则读取接口返回的附件文件内容，总结相关报告信息返回，记住保证返回的正文内容非空。\n\n### 附件\n接口返回 pdf 以及 docx 格式文件的保存路径。\n\n### 分享链接\n直接使用接口返回的 `shareUrl` 字段，单独成行。\n\n文案必须按以下固定格式输出：\n\n```\n{title}\n\n{content}\n\n---\n\n**附件：**\n\n- 📄 **PDF版完整报告地址**：{pdf_file_path}\n- 📝 **Word版完整报告地址**：{word_file_path}\n\n**分享链接：**\n{shareUrl}\n```\n\n字段映射规则：\n- `{title}` = 脚本返回的 `title`\n- `{content}` = 脚本返回的 `content`\n- `{pdf_file_path}` = 脚本返回的 `pdf_file_path`\n- `{word_file_path}` = 脚本返回的 `word_file_path`\n- `{shareUrl}` = 脚本返回的 `shareUrl`\n\n当附件缺失时：\n- 若仅有一种格式，仅输出存在的那一行（PDF 或 DOCX）。\n- 若两种都不存在，输出：`完整报告：暂无可用附件`\n\n## 格式要求\n\n响应事件流中的数学公式格式规范：\n- **行内公式**：使用 `\\(...\\)` 格式（不使用 `$...$`）\n- **行间公式**：统一使用 `\\[...\\]` 格式\n- 行间公式块内部内容保持不变\n\n---\n\n## 语言与标点规范\n\n- 如果用户使用中文提问，全程使用中文回复，并使用规范中文标点（，。、；：\"\"''！？）\n- 如果用户使用英文或其他语言提问，使用对应语言回复\n- 专有名词（如公司英文名、财务术语缩写）可保留原文\n\n---\n\n## 边界与异常处理\n\n| 场景 | 处理方式 |\n|------|---------|\n| 用户未提供公司名/代码 | 礼貌询问：\"请提供您想覆盖的上市公司名称或股票代码"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7b4ptpdag877t9kmq8axyja182taab\",\n  \"slug\": \"initiation-of-coverage-or-deep-dive\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1776424717457\n}"},{"path":"skill-card.md","content":"## Description:\n\nGenerates initiation-of-coverage or deep-dive equity research reports for supported A-share, Hong Kong, U.S., and Beijing Stock Exchange listed companies using Eastmoney data.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[financial-ai-analyst](https://clawhub.ai/user/financial-ai-analyst)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and financial analysts use this skill to request comprehensive first-coverage or deep-dive research reports for supported listed companies. The skill returns a structured report response with generated content, attachment paths, and a share link when available.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends the user's original prompt to Eastmoney's report-generation API.\n\nMitigation: Avoid prompts that contain confidential, personal, or restricted information, and disclose the external data transfer to users before operation.\n\nRisk: The skill depends on EM_API_KEY for external service access.\n\nMitigation: Provide the key only through a controlled environment variable, restrict access to trusted runtimes, and rotate the key if exposure is suspected.\n\nRisk: The skill saves generated PDF and Word report files locally.\n\nMitigation: Use a scoped output directory, review generated files before sharing, and remove files when they are no longer needed.\n\nRisk: The security guidance flags unsafe redirects, unpinned dependencies, and under-scoped permissions as review concerns.\n\nMitigation: Prefer a reviewed release that disables unnecessary redirects, pins dependencies, and explicitly scopes network, environment-variable, and file-write permissions.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/financial-ai-analyst/skills/initiation-of-coverage-or-deep-dive)\n- [Eastmoney initial coverage API endpoint](https://ai-saas.eastmoney.com/proxy/app-robo-advisor-api/assistant/write/initial-coverage)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, files]\n\n**Output Format:** [Markdown response with report text, local PDF/DOCX attachment paths, and a share URL; the helper script emits JSON.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires EM_API_KEY and may save generated report attachments under a local output directory.]\n\n## Skill Version(s):\n\n1.0.4 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"依托东方财富数据库，面向沪深京港美上市公司（A 股、港股、美股、北交所），生成首次覆盖报告或深度研究报告。 当用户提及「首次覆盖」「首次覆盖报告」「初始覆盖」「深度研究」「深度报告」「个股深度」「公司深度」「标的深度分析」，或要求对某只股票/上市公司撰写全面、体系化的研究报告时，必须触发本 Skill。 即使用户... Skill: Initiation of Coverage Agent Owner: financial-ai-analyst Summary: 依托东方财富数据库，面向沪深京港美上市公司（A 股、港股、美股、北交所），生成首次覆盖报告或深度研究报告。 当用户提及「首次覆盖」「首次覆盖报告」「初始覆盖」「深度研究」「深度报告」「个股深度」「公司深度」「标的深度分析」，或要求对某只股票/上市公司撰写全面、体系化的研究报告时，必须触发本 Skill。 即使用户... Tags: coverage:1.0.3, financial:1.0.3, latest:1.0.4, report:1.0.3, research:1.0.3, stock:1.0.3 Version history: v1.0.4 | 2026-04-17T11:18:37.457Z | user Publish 1.0.4 v1.0.3 | 2026-04-10","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1007,"uniquenessScore":54,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T02:24:14.216Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T02:24:14.216Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:43:28.104Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}