shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsNo API key required

产品经理专用-prd及原型-竞品对标评价及分析报告-skill

PRD 竞品对标校验 Skill v4。核心修复：第二阶段（文字描述合理性校验）必须经用户明确确认后才执行，避免 token 过度消耗。默认仅执行第一阶段（原型图片类竞品对标）。

personAuthor: user_bee4336ehubcommunity
downloadDownload package

PRD 竞品对标校验 Skill v4

🎯 核心修复（相比 v3）

| 问题 | v3 缺陷 | v4 解决方案 | |------|---------|-------------| | 第二阶段自动执行 | 虽然有询问流程，但未强制等待用户确认 | 默认不执行第二阶段，必须用户明确回复"继续/是/yes"或添加 --stage2 参数才执行 | | token 过度消耗 | 每次自动执行完整的两阶段校验 | 默认仅执行第一阶段（原型/设计对标），第二阶段需单独触发 | | 交互不清晰 | 询问逻辑可能被忽略 | 第一阶段输出末尾明确标注等待确认，不自动继续 |

📦 文件结构

prd-competitor-check-v4/
├── SKILL.md                      # 本文件
├── competitor_check_v4.py        # 核心执行脚本
├── competitor_refs.json          # 竞品参考链接配置（可手动更新）
├── README.md                     # 使用说明
├── requirements.txt              # 依赖（仅标准库）
├── .clawignore                   # 打包忽略规则
├── claw.config.yml               # 平台发布配置
└── test/
    └── test_competitor_check_v4.py  # 测试脚本

🚀 使用方式

基础用法（默认仅第一阶段）

# 仅执行第一阶段（原型/设计对标）—— 默认行为，不消耗额外 token
python competitor_check_v4.py "PRD 全文" "腾讯 SkillHub：技能商店"

# 直接执行第二阶段（跳过询问）—— 仅当用户明确要求时使用
python competitor_check_v4.py "PRD 全文" "GitHub：技能商店" --stage2

# 检查竞品链接可用性（仅第一阶段）
python competitor_check_v4.py "PRD 全文" "阿里云：配置下发" --check-links

# 使用外部竞品参考文件
python competitor_check_v4.py "PRD 全文" "华为：设备管理" --refs-file ./my_competitor_refs.json

参数说明

| 参数 | 说明 | 默认值 | |------|------|--------| | prd_text | PRD 文档全文 | 必填 | | competitor_info | 竞品信息，格式：平台名称：模块名称 | 必填 | | --stage2 | 直接执行第二阶段（跳过询问） | false（默认不执行） | | --check-links | 检查竞品链接可用性 | false | | --refs-file | 外部竞品参考文件路径（JSON 格式） | 使用内置配置 |

⚠️ 关键行为变更（v4 核心修复）

默认行为（不加 --stage2 参数）

执行流程：
1. 执行第一阶段（原型/设计对标）
2. 输出第一阶段报告
3. 在报告末尾显示：

---
📋 **第一阶段校验完成**

是否继续执行第二阶段（文字描述合理性校验）？
- 第二阶段将检查：异常分支遗漏、逻辑断层、不符合行业通用设计的业务逻辑
- 预计消耗 token：约 2000-4000（根据 PRD 长度）

请回复以下任一指令：
- "继续" 或 "是" 或 "yes" → 执行第二阶段
- "不用了" 或 "跳过" 或 "no" → 结束校验
- 或直接添加 `--stage2` 参数重新运行命令

⏳ 等待用户确认中...（不自动继续）

强制第二阶段（添加 --stage2 参数）

执行流程：
1. 执行第一阶段（原型/设计对标）
2. 立即执行第二阶段（文字描述合理性校验）
3. 输出完整报告

---
✅ **两阶段校验全部完成**

📚 竞品参考链接配置

内置配置（competitor_refs.json）

所有链接均为竞品官网首页或文档中心首页，确保长期有效：

