@optima-chat/optima-agent 0.9.7 → 0.9.9

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

@@ -1,6 +1,6 @@
 ---
 name: scout
-description: "Interactive Amazon product research consultant with 1688 supplier sourcing. Search products, analyze markets, find suppliers (by keyword or image), and generate professional reports. ALWAYS use when user asks about: selling products (卖/开店), product ideas (产品/商品), market research (市场/竞品), suppliers (供应商/厂家), sourcing (采购/进货/货源), image search (图片找货/以图搜货/找同款), evaluating business opportunities (生意/创业). Start with conversational exploration, then suggest comprehensive report generation. Uses 'scout search', 'scout product', 'scout supplier-search', and 'scout supplier-search-image' commands."
+description: "Interactive Amazon product research consultant with 1688 supplier sourcing and Keepa historical data. Search products, analyze markets, find suppliers (by keyword or image), track price/BSR history, and generate professional reports. ALWAYS use when user asks about: selling products (卖/开店), product ideas (产品/商品), market research (市场/竞品), suppliers (供应商/厂家), sourcing (采购/进货/货源), image search (图片找货/以图搜货/找同款), evaluating business opportunities (生意/创业), product trends (趋势/走势), price history (价格历史/价格变化), BSR ranking (排名/销量排名), product lifecycle (生命周期/增长期/衰退期). Uses 'scout search', 'scout product', 'scout keepa *', 'scout supplier-search', and 'scout supplier-search-image' commands."
 ---
 
 # Optima Scout - AI Product Research
@@ -193,6 +193,95 @@ scout supplier-search-image "IMAGE_URL" --limit NUMBER
 - If image is inaccessible (404, expired, auth-required), will return helpful error message
 - **Best practice**: Try both image and keyword search for comprehensive results
 
+### 历史数据（Keepa API）
+
+#### `scout keepa product` — 产品历史数据（核心命令）
+
+```bash
+scout keepa product B09V3KXJPB                    # 默认 90 天统计
+scout keepa product B09V3KXJPB --stats 180         # 180 天统计
+scout keepa product B09V3KXJPB --buybox --rating   # 含 BuyBox 和评分历史
+scout keepa product B09V3KXJPB,B0D4J2QLCR          # 批量查询（逗号分隔，最多100）
+scout keepa product B09V3KXJPB --domain amazon.de  # 指定站点
+```
+
+返回（关键字段）：
+- **stats.current[3]** — 当前 BSR
+- **stats.salesRankDrops30/90** — 30/90 天 BSR 下降次数 ≈ 出单次数
+- **stats.outOfStockPercentage30** — 30 天断货率
+- **csv[0]** — Amazon 自营价格历史
+- **csv[1]** — 第三方新品价格历史
+- **csv[3]** — BSR 排名历史
+- **csv[11]** — 在售卖家数量历史（COUNT_NEW）
+- **csv[16]** — 评分历史
+- **csv[17]** — 评论数历史
+
+价格单位：美分（÷100 得美元）。评分：×10（45 = 4.5 星）。
+
+**When to use:** 在 `scout product` 获取实时数据后，用 `scout keepa product` 拉历史数据判断趋势和生命周期。
+
+#### `scout keepa search` — Product Finder（按条件筛选全库）
+
+```bash
+# 找 BSR < 1万、评论 < 500、价格 $20-50 的新机会
+# 注意：currentRange 单位是美分，$20-50 = [2000,5000]
+scout keepa search '{"salesRankRange":[1,10000],"avg90_COUNT_REVIEWS_lte":500,"currentRange":[2000,5000]}'
+
+# 找特定品牌
+scout keepa search '{"brand":"Apple","salesRankRange":[1,50000]}' --per-page 10
+```
+
+返回：符合条件的 ASIN 列表。selection 支持几百个筛选条件。
+
+#### `scout keepa bestsellers` — 品类热卖榜
+
+```bash
+scout keepa bestsellers 172282                # Electronics 品类
+scout keepa bestsellers 172282 --range 90     # 90 天平均排名
+```
+
+返回：品类 top ASIN 列表（根类目最多 10 万个）。先用 `scout keepa category 0` 获取品类 ID。
+
+#### `scout keepa category` — 品类树
+
+```bash
+scout keepa category 0                        # 所有根类目（拿品类 ID）
+scout keepa category 172282                   # Electronics 子类目
+```
+
+#### `scout keepa seller` — 卖家画像
+
+```bash
+scout keepa seller ATVPDKIKX0DER              # Amazon.com 自己
+scout keepa seller A2R2RITDJNW1Q6 --storefront # 含店铺全部 ASIN
+```
+
+返回：卖家名称、评分、店铺 ASIN 总数。
+
+#### `scout keepa deals` — 降价商品监控
+
+```bash
+scout keepa deals                             # 默认 BuyBox 降价
+scout keepa deals --category 172282           # Electronics 品类降价
+scout keepa deals --title "wireless earbuds"  # 按标题搜索
+```
+
+返回：最近降价的商品列表（ASIN、标题、当前价、降幅）。
+
+#### `scout keepa graph` — 价格走势图
+
+```bash
+scout keepa graph B09V3KXJPB -o price-chart.png
+```
+
+返回：Keepa 价格走势 PNG 图片。
+
+#### `scout keepa tokens` — API 余额
+
+```bash
+scout keepa tokens
+```
+
 ## Research Workflow
 
 ### Interactive Research Flow (Recommended):
