SKILL.md
概述
通过山行资本的抓取系统已获取的被投公司的运营数据，验证其业务表现，生成产品销售监控报告，分析关键指标，并做数据洞察和山行观点输出。
当前支持的公司：Halara（API endpoint: halara.data.hikecapital.com）
变量说明
执行过程中使用的变量：
{SKILL_DIR}：本 skill 所在目录（即 SKILL.md 文件所在目录）{company}：公司名称（如 halara）{start}：报告起始时间{end}：报告终止时间
路径约定（输入 vs 输出基准不同）：
- 输入文件（任务要求 prompts / 设计规范 template）位于
{SKILL_DIR}下（绝对基准，与 CWD 无关） - 输出与中间文件（
{company}/下的数据/洞察/报告）写入当前工作目录 CWD（相对基准） - agent 执行时需自行解析
{SKILL_DIR}与当前 CWD，两者不要混用
异常处理（所有步骤适用）
本报告用于投资判断，数据缺失时宁缺毋假：任何接口失败、返回为空或内容异常，都如实向用户报告并停下来等用户决策，禁止用常识、公开资料或编造数字补齐缺失数据。
- Step 1 失败（curl 报错 / 返回非 JSON /
dates为空）：报告错误信息，不进入 Step 2，不自行猜测可用时间点。 - Step 3 失败或数据异常（HTTP 非 200 / 返回的是错误页、登录页等明显不是数据报告的内容）：报告状态码与响应摘要，删除已写入的坏数据文件，不进入 Step 4。
- 数据文件结构残缺（字段定义缺失、数据明显不完整）：向用户说明缺失了什么并询问是否继续；继续时洞察与报告须明确注明数据残缺及缺失范围。
工作流程
Step 1: 获取可用时间点
使用 Bash + curl 访问接口获取可生成报告的时间点：
curl -s "https://halara.data.hikecapital.com/bestseller-dates"
# JSON格式，响应示例: {"dates":["2026-03-20","2026-03-13"]}返回可用的时间点列表，用户必须从中选择起始时间和终止时间。
Step 2: 确认报告时间范围
根据用户提示词或主动询问，确认需要生成报告的时间范围：
- 起始时间（必须从可用时间点中选择）
- 终止时间（必须从可用时间点中选择）
Step 3: 获取报告数据
首先创建工作目录：
mkdir -p {company}使用 Bash + curl 访问接口获取详细数据(Markdown格式)，并保存：
curl -s "https://halara.data.hikecapital.com/bestsellers-report?start={start}&end={end}" > {company}/{company}_{start}_{end}_data.md
# 响应: Markdown格式，内含字段定义说明- 文件命名：
{company}{start}{end}_data.md - 保存位置：当前工作目录
{company}文件夹下
Step 4: 数据洞察分析
由当前 agent 直接执行分析任务：
- 阅读任务要求：
{SKILLDIR}/prompts/step4insight.md - 读取数据文件：
{company}/{company}{start}{end}_data.md - 按任务要求生成数据洞察，保存到
{company}/{company}{start}{end}_insight.md
Step 5: 生成HTML报告
报告生成耗时可能达数分钟，执行前先告知用户需要等待。
由当前 agent 直接执行报告生成任务：
- 阅读任务要求：
{SKILLDIR}/prompts/step5report.md - 阅读设计规范：
{SKILLDIR}/template/halarareport.md - 基于数据文件
{company}/{company}{start}{end}data.md和洞察文件{company}/{company}{start}{end}insight.md - 生成单文件 HTML 报告，保存到
{company}/{company}{start}{end}_report.html
Step 6: 收集用户观点
与用户讨论生成的报告，引导用户从投资视角补充观点：
引导问题示例：
- 这段时间的业务表现是否符合预期？
- 有哪些值得关注的风险信号或机会点？
- 与竞品或行业趋势相比有何特点？
更新报告：
- 将用户观点整理成"山行观点"section
- 使用 Edit 工具在 HTML 报告中找到
<section id="hike-viewpoint">或类似标记区域 - 如果没有该区域，在 AI数据洞察 section 后追加山行观点 section
- 保持与整体报告风格一致（参考
template/halara_report.md）