@optima-chat/optima-agent 0.5.11 → 0.6.0

package/.claude/skills/scout/SKILL.md

@@ -33,7 +33,6 @@ Use this skill when:
 
 **Exception - Direct report mode:**
 - User explicitly requests: "给我一份XX市场分析报告"
-- User wants fast results without discussion
 - In this case, skip conversation and generate report directly
 
 ## Quick Start - First Step
@@ -80,11 +79,11 @@ scout search "QUERY" --limit NUMBER
 - Product list with ASIN, title, price, rating, reviews, recent sales
 - Market overview data for competitive analysis
 
-**When to use:**
-- Initial market research
-- Finding product categories or niches
-- Comparing multiple products
-- Identifying market trends
+**Key metrics to analyze:**
+- Price range and distribution
+- Recent sales ("10K+ bought in past month" = high demand)
+- Ratings_total (review count indicates market maturity)
+- Average rating (competitive quality baseline)
 
 ### 2. Get Product Details: `scout product`
 
@@ -104,19 +103,18 @@ scout product ASIN
 - Rating breakdown, BSR, listing quality indicators
 - Feature bullets, images, description, categories
 
-**When to use:**
-- Deep-dive competitor analysis
-- Following up on search results
-- Evaluating specific products
-- Analyzing listing quality
-
 **Key data to extract:**
-- BSR (Best Seller Rank) - Indicates sales volume and market position
-- Rating breakdown - Five-star/one-star percentages reveal satisfaction level
-- Top reviews - Extract user pain points and satisfaction drivers
-- Feature bullets - Identify competitive selling points
-- Images count - Assess listing quality (7 images is standard)
-- Specifications - May include BSR in multiple categories
+- **BSR (Best Seller Rank)** - Sales volume indicator (lower = better)
+  - BSR < 1,000 = very high sales
+  - BSR 1,000-10,000 = good sales
+  - BSR > 50,000 = low sales
+- **Rating breakdown** - Five-star/one-star percentages
+  - 70%+ five-star = excellent satisfaction
+  - 10%+ one-star = quality issues
+- **Top reviews** - User pain points and satisfaction drivers
+- **Feature bullets** - Competitive selling points
+- **Images count** - 7 is standard, fewer = poor optimization
+- **Specifications** - May include BSR in multiple categories
 
 ### 3. Search 1688 Suppliers: `scout supplier-search`
 
@@ -138,23 +136,18 @@ scout supplier-search "KEYWORD" --limit NUMBER --format FORMAT
 - Supplier details: name, location, years in business, seller type (manufacturer vs. trader)
 - Tags: shipping policies (退货包运费), payment terms (先采后付), certifications (实力商家)
 
-**When to use:**
-- After Amazon market research - find potential suppliers for cost analysis
-- User asks about costs, margins, or sourcing
-- Calculating profit margins (Amazon price - 1688 wholesale cost)
-- Identifying manufacturing vs. trading suppliers
-- Before generating final report - include supplier data for complete analysis
-
-**Example:**
-```bash
-scout supplier-search "咖啡机" --limit 10
-```
+**Key analysis:**
+- MOQ constraints (minimum order quantity)
+- Price tiers for bulk ordering
+- Supplier type: 生产加工 (manufacturer) vs. 经销批发 (trader)
+- Years in business (8+ years = established)
+- Return rate (lower = better, typical: 30-50%)
 
 ## Research Workflow
 
 ### Interactive Research Flow (Recommended):
 
-**Phase 1: Initial Discovery & Discussion (5-10 minutes)**
+**Phase 1: Initial Discovery & Discussion**
 1. **Quick Market Scan** → Run 1-2 searches with key terms
 2. **Share Initial Findings** → Present key metrics (price range, competition level, demand signals)
 3. **Discuss with User** → Ask clarifying questions:
@@ -162,13 +155,10 @@ scout supplier-search "咖啡机" --limit 10
    - "看起来高端保温款竞争少，要不要深入看看这个方向？"
    - "你更关注哪些产品？我可以详细分析"
 