| 模块 | 覆盖竞品 | 链接类型 | |------|----------|----------| | 技能商店 | GitHub Marketplace、VS Code Extensions、阿里云百炼、腾讯 SkillHub、腾讯云 AI 市场 | 官方首页/市场首页 | | 设备管理 | 华为 eSight、中兴 NetNumen | 产品首页/解决方案 | | 配置下发 | 华为配置管理、阿里云配置中心 | 产品首页/文档中心 | | 工单管理 | 华为服务管理、阿里云工单系统 | 产品首页/帮助文档 | | 权限管理 | 华为权限管理、阿里云 RAM、腾讯云 CAM | 产品首页/文档中心 | | 批量运维 | 华为运维编排、阿里云运维编排、腾讯云批量计算 | 产品首页/文档中心 |

每个竞品包含的信息

{
  "name": "阿里云百炼平台",
  "url": "https://help.aliyun.com/zh/model-studio",
  "url_type": "官方文档中心",
  "screenshot": "模型广场：网格布局展示 AI 模型卡片...",
  "alt_urls": [
    "https://www.aliyun.com/product/model-studio",
    "https://help.aliyun.com/zh"
  ],
  "search_keywords": "阿里云百炼，阿里云模型工作室，阿里云 AI 市场"
}
  • url: 主链接（官网首页或文档中心）
  • alt_urls: 备选链接（2-3 个，主链接失效时使用）
  • search_keywords: 搜索关键词（链接都失效时用于搜索引擎查找）
  • screenshot: 详细界面截图说明

🔗 链接验证机制

自动验证（--check-links）

使用 --check-links 参数时，脚本会：

  1. 检查主链接：发送 HTTP 请求，检查是否可访问
  2. 验证备选链接：如主链接失效，依次检查备选链接
  3. 显示状态：在报告中标注每个链接的状态
✅ 可访问 (HTTP 200)
❌ HTTP 错误：404 Not Found
⚠️  备选链接可用：https://...

链接状态说明

| 状态图标 | 说明 | |----------|------| | ✅ | 链接可访问（HTTP 200/30x） | | ❌ | 链接失效（HTTP 404/500 等） | | ⚠️ | 使用备选链接 | | 无图标 | 未检查（默认模式） |

📝 输出格式

第一阶段输出（原型/设计对标）

## 第一阶段：原型/设计对标报告

### 对标基础信息
- **竞品平台**：阿里云百炼平台
- **功能模块**：技能商店

### 📚 竞品参考手册与截图说明