@@ -204,32 +293,37 @@ scout supplier-search-image "IMAGE_URL" --limit NUMBER
 
 **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, or alternative product categories
+5. **Historical Trend Analysis** → Run `scout keepa product ASIN1,ASIN2,ASIN3 --stats 180` to get historical data
+6. **Extract Insights** → Combine realtime + historical data:
+   - BSR trend → 增长期/成熟期/衰退期？
+   - `salesRankDrops30/90` → 估算月销量
+   - 价格历史 → 利润空间稳定吗？有价格战吗？
+   - 卖家数量变化 → 竞争在加剧吗？
+7. **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 costs/sourcing, or after market validation
+8. **Trigger**: User shows interest in costs/sourcing, or after market validation
    - "成本大概多少？" "批发价怎么样？" "利润空间大吗？"
    - "哪里进货？" "供应商怎么找？"
    - "这个图片能找到货源吗？" "Amazon这个能在1688找到吗？"
 
-8. **Choose search method**:
+9. **Choose search method**:
    - **With image**: `scout supplier-search-image "https://..."` ← More accurate for visual products
    - **With keyword**: `scout supplier-search "产品关键词"`
    - **Best practice**: Try both and compare results
 
-9. **Share Findings**:
-   - Wholesale price range (e.g., ¥429-599)
-   - MOQ (minimum order quantity)
-   - Profit margin calculation: Amazon price ($60-80) - 1688 cost (¥429 ≈ $60) - shipping ($10-15)
-   - Supplier quality indicators (years in business, certifications)
+10. **Share Findings**:
+    - Wholesale price range (e.g., ¥429-599)
+    - MOQ (minimum order quantity)
+    - Profit margin calculation: Amazon price ($60-80) - 1688 cost (¥429 ≈ $60) - shipping ($10-15)
+    - Supplier quality indicators (years in business, certifications)
 
-10. **Ask**: "要不要我详细分析几个供应商？" or proceed to report
+11. **Ask**: "要不要我详细分析几个供应商？" or proceed to report
 
 **Phase 3: Report Generation (Proactive Suggestion)**
-11. **Gauge Completion** → After sufficient data, suggest: "要不要我整理成一份完整的市场分析报告？"
-12. **Generate Report** → Create comprehensive markdown report with all findings
-13. **Save & Iterate** → Offer to save report and refine based on feedback
+12. **Gauge Completion** → After sufficient data, suggest: "要不要我整理成一份完整的市场分析报告？"
+13. **Generate Report** → Create comprehensive markdown report with all findings
+14. **Save & Iterate** → Offer to save report and refine based on feedback
 
 ---
 