-**Phase 2: Deep Dive & Refinement (10-15 minutes)**
+**Phase 2: Deep Dive & Refinement**
 4. **Targeted Analysis** → Based on user feedback, run `scout product` on relevant ASINs
 5. **Extract Insights** → Share key findings (BSR, reviews, pain points)
-6. **Iterate & Explore** → User may request:
-   - Different keywords
-   - Specific competitor analysis
-   - Alternative product categories
+6. **Iterate & Explore** → User may request different keywords, specific competitor analysis, or alternative product categories
 
 **Phase 2.5: Supplier Sourcing (Optional but Recommended)**
 7. **Trigger**: User shows interest in profit margins, costs, or sourcing:
@@ -187,23 +177,24 @@ scout supplier-search "咖啡机" --limit 10
 10. **Ask**: "要不要我详细分析几个供应商？" or proceed to report
 
 **Phase 3: Report Generation (Proactive Suggestion)**
-7. **Gauge Completion** → After sufficient data gathering, **proactively suggest**:
+11. **Gauge Completion** → After sufficient data gathering, **proactively suggest**:
    - "我已经收集了足够的数据，要不要我整理成一份完整的市场分析报告？"
    - "我可以生成一份详细报告，包括市场规模、竞品分析、进入策略和财务预测"
-8. **Generate Report** → Create comprehensive markdown report with all findings
-9. **Save & Iterate** → Offer to save report and refine based on feedback
+12. **Generate Report** → Create comprehensive markdown report with all findings
+13. **Save & Iterate** → Offer to save report and refine based on feedback
 
 ---
 
-**Alternative: Quick Research Flow**
+### Alternative: Quick Research Flow
 
 When user explicitly requests a report upfront ("给我一份XX市场分析报告"):
 1. Run 3-4 diverse keyword searches
 2. Analyze top 3-5 products with `scout product`
-3. Generate comprehensive report directly
-4. Offer follow-up discussion after report delivery
+3. Search 1688 suppliers for cost analysis
+4. Generate comprehensive report directly
+5. Offer follow-up discussion after report delivery
 
