auto-prd-hunter

扫描各平台上的用户投诉，提取痛点，并生成结构化 PRD 及 OpenClaw 任务 JSON。

重要提示

⚠️ 禁止虚构政策：本技能仅返回真实 API 搜索结果。若未获取到任何 API 结果，则返回错误，**绝不生成模拟/虚构数据**。

命令

所有操作均通过封装的 CLI 脚本执行：

python3 {baseDir}/scripts/search.py search-pain-points --keyword "" --max-results 8

工作流程

1. 接收关键词。
2. 运行搜索命令，从 API 获取真实用户投诉。
3. 解析标准输出（stdout）中的 JSON 数据。
4. 提取最多 5 个痛点（含 id、title、severity、context、sources）。
5. 构思产品名称与摘要。
6. 撰写用户故事与 MVP 功能。
7. 推导 openclaw_tasks。
8. **仅输出最终 JSON**（不包含 Markdown 代码块标记、无问候语、无额外说明）。

约束条件

• **必须调用 CLI 脚本**；禁止自行构造或伪造结果。
• 若 API 返回空结果，须返回错误 JSON：{"status":"no_results","error":"No API results found"}
• 最终响应**必须为合法 JSON 格式**。
• 禁止使用 Markdown 代码块标记（如 ```json），禁止添加问候语或解释性文字。
• 若搜索失败，返回：{"status":"error","error":"reason"}

网络请求

本技能将向以下外部服务发起出站网络请求：

• Brave Search API（api.search.brave.com）——用于网页搜索结果
• Hacker News Algolia API（hn.algolia.com）——用于技术社区讨论

⚠️ 隐私声明：您的搜索关键词将被发送至上述外部服务。请勿在关键词中包含敏感或机密信息。

环境变量

脚本可选读取以下环境变量：

若未提供任何 API 密钥，该技能将自动尝试调用 Hacker News API（无需密钥）。

输出 JSON Schema

{
  "status": "success",
  "keyword": "searched keyword",
  "project_name": "product name",
  "summary": "one-line value",
  "pain_points": [
    {
      "id": "PP-001",
      "title": "pain title",
      "severity": "high",
      "context": "description",
      "sources": [
        {
          "platform": "Hacker News",
          "url": "https://news.ycombinator.com/item?id=...",
          "quote": "actual user words from the post"
        }
      ]
    }
  ],
  "user_stories": [
    {
      "id": "US-001",
      "as_a": "role",
      "i_want_to": "desire",
      "so_that": "goal",
      "acceptance_criteria": ["criterion 1"],
      "priority": "P0",
      "pain_point_ids": ["PP-001"]
    }
  ],
  "mvp_features": [
    {
      "id": "F-001",
      "title": "feature name",
      "description": "what it does",
      "priority": "P0",
      "user_story_ids": ["US-001"],
      "pain_point_ids": ["PP-001"]
    }
  ],
  "openclaw_tasks": [
    {
      "task_id": "TASK-001",
      "title": "task name",
      "description": "dev instructions",
      "priority": "P0",
      "acceptance_criteria": ["standard 1"],
      "feature_id": "F-001"
    }
  ],
  "generated_at": "2026-04-07T12:00:00",
  "data_source": "API"
}

错误处理

脚本未找到

若 CLI 脚本不存在或未安装 Python：

{
  "status": "error",
  "error": "Search script not available. Ensure python3 is installed and the script exists at {baseDir}/scripts/search.py"
}

无 API 结果

若所有 API 均未返回结果：

{
  "status": "no_results",
  "keyword": "",
  "error": "No API results found. Try providing API keys (BRAVE_API_KEY) or using a different keyword.",
  "suggestions": [
    "Set BRAVE_API_KEY environment variable",
    "Try a broader keyword",
    "Check network connectivity"
  ]
}

API 请求失败

若 API 调用失败：

{
  "status": "error",
  "error": "API request failed: "
}

数据源

脚本从以下平台抓取用户投诉：

注意：若未配置 API 密钥，则仅能获取 Hacker News 的结果，对于非技术类主题可能覆盖不足。

使用示例

基础用法

python3 scripts/search.py search-pain-points --keyword "remote work" --max-results 10

使用 API 密钥

export BRAVE_API_KEY="your_api_key"
python3 scripts/search.py search-pain-points --keyword "AI tools" --max-results 8

中文内容检索

export BAIDU_API_KEY="your_api_key"
python3 scripts/search.py search-pain-points --keyword "远程办公" --max-results 8

与 Cron 集成

本技能可与 OpenClaw 的 cron 系统集成，实现每日自动 PRD 生成：

{
  "name": "每日痛点挖掘与PRD生成",
  "schedule": {
    "kind": "cron",
    "expr": "0 8 * * *",
    "tz": "Asia/Singapore"
  },
  "payload": {
    "kind": "agentTurn",
    "message": "运行 auto-prd-hunter 调研热门领域痛点并生成PRD"
  },
  "sessionTarget": "isolated"
}

透明度承诺

本技能严格遵循以下原则：

1. 禁止虚构：绝不生成虚假痛点或来源
2. 透明性：所有网络请求均在元数据中明确声明
3. 隐私保护：关键词输入将按声明方式发送至外部 API
4. 真实性：所有来源均包含真实 URL 与原始用户引述
5. 错误处理：当 API 失败或无结果时，返回清晰明确的错误信息

故障排查

“未找到 API 结果”

• 原因：未配置 API 密钥，且 Hacker News 中无相关结果
• 解决方案：设置 BRAVE_API_KEY 或更换关键词重试

“API 请求失败”

• 原因：网络异常或 API 密钥无效
• 解决方案：检查网络连通性并验证 API 密钥有效性

结果数量受限

• 原因：仅使用 Hacker News（技术领域倾向明显）
• 解决方案：配置 BRAVE_API_KEY 以启用更广泛的网页搜索

获取 API 密钥

Brave Search API

1. 访问：https://api.search.brave.com/
2. 注册免费套餐
3. 获取您的 API 密钥
4. 设置环境变量：export BRAVE_API_KEY="your_key"

Baidu Search API

1. 访问：https://cloud.baidu.com/
2. 启用百度搜索 API
3. 获取您的 API 密钥
4. 设置环境变量：export BAIDU_API_KEY="your_key"