@@ -238,8 +332,9 @@ scout supplier-search-image "IMAGE_URL" --limit NUMBER
 When user explicitly requests a report upfront:
 1. Run 3-4 diverse keyword searches
 2. Analyze top 3-5 products with `scout product`
-3. Search 1688 suppliers (image + keyword)
-4. Generate comprehensive report directly
+3. Pull historical trends with `scout keepa product` (batch ASINs)
+4. Search 1688 suppliers (image + keyword)
+5. Generate comprehensive report directly
 
 ### Multi-Keyword Research Strategy
 
@@ -268,12 +363,14 @@ scout search "titanium tumbler" --limit 10
 3. User: "中高端的，质量好的"
 4. Run `scout product` on 3 representative ASINs (B0CTKWJDXX, B0DNCMN3NX, B083NLR6BF)
 5. Share: "TOAKS中端爆款BSR#530，月销250件，87%五星。用户最爱：超轻、品质好、无金属味。主要抱怨：散热快（无保温）。KOYASU高端保温$89.99，评论少但4.8分。保温款市场几乎空白！"
-6. User: "好的，你看看"
-7. Run `scout search "titanium tumbler"`
-8. Share: "titanium tumbler竞品只5-6个，$60-110。现在查供应商成本？"
-9. Run `scout supplier-search "钛合金保温杯"`
-10. Share: "批发价区间：¥180-450（约$25-65），起订量多数50-100个。头部供应商：8年工厂，¥280批发价。**利润分析**：Amazon售价$70-90，1688成本¥280（约$40），运费+关税约$15，总成本约$55，**毛利率25-40%**。"
-11. Suggest report generation
+6. Run `scout keepa product B0CTKWJDXX,B0DNCMN3NX,B083NLR6BF --stats 180` 拉历史数据
+7. Share: "Keepa 历史数据显示：TOAKS 的 BSR 过去 6 个月持续走低（从#2000 降到#530），说明市场在增长。卖家数量从 3 个增到 8 个，竞争在加剧。价格近 6 个月稳定在 $25-28，没有价格战。保温款 KOYASU 的 BSR 波动大但整体下降趋势，说明刚起步有潜力。"
+8. User: "好的，你看看"
+9. Run `scout search "titanium tumbler"`
+10. Share: "titanium tumbler竞品只5-6个，$60-110。现在查供应商成本？"
+11. Run `scout supplier-search "钛合金保温杯"`
+12. Share: "批发价区间：¥180-450（约$25-65），起订量多数50-100个。头部供应商：8年工厂，¥280批发价。**利润分析**：Amazon售价$70-90，1688成本¥280（约$40），运费+关税约$15，总成本约$55，**毛利率25-40%**。"
+13. Suggest report generation
 
 ### Example 2: Image-Based Supplier Search
 
@@ -345,6 +442,21 @@ scout product B0788F3R8X
 | BSR范围 | 1K-10K | 10K-50K | >50K |
 | 进入难度 | 适中 | 需差异化 | 很难或需求不明 |
 
+### 选品五要素（Keepa 历史数据驱动）
+
+| 要素 | 数据来源 | 怎么判断 |
+|------|---------|---------|
+| **市场体量** | `salesRankDrops30/90` + BSR | drops 多 = 出单多 |
+| **垄断程度** | `csv[11]` 卖家数量 + BuyBox | 卖家少且稳定 = 垄断 |
+| **历史趋势** | `csv[3]` BSR 曲线 | 持续走低 = 增长期 |
+| **所处阶段** | BSR 曲线形态 + 评论增速 | 增长/成熟/衰退 |
+| **新品方向** | Product Finder 筛选低竞争品 | 评论少 + BSR 好 = 机会 |
+
+**产品生命周期判断：**
+- **增长期**：BSR 持续走低，评论数快速增长，卖家数量开始增加
+- **成熟期**：BSR 平稳波动，评论数增速放缓，卖家数量稳定
+- **衰退期**：BSR 持续走高，新评论减少，卖家数量下降或价格战
+
 ### Key Metrics
 
 **BSR (Best Seller Rank):**