-### Multi-Keyword Research Strategy:
+### Multi-Keyword Research Strategy
 
 **Example: Researching titanium cups**
 ```bash
@@ -219,38 +210,8 @@ scout search "camping titanium" --limit 10
 - Cross-validate market size across searches
 - Discover related products and categories
 
-### Analysis Framework:
-
-When analyzing results, consider:
-
-**Market Viability:**
-- Are there existing products? How many competitors?
-- Price range and average price point
-- Market saturation (high ratings_total = established market)
-- **BSR (Best Seller Rank)** - Key market size indicator
+## Complete Example: Interactive Research Session
 
-**Demand Indicators:**
-- "10K+ bought in past month" = high demand
-- High ratings_total = proven demand
-- Recent sales trends
-- **BSR rank** - Lower BSR = higher sales volume
-
-**Competitive Landscape:**
-- Top products' ratings and review counts
-- Price positioning opportunities
-- Feature gaps or improvement opportunities
-- **Rating breakdown** - Five-star vs one-star percentage
-- **Listing quality** - Images count, feature bullets, A+ content
-
-**Entry Barriers:**
-- Established brands vs. new sellers
-- Average review count of top products
-- Price competition level
-- **Top reviews analysis** - User pain points and satisfaction drivers
-
-## Examples
-
-### Example 1: Business Opportunity Evaluation (Interactive Flow)
 **User**: "我想开个店卖钛合金杯子，你觉得合适吗"
 
 **Assistant Phase 1 - Initial Scan:**
@@ -307,9 +268,31 @@ scout search "titanium tumbler" --limit 10
 
 **Assistant**: "找到了！titanium tumbler 搜索结果更聚焦保温款，竞品只有 5-6 个，价格 $60-110。
 
+**现在帮你查一下 1688 供应商成本，看看利润空间？**"
+
+**User**: "好的"
+
+**Assistant Phase 2.5 - Supplier Sourcing:**
+```bash
+scout supplier-search "钛合金保温杯" --limit 10
+```
+
+**Assistant**: "找到供应商数据：
+- 批发价区间：¥180-450（约 $25-65）
+- 起订量：多数 50-100 个
+- 头部供应商：8年工厂，¥280 批发价，起订 50 个
+
+**利润空间分析：**
+- Amazon 售价：$70-90
+- 1688 批发价：¥280（约 $40）
+- 运费+关税：约 $15
+- 总成本：约 $55
+- 毛利率：约 25-40%
+
 我现在收集了足够的数据：
 - 4 个关键词搜索
 - 5 个产品深度分析
+- 供应商成本分析
 - 明确的市场空白（保温款）
 
 **要不要我把这些整理成一份完整的市场分析报告？可以包括：**
@@ -331,152 +314,89 @@ scout search "titanium tumbler" --limit 10
 
 报告已保存为 `钛合金杯子市场分析报告.md`，需要补充哪些信息吗？"
 
-### Example 2: Market Research
-**User**: "帮我研究一下无线鼠标市场"
-
-**Assistant**:
-```bash
-scout search "wireless mouse" --limit 20
-scout search "gaming mouse wireless" --limit 10
-```
-
-"我看了一下无线鼠标市场：
-- 价格从 $10 到 $150，主流在 $20-40
-- 明显分为三个细分市场：办公轻便型、游戏型、静音型
-- 游戏鼠标竞争最激烈，但价格也最高
-
-你想专注哪个细分？"
+## Competitor Analysis Checklist
 
-**User**: "办公用的静音鼠标"
+When user asks to analyze a specific product (e.g., "帮我分析一下这个产品 B0788F3R8X"), follow this analysis framework:
 
-**Assistant**:
-```bash
-scout search "silent mouse wireless" --limit 15
-scout product [TOP_3_SILENT_MOUSE_ASINS]
-```
-
-"找到了！静音鼠标竞争比游戏鼠标少很多，价格 $15-35。要深入分析吗？"
-
-### Example 3: Quick Product Validation
-**User**: "咖啡机现在好卖吗？"
-
-**Assistant**:
-```bash
-scout search "coffee maker" --limit 15
-```
-
-"咖啡机市场很活跃！
-- 头部产品都是 '10K+ bought in past month'，需求很强
-- 价格 $30-150，主要集中在 $40-80
-- 但竞争也很激烈 - 前 10 名评论数都在 10,000+ 以上
-
-这是成熟市场，有需求但进入难度大。你是想自己做品牌，还是代理现有品牌？"
-
-### Example 4: Competitor Deep-Dive
-**User**: "帮我分析一下这个产品 B0788F3R8X"
-
-**Actions:**
 ```bash
 scout product B0788F3R8X
 ```
 
 **Analysis Checklist:**
-- ✅ **BSR & Market Position**: Check BSR in specifications, estimate sales volume
-- ✅ **Customer Satisfaction**:
+- ✅ **BSR & Market Position**
+  - Check BSR in specifications
+  - Estimate sales volume from BSR
+  - Compare with category averages
+- ✅ **Customer Satisfaction**
   - Rating breakdown (five-star %, one-star %)
   - Total reviews count (market maturity indicator)
-- ✅ **Listing Quality**:
+  - Review trends over time
+- ✅ **Listing Quality**
   - Images count (7 is standard)
   - Feature bullets count and quality
   - Product description completeness
-- ✅ **User Feedback Deep-Dive**:
+  - A+ content presence
+- ✅ **User Feedback Deep-Dive**
   - Top 3 positive mentions (from top_reviews)
   - Top 3 complaints/pain points (from top_reviews)
   - Improvement opportunities
-- ✅ **Competitive Advantages**:
+  - Common feature requests
+- ✅ **Competitive Advantages**
   - Unique selling points in feature_bullets
-  - Price positioning
-  - Brand strength
+  - Price positioning vs. competitors
+  - Brand strength and trust signals
+  - Differentiation factors
 
-### Example 5: Complete Market Research + Supplier Sourcing
-**User**: "我想卖咖啡机，帮我做市场调研"
+## Analysis Framework
 
-**Phase 1 - Amazon Market Research:**
-```bash
-scout search "coffee maker" --limit 15
-scout product B08BHXG144  # Top seller analysis
-```
+### Market Viability Assessment
 
-**Assistant**: "咖啡机市场很活跃：
-- 价格区间：$30-150，主流在 $60-80
-- 头部产品月销 1000+ 件，需求强劲
-- 竞争激烈但市场容量大
+| 指标 | 优秀市场 | 正常市场 | 风险市场 |
+|------|---------|---------|---------|
+| 竞品数量 | 10-50 | 5-10 或 50-100 | <5 或 >100 |
+| 头部产品评论数 | 100-1000 | 50-100 或 1000-5000 | <50 或 >5000 |
+| 价格区间 | 宽（有差异化空间） | 中等 | 窄（价格战） |
+| BSR 范围 | 1K-10K | 10K-50K | >50K |
 
-**现在帮你查一下 1688 供应商成本，看看利润空间**"
+**决策逻辑**：
+- **优秀市场** = 有需求、有空间、竞争适中
+- **正常市场** = 需要差异化或资源投入
+- **风险市场** = 需求不明或红海竞争
 
-**Phase 2 - Supplier Sourcing:**
-```bash
-scout supplier-search "咖啡机" --limit 10
-```
+### Demand Indicators
 
-**Assistant**: "找到供应商数据：
-- 批发价区间：¥120-580（约 $17-80）
-- 起订量：多数 2-10 台
-- 头部供应商：容凯严选工厂，¥429-599，起订 2 台
+**High Demand Signals:**
+- ✅ "10K+ bought in past month" 标签
+- ✅ 多个产品 ratings_total > 500
+- ✅ BSR < 10,000 in category
+- ✅ 搜索结果超过 30 个相关产品
 
-**利润空间分析：**
-- Amazon 售价：$60-80
-- 1688 批发价：¥429（约 $60）
-- 运费+关税：约 $10-15
-- 毛利率：约 15-25%（扣除平台费用后）
+**Low Demand Signals:**
+- ⚠️ 少于 10 个搜索结果
+- ⚠️ 头部产品 ratings_total < 50
+- ⚠️ BSR > 100,000
+- ⚠️ 没有 "bought in past month" 标签
 
-市场有需求，成本可控，利润空间合理。要详细分析吗？"
+### Competitive Landscape
 
-**User**: "好的，生成报告吧"
-
-**Phase 3 - Generate Report with Supplier Data:**
-[Creates comprehensive report including both Amazon market analysis AND 1688 supplier costs]
-
-## Output Format
-
-Commands return structured JSON with product data and metadata. Key fields:
-- **Search**: `results[]` (asin, title, price, rating, ratings_total, recent_sales) + `metadata`
-- **Product**: `data.product` (full details, rating_breakdown, BSR in specifications) + `metadata`
+**进入难度评估：**
 
-## Best Practices
+| 维度 | 容易进入 | 中等难度 | 困难进入 |
+|------|---------|---------|---------|
+| 头部产品评论数 | <200 | 200-2000 | >2000 |
+| 品牌集中度 | 无知名品牌 | 少数品牌 | 大品牌垄断 |
+| 价格竞争 | 差异化定价 | 价格区间宽 | 价格战 |
+| 评分分布 | <4.5 平均分 | 4.5-4.7 | >4.7（难超越） |
 
-### 1. Conversational First, Report Later
-**Principle:** Build understanding through dialogue, then document in report.
+### Report Generation Guidelines
 
-**Why this matters:**
-- Users often don't know exactly what they want initially
-- Early conversation reveals true goals and constraints
-- Interactive exploration uncovers better insights than solo research
-- Report becomes more valuable when it answers user's actual questions
-
-**In practice:**
-- Start with 1-2 quick searches, share highlights (not full data dump)
-- Listen for what user cares about: price sensitivity, time to market, differentiation
-- Adjust research direction based on reactions
-- Think of yourself as a consultant, not a data processor
-
-### 2. Recognize When to Suggest Report
-**Strong signals - Proactively suggest report:**
+**When to suggest report:**
 - ✅ 3+ searches completed with diverse keywords
 - ✅ 3-5 products analyzed in detail (with BSR, reviews, etc.)
-- ✅ User asks synthesizing questions:
-  - "所以你觉得呢？" "值得做吗？" "你的建议是什么？"
-  - "总结一下" "整体怎么样" "帮我分析分析"
-- ✅ Conversation covers core dimensions: market size, competition, pricing, differentiation
+- ✅ User asks synthesizing questions: "所以你觉得呢？" "值得做吗？" "总结一下"
 - ✅ Clear opportunity or risk identified that should be documented
-- ✅ Research session lasted 10-15 minutes (multiple rounds of Q&A)
 
-**Weak signals - Continue exploring:**
-- User still asking specific questions about individual products
-- Only 1-2 searches done, limited data
-- User exploring different categories (still deciding direction)
-
-**How to suggest (Natural & Consultative):**
+**How to suggest report (use this natural template):**
 ```
 "我已经分析了 X 个搜索和 Y 个竞品，发现了一些有意思的模式。
 
