agentleFS
Ethan-paseyaEthan-paseya/amazon-sellersprite-research-MCP-skill/.claude/skills/product-planning/SKILL.md

product-planning

Skill2 starsChanged 4 months agoMITView on GitHub

基于三款种子竞品和 SellerSprite MCP 证据生成 Amazon 产品立项企划。适用于 `/product-planning "{ASIN1;ASIN2;ASIN3}" {SITE}`、产品立项企划、企划表、会议版 Excel、竞品与市场证据整合;默认输出 Markdown 主报告和 Product-Planning V1 七 Sheet Excel。

2 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. peter-tu-zynkr/zynkr-skill-builder★ 21same name
    2. ack-solutions/claude-code-ai-skills★ 1same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository6 other files it gives its agents.

The file

Files
SKILL.md

Product Planning

命令

/product-planning "{ASIN1;ASIN2;ASIN3}" {SITE}

命令必须包含恰好三个以分号分隔的唯一 ASIN。不要在后续流程中重复向用户索要同一组 ASIN。GB 在 SellerSprite MCP 调用前归一为 UK。

Credential Preflight 与必读资料

执行前按顺序读取:

  1. references/runtime-credential-preflight.md
  2. references/integrated-workflow.zh.md
  3. references/sellersprite-mcp-api.md
  4. references/product-planning-mcp-flow.zh.md

若仓库模板可用,使用:

  • templates/product-planning-report.zh.md
  • templates/product-planning-meeting-workbook-layout.zh.md
  • templates/product_planning_standard_template_V1_manifest.json
  • templates/product_planning_standard_template_V1_beautified.xlsx(默认首选)
  • templates/product_planning_standard_template_V1.xlsx(兼容备份)

核心原则

  • SellerSprite MCP 是市场、竞品、关键词和评论数据的首要证据来源。
  • 所有事实必须来自 MCP、Amazon 前端补充证据、已有源报告或用户明确提供的数据/假设。
  • MCP 未返回的字段写 N/A 并登记数据缺口,不得编造、插值或用零值占位。
  • Amazon 前端只补充 MCP 缺失的主图、页面卖点或其他必要字段,并与 MCP 证据分开标注。
  • Markdown 是主报告;Excel 是额外会议版输出,不能替代或删除 Markdown。
  • 成本、MOQ、包装、物流、退款率、广告占比和销量目标不由 MCP 推导。默认不生成成本试算和销售计划。

标准执行流程

1. 输入与凭证预检

解析并校验三个 ASIN 和站点。缺少 SellerSprite MCP API key 时停止真实采集并向用户索要;缺少 Gemini/GLM 凭证只阻止真实双模型验证,不得伪造验证结果。密钥不能进入报告、Excel、日志、示例或开源目录。

2. 校验三款种子

对每个 ASIN 调用 asin_detail,检查存在性、站点、标题相关性、产品形态和类目节点。无效、重复、跨站点或明显无关时要求用户替换,不能进入最终竞品表。

从三款有效种子的共同类目、功能、场景、目标用户和关键词推导产品方向。用户未提供的工程设计、供应链和财务信息不得补写。

3. 补充第四竞品

使用 competitor_lookup、必要时 product_research 建立候选池,再用 asin_detail 校验。保留用户三款竞品,系统只补充一款,用于覆盖头部评价壁垒、低价冲击或高配差异化。没有合格候选时第四款写 N/A 并记录原因。

4. 锁定市场分析类目

从已验证竞品 nodeIdPath 中选择重复出现且与产品形态直接一致的最深叶子节点。没有重复叶子时,才评估覆盖多数种子的最小父节点;父节点购买意图过宽时不得采用。保存候选、覆盖率、相关性、相邻类目、拒绝原因和证据 ID。

5. 锁定查询口径

在市场接口调用前创建 queryManifest,至少记录:

  • marketplace
  • analysisMonth
  • lastCompleteMonth
  • 连续 12 个月 trendMonths
  • topN
  • newProductMonths
  • selectedNodeIdPath

当前未完整月份只作快照。趋势和分布改用其他月份时必须记录原因。

6. 采集 MCP 证据