@@ -412,8 +524,9 @@ Low Demand:
 **Report must include:**
 - Executive Summary（核心结论前置：适合进入？风险是什么？）
 - Market Analysis（基于搜索数据的市场概况）
+- Historical Trend Analysis（基于 Keepa 数据的趋势分析：BSR 走势、价格稳定性、卖家数量变化、生命周期阶段判断）
 - Competitor Deep-Dive（基于product details的竞品分析：BSR, rating breakdown, top reviews insights）
-- Opportunity Assessment（SWOT 或机会/挑战分析）
+- Opportunity Assessment（SWOT 或机会/挑战分析，结合五要素框架）
 - Entry Strategy（产品定位、定价、差异化策略）
 - Supplier Analysis (if Phase 2.5 completed)（1688供应商、成本、利润空间）
 

package/.claude/skills/video-gen/SKILL.md

@@ -12,7 +12,7 @@ description: "帮商家用 AI 生成产品视频（社媒投放 / 产品详情
 优先级高于任何 pipeline 步骤。违反会导致泄漏、超支或数据丢失。
 
 1. **User-facing 不出现模型名或服务名**
-   status / 成本 / 进度 / 错误 / 总结 统一用"标准模式 / 高保真模式 / 视频生成中"。模型名仅用于 skill 内部路由，**代码注释里的也不能抄给用户**。`--provider piapi` 作为 CLI flag 的字面值可存在，但不要把整条命令回显给用户。
+   status / 成本 / 进度 / 错误 / 总结 统一用"视频生成中"。模型名仅用于 skill 内部路由，**代码注释里的也不能抄给用户**。
 
 2. **花钱前必走 COST-GATE**
    任何 `gen video` / `gen image` 调用之前必走一次成本确认（§执行生成）。**Fast-path、迭代、重试均无例外**。成本按秒估算：`Σ(seg.duration_s) × per_second_rate_usd[mode]`，rate 从所选模板的 `production_cost.per_second_rate_usd` 读取。rate 为 TBD 时成本前缀"~"明示粗估。
@@ -305,7 +305,7 @@ ffmpeg -i assets/reference.mp4 -vf "select='eq(n\,<FRAME_NUM>)'" -vsync 0 assets
 | 1 | 0-1.5s | <内容> | <运镜> | <替换或"原创"> |
 | ... |
 
-> **段时长约束**：推荐 2-10s。<2s 或 >10s 需在展示时警告用户（不阻断）。单段 >15s 必须拆段，不允许进入 Production Plan。段时长精度到 0.5s（3.73s 四舍五入到 3.5s）。
+> **段时长约束**：Storyboard 按叙事节奏自由分段（推荐 2-15s），不受 Sora2 时长限制。Production Plan 阶段会将多个短段合并为 10/15s 的 gen video 调用，再用 ffmpeg trim 切回各段时长。单段 >15s 必须拆段。段时长精度到 0.5s（3.73s 四舍五入到 3.5s）。
 
 ## Hook
 <第 1 秒如何抓注意力>
@@ -329,63 +329,52 @@ ffmpeg -i assets/reference.mp4 -vf "select='eq(n\,<FRAME_NUM>)'" -vsync 0 assets
 
 Storyboard 确认后自动推导。用户通常不改。
 
-### 0. 音频决策（先于策略选择）
+### 0. 选策略
 