@@ -499,97 +419,75 @@ Commands return structured JSON with product data and metadata. Key fields:
 - Continue exploration or answer follow-up questions
 - Offer report again later if more data gathered
 
-### 3. Report Structure & Quality
-**When generating report, include:**
-- **Executive Summary** - 核心结论前置
+**Report must include:**
+- **Executive Summary** - 核心结论前置（适合进入？风险是什么？）
 - **Market Analysis** - 基于搜索数据的市场概况
-- **Competitor Deep-Dive** - 基于 product details 的竞品分析
-  - Must include: BSR, rating breakdown, top reviews insights
+- **Competitor Deep-Dive** - 基于 product details 的竞品分析（BSR, rating breakdown, top reviews insights）
 - **Opportunity Assessment** - SWOT 或机会/挑战分析
 - **Entry Strategy** - 产品定位、定价、差异化策略
 - **Financial Projections** (optional) - 如果用户需要投资决策
-- **Data Appendix** - 关键数据汇总表
+- **Supplier Analysis** (if Phase 2.5 completed) - 1688 供应商、成本、利润空间
 
 **Report naming:**
 - Save as: `{产品类型}市场分析报告.md`
 - Example: `钛合金杯子市场分析报告.md`
 
-### 4. Look for Patterns
-- Common price points across competitors
-- Feature trends in top products
-- Customer pain points in reviews (from top_reviews)
-- Rating breakdown patterns (high five-star vs one-star issues)
-
-### 5. Assess Opportunity
-- High demand (BSR, sales data) + Low competition (ratings count) = Good opportunity
-- High demand + High competition = Difficult but proven market
-- Low demand = Risky
-
-### 6. Present Insights
-- Use user's language (Chinese if they asked in Chinese)
-- Include specific examples and data evidence
-- Provide actionable recommendations
-- Explain reasoning with data
-
-### 7. Iterate & Refine
-- After presenting report, ask: "需要补充哪些信息？"
-- Offer follow-up analysis: "要不要看看相关品类？"
-- Point out data limitations honestly
-
-### 8. Amazon + 1688 Integrated Analysis
-**Principle:** Complete market research includes both demand analysis (Amazon) and supply chain research (1688).
-
-**When to search 1688:**
-- ✅ After identifying promising products on Amazon
-- ✅ User asks about costs, margins, or sourcing
-- ✅ Before generating final report (include supplier data for complete picture)
-- ✅ User explicitly asks about suppliers or wholesale prices
-
-**How to present:**
-- Compare Amazon prices vs. 1688 wholesale costs
-- Calculate rough profit margins (consider shipping, tariffs, platform fees)
-- Highlight MOQ constraints (minimum order quantity)
-- Identify manufacturing vs. trading suppliers (生产加工 vs. 贸易商)
-
-**Example flow:**
-1. Search Amazon → Identify $60-80 price point for coffee makers
-2. Search 1688 → Find ¥429 ($60) wholesale price, MOQ 2 units
-3. Calculate margin → ~20% after fees and shipping
-4. Recommendation → Feasible opportunity with reasonable margins
-
-**Proactive suggestion:**
-After sufficient Amazon research, proactively offer:
-"我已经分析了 Amazon 市场，要不要我帮你查一下 1688 供应商成本，看看利润空间？"
-
-## Tips
-
-**Sales & Demand:**
-- "10K+ bought in past month" = high demand indicator
-- **BSR (Best Seller Rank)**: Lower number = higher sales
-  - BSR < 1,000 in category = very high sales
-  - BSR 1,000-10,000 = good sales
-  - BSR > 50,000 = low sales
-- Compare ratings_total across competitors to gauge market maturity
+## Key Metrics Quick Reference
 
