竞品分析

适用场景

• 竞品分析数据表已存在。
• 需要按计划轮询 competitive_crawl_trigger 表。
• 需要按 category 分组生成标准化报告。
• 需要将摘要发送至 DingTalk 机器人。

请勿使用此技能进行：

• 一次性临时分析
• 无数据库输入的开放式研究
• 无需固定模板的灵活报告生成

必需输入

• 数据库连接：COMPETITIVE_ANALYSIS_DSN
• OSS 服务地址：OSS_ENDPOINT
• OSS 存储桶名称：OSS_BUCKET
• OSS 访问密钥 ID：OSS_ACCESS_KEY_ID
• OSS 访问密钥 Secret：OSS_ACCESS_KEY_SECRET
• DingTalk Webhook 地址：DINGTALK_WEBHOOK
• 可选的 DingTalk 签名密钥：DINGTALK_SECRET
• 在 OpenClaw 中，建议通过 skills.entries.competitive_analysis.env 注入环境变量

目标

1. 查找状态为 success 且未被消费的触发记录。
2. 加载过去 6 个月内的产品、评论和 QA 数据。
3. 按 category 聚合分析结果。
4. 生成 analysis_context.json，供宿主继续进行内容叙事生成。
5. 根据参考 PDF 结构生成 Markdown/HTML 报告骨架。
6. 发送 DingTalk 摘要消息。
7. 成功后将触发记录标记为已消费。

入口点

主命令：

python3 {baseDir}/scripts/run_report.py

常用参数：

• --category CATEGORY
• --since-months 6
• --limit 20

文件清单

• SKILL.md：技能入口说明
• references/report-outline.md：报告结构规范
• references/data-contract.md：数据契约与字段预期
• references/openclaw-setup.md：OpenClaw 配置示例
• scripts/run_report.py：主命令行脚本
• scripts/render_report.py：Markdown/HTML 渲染逻辑
• scripts/send_dingtalk.py：DingTalk 消息发送模块
• analysis_context.json：宿主运行时使用的结构化分析上下文

规则

• 严格遵循参考 PDF 的章节顺序。
• 若字段缺失，保留该章节并标注值为 未采集 或 待补充。
• 保持 CLI 无状态，由外部调度器触发。
• 不在脚本中调用任何外部大模型 API。
• 由宿主运行时基于 analysis_context.json 和 references/report-outline.md 生成更深入的内容叙事。
• 在 OpenClaw 中，优先使用宿主管理的环境注入，而非 .env 文件。

最小工作流

1. 阅读 references/data-contract.md。
2. 确认触发表中已包含消费状态字段。
3. 按照 references/openclaw-setup.md 配置 skills.entries.competitive_analysis.env。
4. 启动新的 OpenClaw 会话以使技能重新加载。
5. 执行 python3 {baseDir}/scripts/run_report.py，或由外部调度器调用。
6. 读取生成的 analysis_context.json。
7. 由宿主运行时根据 references/report-outline.md 生成最终叙事内容。
8. 对最终输出进行报告结构验证。

成功标准

• 检测到新的成功触发记录。
• 按 category 生成了报告。
• 章节结构与参考报告一致。
• DingTalk 成功接收摘要消息。
• 触发记录已被正确标记为已消费。