-**两种模式都默认有音频**（`gen video --audio` 默认开启），**真正差异在"对口型精度"**：
+所有视频生成统一使用 Sora2（GrsAI），支持文生视频和图生视频。**Sora2 生成静音视频，音频需后期处理**（ffmpeg 叠 BGM / `gen tts` 配旁白）。
 
-- **标准模式**（wan2.6，no `--provider`）：自动配音，对口型精度低。适合无人物讲话 / 不叠原音频的场景
-- **高保真模式**（`--provider piapi`，Kling 3.0）：对口型精度高，适合讲话镜头 / 叠原音频场景
-- **彻底无音频**：任一模式加 `--no-audio`
-
-**复刻 + 原音频叠加**的真实风险：用标准模式生成的视频，嘴型节奏和原音频不匹配（wan2.6 对口型弱）→ 叠原音听起来"嘴型错位"。所以模式选择必须先过这道决策：
-
-| 场景 | 决策 | 模式 | CLI flag |
-|---|---|---|---|
-| 复刻 + 参考带音频，用户想保留原音频 | 强制高保真（标准模式对口型太差，叠原音会明显错位）| 高保真 | `--provider piapi` |
-| 复刻 + 参考带音频，愿意重生音频 | 高保真（默认）| 高保真 | `--provider piapi` |
-| 纯生成，未指定音频需求 | **问**："需要音频吗？（人声 / 旁白 / 音效）" | ↓ | ↓ |
-| &nbsp;&nbsp;→ 需要人声 / 旁白 | 高保真 | 高保真 | `--provider piapi` |
-| &nbsp;&nbsp;→ 只要环境配音，不讲话 | 标准（便宜 ~10×，自动配音够用）| 标准 | *(默认)* |
-| &nbsp;&nbsp;→ 不要音频（后期自配 BGM）| 标准 + 无音频 | 标准 | `--no-audio` |
-| 高度还原 / 严格对口型 / premium | 强制高保真（忽略音频决策）| 高保真 | `--provider piapi` |
-| 用户明确说"便宜版" / "省 credits" | 标准 + 警告"对口型精度低"| 标准 | *(默认)* 或 `--no-audio` |
-
-**Fast-path 集成**：Fast-path 不单独问音频，在 COST-GATE 里追加"含同步音频（对口型精度依模式而定），不需要可说'静音版'"。用户喊"静音版" → 回退标准模式 + `--no-audio`，重走 COST-GATE。
-
-**冲突检测**：复刻场景 + 用户说"便宜版" → 不直接降级，先问：
-
-> 复刻场景用标准模式对口型精度低，叠原音频会听起来错位。确认要降级吗？
+| 特征 | 策略 |
+|---|---|
+| 1 镜头，无参考 | single-shot |
+| 多镜头，无参考 | multi-shot-concat |
+| 有参考，大致复刻 | clone-loose |
+| 有参考，高度还原 | clone-strict |
+| PDP 多卖点 | pdp-feature-concat |
+| 人物讲话 | talking-head |
 
-### 1. 选策略
+> **DashScope 回退**：如需 DashScope 特有功能（自动配音、负向提示词），可用 `--provider dashscope`，但仅支持图生视频，时长 5|10s。
 
-| 特征 | 策略 | 模式（见 §0） |
-|---|---|---|
-| 1 镜头，无参考 | single-shot | 依 §0 |
-| 多镜头，无参考 | multi-shot-concat | 依 §0 |
-| 有参考，大致复刻 | clone-loose | 依 §0（含参考音频时强制高保真）|
-| **有参考，高度还原** | **clone-strict** | **高保真（强制）** |
-| PDP 多卖点 | pdp-feature-concat | 依 §0 |
-| **人物讲话 + 严格对口型** | **talking-head** | **高保真（强制）** |
-| 用户明确要 premium 质量 | 任一 + premium | 高保真（强制）|
+### 1. 写 `videos/{id}/production-plan.md`
 