-**Market Entry Assessment:**
-- Lower ratings_total on top results = easier market entry
-- High sales (BSR) + Low reviews = newer market opportunity
-- High sales + High reviews = established but proven market
+**BSR (Best Seller Rank):**
+- < 1,000 = 月销 500+ 件
+- 1,000-10,000 = 月销 100-500 件
+- 10,000-50,000 = 月销 20-100 件
+- > 50,000 = 月销 <20 件
 
-**Customer Satisfaction:**
-- Check rating_breakdown percentages:
-  - 70%+ five-star = excellent satisfaction
-  - 10%+ one-star = quality issues or high expectations
-- Recent reviews often reveal current product issues or trends
-- Top reviews expose pain points and satisfaction drivers
+**Rating Breakdown:**
+- 70%+ five-star = 优秀产品质量
+- 60-70% five-star = 正常水平
+- <60% five-star = 质量问题或期望不符
+- 10%+ one-star = 严重质量问题
+
+**Market Maturity:**
+- ratings_total >1000 = 成熟市场
+- ratings_total 100-1000 = 发展中市场
+- ratings_total <100 = 新兴市场或小众
 
 **Listing Quality:**
-- 7 images is Amazon standard - fewer suggests poor optimization
-- 5+ feature bullets with clear benefits
-- A+ content presence indicates professional seller
-
-**Research Strategy:**
-- Use multiple search queries to get complete market view
-- Search related keywords (e.g., "titanium cup" + "titanium mug" + "titanium tumbler")
-- Cross-validate findings across different searches
-- Analyze top 3-5 products in each search for patterns
+- 7 images = 标准
+- 5+ feature bullets = 完整
+- A+ content = 专业卖家
+
+## Cross-Skill Integration
+
+**TikTok/Instagram → Scout → Supplier 完整链路：**
+
+1. **TikTok/Instagram** - 发现趋势产品
+   ```bash
+   scout tiktok trending --has-product
+   # 或
+   scout instagram reels "产品关键词"
+   ```
+
+2. **Scout (Amazon)** - 验证市场需求
+   ```bash
+   scout search "product name" --limit 15
+   scout product <top_asin>
+   ```
+
+3. **Scout (1688)** - 找供应商和成本
+   ```bash
+   scout supplier-search "产品关键词" --limit 10
+   ```
+
+4. **决策** - 综合分析：
+   - TikTok/Instagram 验证内容热度
+   - Amazon 验证购买需求和竞争
+   - 1688 验证供应链和利润空间
+   - 三者都通过 → 值得做
+
+**Proactive suggestion after cross-skill analysis:**
+"我已经分析了：
+- TikTok 内容热度（X 个热门视频）
+- Amazon 市场需求（价格 $Y, BSR Z）
+- 1688 供应商成本（批发价 ¥W，起订 Q 个）
+
+要不要生成一份完整的产品机会分析报告？"