按以下顺序调用并保存脱敏入参摘要、返回行数、采用状态、缺失字段和 evidenceId:

  1. 市场:market_research_statistics、market_product_demand_trend、价格/评分/评分数/上架时间/上架年份分布、集中度工具。
  2. 关键词:keyword_miner、keyword_research、keyword_research_trends。
  3. 竞品:asin_detail、asin_sales_trend,必要时使用可用的价格、优惠或流量工具。
  4. VOC:review,4-5 星用于已验证卖点,1-3 星用于痛点。
  5. ABA/流量:keyword_order、traffic_keyword_stat、traffic_keyword、traffic_source、可用的 ABA 工具。
  6. 辅助风险:按需使用 google_trend、trademark_*。

market_product_demand_trend 空返回时只按官方文档允许的月份参数重试;不得用 ASIN 聚合替代类目趋势。

7. 生成统一证据对象

把所有采用数据归一到 evidence.json。参考仓库中的 templates/product_planning_evidence.example.json。数值保持原始数值类型,货币、百分比和中文展示由渲染层处理。

每个关键结论、SWOT 条目、决策门禁和行动必须引用 evidenceId。MCP原始数据 与 数据来源 Sheet 也从该对象生成。

8. 运行规则校验

正式渲染前运行:

python scripts/validate_product_planning_evidence.py evidence.json --output evidence_qa.json

仓库运行方式:

python scripts/python/validate_product_planning_evidence.py evidence.json --output evidence_qa.json
  • FAIL:停止生成正式报告,先修复证据或口径。
  • WARN:可继续,但警告必须写入数据缺口和验证摘要。
  • PASS:允许正式渲染。

9. 生成 Markdown 与 Excel

默认 V1 Sheet 顺序固定:

  1. 意向产品
  2. 市场分析
  3. 竞品分析与优化策略
  4. SWOT分析
  5. ABA排名【季度】
  6. MCP原始数据
  7. 数据来源

意向产品 的参考图默认使用第一款种子 ASIN 经核验的 Amazon 前端主图。无法验证时写 N/A,不能替换为无关图片。

Excel 默认从 product_planning_standard_template_V1_beautified.xlsx 渲染。意向产品中功能一至四为已验证卖点,使用灰底红字;功能五至七为评论中可转化的未满足需求,使用亮黄底红字。首选模板缺失或损坏时才回退到旧 V1 模板,并在数据来源中记录回退原因。

市场分析 必须使用已锁定节点的 12 月趋势、关键词、上架时间/年份、评分数、评分值和价格分布;每张图下方给出不超过三条产品经理点评。

竞品分析与优化策略 固定展示三款用户竞品与一款系统补充竞品,包含售价柱状图加评分数折线图、Listing/VOC 优化矩阵。结论不超过三条,落到样品验证、Listing 表达、定价或投放动作。

SWOT分析 只重组前三 Sheet 的证据,不新增事实。ABA排名【季度】 只填接口真实返回;空字段写 N/A。

10. 输出质量与交叉验证

交付前检查:

  • Markdown、Excel 和文件名标题一致;
  • 无 {{...}}、TODO、模板词或零值假占位;
  • 图表引用实际数据区域,空数据不生成误导性图表;
  • .xlsx Office XML 完整,可用桌面 Excel 时确认无修复提示;
  • 静态扫描无 API key、token、MCP 密钥 URL、绝对路径、原始评论或私有数据。

可用时生成脱敏摘要并执行 Gemini + GLM 交叉验证。模型只能评估数据口径、结论一致性、风险完整性和行动可执行性,不能覆盖 MCP 原始事实。模型建议若需要新事实,必须回到 MCP 或前端重新取证。

输出目录

product-planning-reports/{ASIN1}_{ASIN2}_{ASIN3}_{SITE}_{YYYYMMDD}/
├── {REPORT_TITLE}.md
├── {REPORT_TITLE}.xlsx
├── evidence.json
├── evidence_qa.json
├── multi_model_validation.json
└── raw/

raw/ 只用于本地运行,不进入开源目录。用户面向报告默认使用中文。

最终决策

最终状态只允许 进入、观察 或 放弃。每个门禁必须包含阈值、实际证据和 evidenceId。行动按 P0/P1/P2 排序,缺少供应链、成本、专利或合规证据时登记为待验证项,不得给出确定性判断。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.