-**高保真模式 CLI flag**：`--provider piapi`。标准模式不加 flag。
+Sora2 仅支持 10 或 15 秒整段生成。Storyboard 的细粒度段需要在 Production Plan 中**合并为 gen video 调用单元**：
 
-### 2. 写 `videos/{id}/production-plan.md`
+- 相邻短段（叙事连贯、同一场景）合并成一个 10s 或 15s 的 gen video 调用
+- 每个调用的 prompt 合并覆盖所有子段的内容描述
+- 生成后用 ffmpeg trim 切回各子段时长
+- 单独一个 10s+ 的 storyboard 段直接映射为一个 gen video 调用
 
 ```markdown
 # Production Plan
 
 ## 策略
 <策略名>
-模式: <标准 / 高保真>（依 §0 决策）
 原因: <选择理由>
 
-## 步骤
-| Step | 工具 | 输入 | 输出 | 依赖 | duration_s | seed | negative | audio | Prompt 摘要 |
-|---|---|---|---|---|---|---|---|---|---|
-| 1 | <工具> | <输入> | <输出> | — | <storyboard 段时长> | <seed 或 `-`> | <NEGATIVE 短摘要 或 `-`> | <`default` / `--no-audio`> | <prompt 或 N/A> |
+## 生成调用
+| Call | 合并段 | gen_duration | seed | aspect_ratio | Prompt 摘要 |
+|---|---|---|---|---|---|
+| 1 | seg 1-3 (共 8s) | 10 | <seed 或 `-`> | <16:9 \| 9:16 \| 1:1> | <合并 prompt> |
+| 2 | seg 4 (12s) | 15 | $PRODUCT_SEED | <同上> | <prompt> |
 | ... |
 
+## Trim 映射
+| seg | 来源 Call | trim 区间 | 输出 |
+|---|---|---|---|
+| 1 | Call 1 | 0:00-2.5s | clips/seg-1.mp4 |
+| 2 | Call 1 | 2.5-5.5s | clips/seg-2.mp4 |
+| 3 | Call 1 | 5.5-8.0s | clips/seg-3.mp4 |
+| 4 | Call 2 | 0:00-12.0s | clips/seg-4.mp4 |
+
 **seed 规则**：同一产品的镜头（如 template PRODUCT_LOCK 指定的 #4/#5/#6/#9）**共用一个 seed**（任选一个固定整数记录下来）。PAIN / 场景段（如 #1/#2/#3）无产品时可填 `-`。
 
 ## 验收标准
@@ -395,11 +384,9 @@ Storyboard 确认后自动推导。用户通常不改。
 - CTA: <从 Storyboard>
 ```
 
-`duration_s` 字段直接 = storyboard 该段时长（精度 0.5s）。不允许四舍五入到 5 或 10。
+### 2. 为每个需 prompt 的步骤生成 `prompts/call-N.txt`
 
-### 3. 为每个需 prompt 的步骤生成 `prompts/seg-N.txt`
-
-### 4. `git commit -m "video: plan $VIDEO_ID — <strategy>"`
+### 3. `git commit -m "video: plan $VIDEO_ID — <strategy>"`
 
 ## 执行生成
 
@@ -408,20 +395,16 @@ Storyboard 确认后自动推导。用户通常不改。
 <COST-GATE>
 **生成前成本确认（必做，包括 Fast-path）**：在执行任何 `gen video` / `gen image` 调用之前，必须向用户展示一次成本摘要：
 
-> 即将生成 N 段视频（策略: <策略名>，模式: <标准 / 高保真>），预计：
+> 即将生成 N 段视频（策略: <策略名>），预计：
 > - 调用次数: N 次 gen video + M 次 gen image（首帧编辑）
 > - 总时长: <Σ seg.duration_s>s
 > - 预估耗时: ~X 分钟
 > - 预估成本: ~$Y（扣 Optima credits）