| 竞品名称 | 官方文档链接 | 链接状态 | 界面截图说明 |
|----------|--------------|----------|--------------|
| GitHub Marketplace | [查看文档](https://github.com/marketplace) | ✅ 可访问 | 列表页：左侧分类筛选... |
| 阿里云百炼平台 | [查看文档](https://help.aliyun.com/zh/model-studio) | ✅ 可访问 | 模型广场：网格布局... |

> 💡 提示：所有链接均为竞品官网首页或文档中心，确保长期有效。

### 百分制打分汇总
...

### 优势/短板/差异清单
...

---
📋 **第一阶段校验完成**

是否继续执行第二阶段（文字描述合理性校验）？
- 第二阶段将检查：异常分支遗漏、逻辑断层、不符合行业通用设计的业务逻辑
- 预计消耗 token：约 2000-4000（根据 PRD 长度）

请回复以下任一指令：
- "继续" 或 "是" 或 "yes" → 执行第二阶段
- "不用了" 或 "跳过" 或 "no" → 结束校验
- 或直接添加 `--stage2` 参数重新运行命令

⏳ 等待用户确认中...（不自动继续）

第二阶段输出（业务逻辑校验）

## 🔍 第二阶段：业务逻辑校验报告

### 发现的问题

1. 🔴 **权限设计缺失** [高风险]
   - 描述：PRD 未说明功能的权限控制要求
   - 建议：补充 RBAC 权限设计

2. 🟡 **状态流转未定义** [中风险]
   - 描述：未说明技能审核失败后的状态流转
   - 建议：补充状态机定义

---
✅ **两阶段校验全部完成**

🛠️ 自定义竞品参考

创建自定义配置文件

{
  "技能商店": [
    {
      "name": "我的竞品 A",
      "url": "https://competitor-a.com",
      "url_type": "官方首页",
      "screenshot": "竞品 A 的界面说明...",
      "alt_urls": ["https://docs.competitor-a.com"],
      "search_keywords": "竞品 A, Competitor A"
    }
  ]
}

使用自定义配置

python competitor_check_v4.py "PRD 全文" "我的竞品 A：技能商店" --refs-file ./my_refs.json

🔄 执行流程

┌─────────────────────────────────────────────────────────┐
│  第一阶段：原型/设计对标（默认执行）                      │
│  - 加载竞品参考配置（内置或外部文件）                    │
│  - 可选：检查链接可用性（--check-links）                 │
│  - 竞品参考手册与截图说明（带链接状态）                  │
│  - 百分制打分汇总                                        │
│  - 优势/短板/差异清单                                    │
└─────────────────────────────────────────────────────────┘
                          ↓
        ⏳ 等待用户确认（不自动继续！）
                          ↓
          用户回复"继续" 或 添加 --stage2 参数
                          ↓
┌─────────────────────────────────────────────────────────┐
│  第二阶段：业务逻辑校验（可选）                          │
│  - 异常处理遗漏检查                                      │
│  - 逻辑断层检查                                          │
│  - 权限设计检查                                          │
│  - 状态流转检查                                          │
└─────────────────────────────────────────────────────────┘

📊 Token 消耗对比

| 场景 | v3 行为 | v4 行为 | Token 节省 | |------|---------|---------|------------| | 仅需要原型对标 | 执行两阶段（~5000 token） | 仅执行第一阶段（~2000 token） | 60% | | 需要完整校验 | 执行两阶段（~5000 token） | 执行两阶段（~5000 token） | 0% | | 多次迭代调整 PRD | 每次都完整执行（~5000×N） | 仅第一阶段（~2000×N），最终再执行第二阶段 | 60% |

⚠️ 注意事项

  1. 链接选择原则：

    • 优先使用官网首页（如 https://github.com/marketplace）
    • 其次使用文档中心首页（如 https://help.aliyun.com/zh）
    • 避免使用深层文档链接（容易失效）

  2. 链接验证限制：

    • 验证超时时间：5 秒
    • 忽略 SSL 证书验证（避免证书过期导致误判）
    • 部分网站可能屏蔽自动化访问

  3. 备选链接作用：

    • 主链接失效时自动尝试备选链接
    • 备选链接数量为 2-3 个
    • 按顺序尝试，找到第一个可用链接即停止

  4. 第二阶段触发：

    • 默认不执行，必须用户明确确认
    • 确认方式：回复"继续/是/yes"或添加 --stage2 参数
    • 避免 token 过度消耗

📈 版本历史

v4.0 (2026-07-13) 🔥 核心修复

  • ✅ 修复：第二阶段必须经用户明确确认后才执行
  • ✅ 修复：默认仅执行第一阶段，避免 token 过度消耗
  • ✅ 新增 token 消耗对比说明
  • ✅ 优化等待确认交互提示

v3.0 (2026-07-09)

  • 新增外部竞品参考配置文件（JSON 格式）
  • 新增链接验证机制（--check-links 参数）
  • 所有链接改为官网首页/文档中心，确保长期有效
  • 每个竞品提供 2-3 个备选链接 + 搜索关键词
  • 链接状态实时显示（✅/❌/⚠️）

v2.0 (2026-07-09)

  • 新增竞品参考链接和截图说明
  • 新增两阶段执行逻辑

v1.0 (2026-07-09)

  • 初始版本发布

📞 问题反馈

如发现竞品链接失效或需要添加新竞品，请：

  1. 更新 competitor_refs.json 文件
  2. 使用 --check-links 验证新链接
  3. 提交更新到代码库