-> - 音频: <含同步音频 / 无音频>
->
-> <若高保真模式>不需要音频可说"静音版"降级到标准模式。</若高保真模式>
 >
 > 继续？
 
 用户说"继续"/"好"/"OK" → 开始执行。
 用户说"太贵"/"换个便宜的" → 回到 Production Plan，换策略（如 strict → loose）。
-用户说"静音版" → 若当前高保真且非强制（clone-strict / talking-head / premium）则回退标准模式，重走 COST-GATE；否则告知冲突。
 用户不回应超过合理时间 → 不执行，等用户。
 
 **即使是 Fast-path 也必须走这一步。** 这是花钱步骤的唯一确认点。**迭代、重试同样无例外。**
@@ -443,30 +426,27 @@ Storyboard 确认后自动推导。用户通常不改。
 **工具调用**：
 
 ```bash
-# 标准模式（自动配音对口型弱，适合纯生成 / 环境音 / 无讲话）
+# 图生视频（--duration 只能是 10 或 15）
 gen video <input_image> \
-  --prompt "$(cat prompts/seg-N.txt)" \
-  --negative "$NEGATIVE" \
-  --duration <seg_duration_s> \
-  --resolution <720P|1080P> \
+  --prompt "$(cat prompts/call-N.txt)" \
+  --duration <10|15> \
+  --aspect-ratio <16:9|9:16|1:1> \
   --seed $PRODUCT_SEED \
-  $AUDIO_FLAG \
-  -o clips/seg-<N>.mp4
+  -o clips/call-<N>.mp4
 
-# 高保真模式（对口型精度高，复刻带原音频 / 讲话 / premium）
-gen video <input_image> \
-  --prompt "$(cat prompts/seg-N.txt)" \
-  --negative "$NEGATIVE" \
-  --duration <seg_duration_s> \
-  --provider piapi \
-  --seed $PRODUCT_SEED \
-  $AUDIO_FLAG \
-  -o clips/seg-<N>.mp4
+# 纯文生视频（无输入图像）
+gen video \
+  --prompt "$(cat prompts/call-N.txt)" \
+  --duration <10|15> \
+  --aspect-ratio <16:9|9:16|1:1> \
+  -o clips/call-<N>.mp4
 
-# 变量约定（production-plan.md 每个 step 提供）：
-#   $NEGATIVE      = 该镜的 negative prompt（从 storyboard 或 template NEGATIVE 字段）
-#   $PRODUCT_SEED  = 锁定产品一致性的 seed（同一产品的所有镜头共用一个值，如 #4/#5/#6/#9）
-#   $AUDIO_FLAG    = 空字符串（默认有音频）/ "--no-audio"（用户说静音版）
+# ffmpeg trim — 按 Trim 映射表切回 storyboard 各段
+ffmpeg -i clips/call-1.mp4 -ss 0 -t 2.5 -c copy clips/seg-1.mp4
+ffmpeg -i clips/call-1.mp4 -ss 2.5 -t 3.0 -c copy clips/seg-2.mp4
+
+# 变量约定（production-plan.md 每个 call 提供）：
+#   $PRODUCT_SEED  = 锁定产品一致性的 seed（同一产品的所有镜头共用一个值）
 
 # 注意 --seed 必须 wire：否则每段 gen 产品外观随机变，templates 的 PRODUCT_LOCK
 # 规范（same seed across shots）会失效，电商视频产品一致性崩塌。
@@ -474,7 +454,7 @@ gen video <input_image> \
 # 首帧编辑（产品替换）— 双图模式
 gen image "<编辑指令>" -i <原始首帧> -i <产品图> -o assets/keyframes/seg-<N>-edited.jpg
 
-# 拼接
+# 拼接所有 seg 为最终视频
 printf "file '%s'\n" clips/seg-*.mp4 > concat_list.txt
 ffmpeg -f concat -safe 0 -i concat_list.txt -c copy final.mp4
 
@@ -484,13 +464,11 @@ gen task cancel <task_id>
 gen task retry <task_id>
 ```
 
-**模式选择**：按 §产出 Production Plan §0 音频决策 + §1 策略表决定。命令层面差异仅是否加 `--provider piapi`：高保真加，标准不加。
-
-**Duration**：`--duration` 直接传 production-plan.md 里该步的 `duration_s`（= storyboard 段时长，精度 0.5s）。**不允许**四舍五入到 5 或 10。多段视频仍用多次 `gen video` + `ffmpeg concat` 拼接（按段拆是 storyboard 层的决定，不是 duration 层的）。
+**Duration**：`--duration` 只接受 10 或 15。Production Plan 的 Trim 映射表负责将生成的完整视频切回 Storyboard 各段时长。
 
 **每步完成后**：
 - 删 `seg-N.pending.json`
-- 写 `seg-N.meta.json`（duration_s / resolution / mode / has_audio / status）
+- 写 `seg-N.meta.json`（duration_s / aspect_ratio / status）
 - `git commit -m "video: receive $VIDEO_ID seg-N"`
 
 **全部完成**：`git commit -m "video: done $VIDEO_ID"`
@@ -550,8 +528,7 @@ gen task retry <task_id>
 | 故障 | 处理 |
 |---|---|
 | gen 返回 failed | 重试 1 次 → 仍失败告知用户 |
-| gen video 返回 "duration out of range" | **不**自动重试/裁剪，告知用户并建议调整该段 storyboard 时长后重新 Production Plan |
-| 复刻场景用户选标准模式（便宜版） | 告知"标准模式无音频，与原音频叠加会嘴型错位"，问是否确认降级；确认后在 COST-GATE 明示"无音频" |
+| gen video 返回 "duration out of range" | **不**自动重试/裁剪，告知用户并建议调整该段 storyboard 时长（Sora2 支持 10\|15 秒）后重新 Production Plan |
 | ffmpeg 失败 | 检查输入完整性，告知用户 |
 | 源视频无法下载 | 建议手动下载后重试 |
 | scout 无结果 | 告知，转模板构建 |

package/dist/bin/comfy.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "@optima-chat/comfy-cli";
+//# sourceMappingURL=comfy.d.ts.map

package/dist/bin/comfy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comfy.d.ts","sourceRoot":"","sources":["../../bin/comfy.ts"],"names":[],"mappings":";AACA,OAAO,wBAAwB,CAAC"}

package/dist/bin/comfy.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "@optima-chat/comfy-cli";
+//# sourceMappingURL=comfy.js.map

package/dist/bin/comfy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comfy.js","sourceRoot":"","sources":["../../bin/comfy.ts"],"names":[],"mappings":";AACA,OAAO,wBAAwB,CAAC"}

package/dist/bin/growth.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "@optima-chat/growth-cli";
+//# sourceMappingURL=growth.d.ts.map

package/dist/bin/growth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth.d.ts","sourceRoot":"","sources":["../../bin/growth.ts"],"names":[],"mappings":";AACA,OAAO,yBAAyB,CAAC"}

package/dist/bin/growth.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "@optima-chat/growth-cli";
+//# sourceMappingURL=growth.js.map

package/dist/bin/growth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth.js","sourceRoot":"","sources":["../../bin/growth.ts"],"names":[],"mappings":";AACA,OAAO,yBAAyB,CAAC"}

package/dist/src/hooks-loader.d.ts

@@ -0,0 +1,6 @@
+import type { HooksConfig } from "./types.js";
+/**
+ * 从 skills 目录加载所有 skill 的 hooks
+ */
+export declare function loadSkillHooks(skillsDir: string, cwd: string, getSessionId: () => string | undefined): HooksConfig;
+//# sourceMappingURL=hooks-loader.d.ts.map

package/dist/src/hooks-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-loader.d.ts","sourceRoot":"","sources":["../../src/hooks-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AAwL5D;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,MAAM,GAAG,SAAS,GACrC,WAAW,CAiFb"}