{"id":"7a74902a-a13b-4dcc-a7dc-f87873b25f35","entityType":"agent","slug":"clawhub-harrylabsj-taobao-shopping","name":"Taobao Shopping","canonicalUrl":"https://www.xpersona.co/agent/clawhub-harrylabsj-taobao-shopping","canonicalPath":"/agent/clawhub-harrylabsj-taobao-shopping","generatedAt":"2026-10-10T08:20:16.703Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T10:56:23.974Z","emptyReason":null},"description":"Taobao shopping decision assistant. Input a Taobao product name, listing, screenshot, or link; evaluate store credibility, Tmall/enterprise/personal seller t... Skill: Taobao Shopping Owner: harrylabsj Summary: Taobao shopping decision assistant. Input a Taobao product name, listing, screenshot, or link; evaluate store credibility, Tmall/enterprise/personal seller t... Tags: buying-advice:2.1.1, china:2.1.1, ecommerce:2.1.1, latest:2.1.3, listing-risk:2.1.1, seller-comparison:2.1.1, shopping:2.1.2, shopping-decision:2.1.1, taobao:2.1.2 Version history: v2.1.3 | 2026-07-25T12","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.9K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s17a8m9q4jybb46cv60h4fxard83hmsn:taobao-shopping","sourceUrl":"https://clawhub.ai/harrylabsj/taobao-shopping","homepage":"https://clawhub.ai/harrylabsj/skills/taobao-shopping","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/harrylabsj/taobao-shopping","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/harrylabsj/skills/taobao-shopping","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Taobao shopping decision assistant. Input a Taobao product name, listing, screenshot, or link; evaluate store credibility, Tmall/enterprise/personal seller t..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T10:56:23.974Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T10:56:23.974Z","emptyReason":null},"stars":null,"forks":null,"downloads":2889,"packageName":null,"latestVersion":"2.1.3","tractionLabel":"2.9K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T10:56:23.974Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T10:56:23.974Z","lastCrawledAt":"2026-10-09T10:56:23.974Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T10:56:23.974Z","lastVerifiedAt":null,"highlights":[{"version":"2.1.3","createdAt":"2026-07-25T12:14:16.824Z","changelog":"Add required security skill card and retain public read-only research boundaries; no login, cart, coupon, checkout, order, or payment actions.","fileCount":9,"zipByteSize":11947},{"version":"2.1.2","createdAt":"2026-07-25T12:11:02.136Z","changelog":"Fix security audit scope conflicts: remove login-state cart and automatic coupon-operation claims; enforce public read-only research boundaries.","fileCount":9,"zipByteSize":11895},{"version":"2.1.1","createdAt":"2026-06-23T11:33:26.900Z","changelog":"Consolidate Taobao seller/SKU decision guidance and safety boundaries.","fileCount":12,"zipByteSize":16642},{"version":"2.1.0","createdAt":"2026-06-17T02:54:24.235Z","changelog":"P1: rewrite install-conversion summary and standardize shopping safety boundaries.","fileCount":11,"zipByteSize":12539},{"version":"1.3.0","createdAt":"2026-06-17T02:42:32.916Z","changelog":"P1: rewrite install-conversion summary and standardize shopping safety boundaries.","fileCount":11,"zipByteSize":12550},{"version":"2.0.2","createdAt":"2026-03-31T10:00:38.351Z","changelog":"Add matrix cross-sell guidance to separate Taobao-native shopping from cross-platform comparison.","fileCount":4,"zipByteSize":3879},{"version":"2.0.1","createdAt":"2026-03-31T09:55:59.622Z","changelog":"Rebuild Taobao Shopping as a clean, station-native package with clear separation from cross-platform comparison.","fileCount":4,"zipByteSize":3756},{"version":"2.0.0","createdAt":"2026-03-18T13:21:48.614Z","changelog":"Major skill upgrade with new agent-based structure and orchestration. - Introduced a modular agent framework for enhanced task handling. - Added orchestrator design, execution monitoring, resource planning, and task scheduling components. - Expanded internal documentation and workflow references for maintainability. - No changes to public guidance or user-facing behavior; foundation set for future feature growth.","fileCount":562,"zipByteSize":1104435}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17a8m9q4jybb46cv60h4fxard83hmsn:taobao-shopping","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-harrylabsj-taobao-shopping/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-harrylabsj-taobao-shopping/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-harrylabsj-taobao-shopping/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-harrylabsj-taobao-shopping/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-harrylabsj-taobao-shopping/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-harrylabsj-taobao-shopping/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T08:20:16.697Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-harrylabsj-taobao-shopping/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-harrylabsj-taobao-shopping/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-harrylabsj-taobao-shopping/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-harrylabsj-taobao-shopping/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T10:56:23.974Z","emptyReason":null},"readme":"Skill: Taobao Shopping\n\nOwner: harrylabsj\n\nSummary: Taobao shopping decision assistant. Input a Taobao product name, listing, screenshot, or link; evaluate store credibility, Tmall/enterprise/personal seller t...\n\nTags: buying-advice:2.1.1, china:2.1.1, ecommerce:2.1.1, latest:2.1.3, listing-risk:2.1.1, seller-comparison:2.1.1, shopping:2.1.2, shopping-decision:2.1.1, taobao:2.1.2\n\nVersion history:\n\nv2.1.3 | 2026-07-25T12:14:16.824Z | user\n\nAdd required security skill card and retain public read-only research boundaries; no login, cart, coupon, checkout, order, or payment actions.\n\nv2.1.2 | 2026-07-25T12:11:02.136Z | user\n\nFix security audit scope conflicts: remove login-state cart and automatic coupon-operation claims; enforce public read-only research boundaries.\n\nv2.1.1 | 2026-06-23T11:33:26.900Z | user\n\nConsolidate Taobao seller/SKU decision guidance and safety boundaries.\n\nv2.1.0 | 2026-06-17T02:54:24.235Z | user\n\nP1: rewrite install-conversion summary and standardize shopping safety boundaries.\n\nv1.3.0 | 2026-06-17T02:42:32.916Z | user\n\nP1: rewrite install-conversion summary and standardize shopping safety boundaries.\n\nv2.0.2 | 2026-03-31T10:00:38.351Z | user\n\nAdd matrix cross-sell guidance to separate Taobao-native shopping from cross-platform comparison.\n\nv2.0.1 | 2026-03-31T09:55:59.622Z | user\n\nRebuild Taobao Shopping as a clean, station-native package with clear separation from cross-platform comparison.\n\nv2.0.0 | 2026-03-18T13:21:48.614Z | auto\n\nMajor skill upgrade with new agent-based structure and orchestration.\n\n- Introduced a modular agent framework for enhanced task handling.\n- Added orchestrator design, execution monitoring, resource planning, and task scheduling components.\n- Expanded internal documentation and workflow references for maintainability.\n- No changes to public guidance or user-facing behavior; foundation set for future feature growth.\n\nv1.2.0 | 2026-03-15T12:53:25.304Z | user\n\nRename from taobao to taobao-shopping and republish the low-sensitivity public version.\n\nv1.1.2 | 2026-03-15T12:26:14.239Z | user\n\nClarify privacy boundaries for browser-assisted workflows and limit logged-in page access to explicit user requests.\n\nv1.1.1 | 2026-03-15T07:34:31.275Z | user\n\nBump version to 1.1.1 and republish from a clean package excluding repo metadata/runtime files.\n\nv1.1.0 | 2026-03-11T00:48:03.830Z | auto\n\n- Expanded guidance covering seller vetting, price negotiation, search tactics, and scam avoidance for Taobao shoppers.\n- Added clear quick reference tables for seller ratings, price types, search operators, and review analysis.\n- Included negotiation strategies and Wangwang chat tips for better deals.\n- Detailed common traps, payment protection steps, and dispute processes.\n- Updated with a \"When to Use\" section and related skill recommendations for a more helpful experience.\n\nArchive index:\n\nArchive v2.1.3: 9 files, 11947 bytes\n\nFiles: clawhub.json (418b), package.json (574b), README.md (2693b), references/browser-workflow.md (4691b), references/marketplace-guide.md (170b), references/output-patterns.md (188b), skill-card.md (2645b), SKILL.md (9824b), _meta.json (134b)\n\nFile v2.1.3:SKILL.md\n\n---\nname: taobao-shopping\nslug: taobao-shopping\nversion: 2.0.0\nhomepage: https://clawic.com/skills/taobao-shopping\ndescription: Navigate Taobao (淘宝) with expert shopping strategies, seller verification, public product search, reviews, price comparison, SKU risk checks, and cart-ready guidance. Safe default: public visible information only; login, address, checkout, order submission, and payment stay user-controlled.\nmetadata:\n  clawdbot:\n    emoji: \"🛍️\"\n    requires:\n      bins: []\n    os: [\"linux\", \"darwin\", \"win32\"]\n---\n\n# Taobao Shopping\n\nHelp users shop smarter on Taobao with expert strategies, seller verification, public product search, reviews, price comparison, SKU risk checks, and cart-ready guidance.\n\n## When to Use\n\nUser wants to shop on Taobao (淘宝), China's largest C2C/B2C marketplace. Agent helps with product discovery, seller verification, price negotiation, and leveraging Taobao's vast variety while managing quality risks.\n\n## Quick Reference\n\n| Topic | File |\n|-------|------|\n| Marketplace guide | `references/marketplace-guide.md` |\n| Output patterns | `references/output-patterns.md` |\n| Browser workflow | `references/browser-workflow.md` |\n\n## Capabilities\n\n### Supported Operations (v2.0)\n\n| Operation | Auth Required | Description |\n|-----------|---------------|-------------|\n| **Search** | Optional | Search products, filter by price/rating/brand |\n| **Browse** | Optional | Browse categories, trending items, recommendations |\n| **Product Detail** | Optional | View specs, images, pricing, promotions |\n| **Compare** | Optional | Compare prices across sellers/variants |\n| **Cart Guidance** | User-controlled | Explain how to add the confirmed SKU manually or stop before changing cart state. |\n| **Visible Coupon Notes** | No | Summarize visible coupon/promo terms; account-only coupons are user-only. |\n| **Address / Checkout / Order Preview** | User-only | Do not select address, enter checkout, submit order, or generate private order state. |\n| **Payment** | User-only | User must complete payment manually. |\n\n**Important**: Default operation stops before login, cart changes, checkout, address selection, order submission, and payment. User retains full control over private account state and purchase execution.\n\n## Workflow\n\n### Phase 1: Discovery (Agent-Assisted)\n1. **Search** - Agent searches Taobao for target product\n2. **Filter & Sort** - Apply filters (price range, rating, brand, 天猫优先)\n3. **Compare** - Agent compares top 3-5 options across sellers\n4. **Reviews** - Agent reads user reviews, extracts common pros/cons\n5. **Price Analysis** - Agent checks current price, promotions, coupon availability\n\n### Phase 2: Selection (Agent-Assisted)\n1. **Product Detail** - Agent opens selected product page\n2. **Variant Selection** - Confirm color, size, configuration\n3. **Seller Verification** - Confirm 天猫/企业店/个人店 status\n4. **Final Price Check** - Calculate 到手价 after all discounts\n\n### Phase 3: User Handoff\n1. **Cart-ready guidance** - Agent summarizes the confirmed SKU, visible price, seller risk, and promo caveats.\n2. **Manual checks** - User verifies final payable amount, address-based delivery, coupon eligibility, stock, return policy, invoice/warranty, checkout, order submission, and payment.\n\n**Agent Boundary**: Stops before login-required account state, address selection, checkout, final order submission, and payment.\n\n## Core Rules\n\n### 1. Taobao Store Types Decoded\n\nUnderstanding Taobao's ecosystem is crucial for safe shopping:\n\n| Store Badge | Chinese | Trust Level | Best For |\n|-------------|---------|-------------|----------|\n| **Tmall** | 天猫/天猫旗舰店 | ⭐⭐⭐⭐⭐ | Brand authenticity |\n| **Tmall Global** | 天猫国际 | ⭐⭐⭐⭐⭐ | Imported goods |\n| **Enterprise** | 企业店铺 | ⭐⭐⭐⭐☆ | Verified business |\n| **Personal Crown** | 个人皇冠店 | ⭐⭐⭐☆☆ | Experienced seller |\n| **Personal Regular** | 普通个人店 | ⭐⭐☆☆☆ | Price hunting |\n\n**Priority Order:** 天猫旗舰店 > 天猫 > 企业店 > 皇冠店 > 普通店\n\n### 2. The Tmall Advantage\n\n**Why Tmall Wins:**\n\n| Factor | Tmall | Personal Store |\n|--------|-------|----------------|\n| Authenticity | Brand direct/authorized | Varies |\n| Return service | 7-day no-reason | Varies by seller |\n| Customer service | Brand handles | Seller handles |\n| Fees transparency | Clear | May have hidden costs |\n| Price protection | Available | Rare |\n\n**识别天猫:**\n- Look for \"天猫\" red badge\n- URL contains \"tmall.com\"\n- Higher commission = better service\n\n### 3. Price Optimization\n\n**Understanding Taobao Pricing:**\n\n| Price Label | Meaning | Strategy |\n|-------------|---------|----------|\n| **原价** | Listed \"original\" | Often inflated |\n| **券后价** | After coupon | Real baseline |\n| **满减价** | After threshold discount | Stack with coupons |\n| **到手价** | Final after all discounts | Real cost |\n\n**Best Deal Formula:**\n```\nFinal Price = 标价 - 店铺券 - 平台券 - 满减 - 淘金币 - 支付优惠\n```\n\n**Timing for Best Prices:**\n- **618** (June 1-18) - Mid-year mega sale\n- **双11** (Nov 11) - Singles Day\n- **双12** (Dec 12) - Year-end clearance\n- **38女王节** (Mar 8) - Women's categories\n- **99划算节** (Sep 9) - Autumn sale\n\n### 4. Seller Verification\n\n**Check Before Buying:**\n\n| Metric | Green Flag | Red Flag |\n|--------|------------|----------|\n| **Rating** | 4.8+ | Below 4.6 |\n| **Reviews** | Recent positive | Old or negative |\n| **Sales** | High volume | Zero or low |\n| **Store Age** | 3+ years | New store |\n| **Return Rate** | Low | High |\n| **Description** | Detailed | Vague/copy-paste |\n\n### 5. Returns & Protection\n\n**Taobao Consumer Protection:**\n\n| Feature | Coverage | Notes |\n|---------|----------|-------|\n| 7-day return | Most items | Unused, tags on |\n| 运费险 | Optional | Buy for return shipping |\n| 假一赔四 | Tmall | Counterfeit protection |\n| 极速退款 | High credit | Instant refund |\n| 晚到必赔 | Some items | Late delivery compensation |\n\n## Agent Execution Guide\n\n### When User Says \"帮我买...\"\n\nFollow this escalation path:\n\n```\nUser: \"帮我买 iPhone 手机壳\"\n  ↓\nStep 1: Confirm Intent\n  \"我来帮你搜索 iPhone 手机壳，对比选项，核对店铺和规格。\n   登录、加购、结算、提交订单和支付需要你手动完成。\"\n  ↓\nStep 2: Discovery Phase (No login required)\n  - Search Taobao for \"iPhone 手机壳\"\n  - Filter: 天猫优先, sort by sales\n  - Compare top 3 options\n  - Read reviews for each\n  - Present comparison table\n  ↓\nStep 3: Selection Phase (No login required)\n  - User picks one option\n  - Agent opens product page\n  - Confirm variant/specs\n  - Show final price\n  ↓\nStep 4: Handoff (User-controlled)\n  \"我已经整理好下单前检查项：\n   [商品/SKU/店铺/价格/风险摘要]\n   \n   👉 请手动完成：\n   1. 打开淘宝 App\n   2. 核对规格、券后价和库存\n   3. 核对地址、运费、退换和发票/保修\n   4. 自行决定是否加入购物车、结算、提交订单并支付\"\n```\n\n### Browser Automation Rules\n\n**Always announce before action:**\n- \"正在搜索...\"\n- \"正在打开商品页面...\"\n- \"正在读取用户评价...\"\n- \"正在整理公开信息...\"\n\n**Snapshot key information:**\n- Product title, price, promotions\n- Store type badge\n- Rating and review count\n- Available variants\n- Visible coupon information\n- Delivery estimate\n\n**Stop conditions:**\n- Before any payment screen\n- When CAPTCHA appears (hand to user)\n- When login or account state is required\n- When price differs significantly from expected\n\n### Login Handling\n\n**Manual mode (default, no login)**\n```\nAgent provides:\n- Exact search keywords\n- Product links\n- Visible coupon/promo notes\n- Step-by-step manual instructions\nUser executes manually\n```\n\n## Quality Bar\n\n### Do:\n- Focus on seller verification and store type\n- Explain trade-offs clearly (variety vs. consistency)\n- Stay honest about not doing account-state operations\n- Always announce before browser actions\n- Snapshot key information for user review\n- Stop before any payment screen\n- Stop when login, cart, address, checkout, order, or payment appears\n\n### Do Not:\n- Pretend to log in or use account-state data\n- Claim to retrieve orders, coupons, or account data without login\n- Store cookies or user data\n- Present heuristics as guaranteed outcomes\n- Complete payment for user\n- Enter checkout, address, final order, or payment flows\n\n## Common Traps\n\n- **Assuming low price = best deal** → Check seller rating first\n- **Ignoring store type** → 天猫 vs. personal store matters\n- **Not checking reviews** → Photos reveal quality issues\n- **Missing coupon stacking** → Multiple discounts available\n- **Buying from new sellers** → Higher risk, less protection\n- **Forgetting 运费险** → Cheap insurance for returns\n- **Rushing without comparison** → Same item, different prices\n- **Agent overstepping** → Never complete payment for user\n\n## Taobao vs Competitors\n\n| Factor | Taobao | JD | Tmall |\n|--------|--------|-----|--------|\n| Variety | Best | Good | Good |\n| Price | Lowest | Higher | Medium |\n| Authenticity | Varies | Best | Good |\n| Shipping | Varies | Fastest | Good |\n| Electronics | Riskier | Best | Good |\n| Fashion | Best choice | Limited | Good |\n\n**When to Choose Taobao:**\n- Fashion and accessories\n- Hard-to-find items\n- Price-sensitive purchases\n- Custom/handmade goods\n- When variety matters most\n\n## Related Skills\n\nInstall with `clawhub install <slug>` if user confirms:\n- `jingdong` - JD.com shopping\n- `jd-shopping` - Alternative JD guide\n- `tianmao` - Tmall shopping\n- `pdd` - Pinduoduo shopping\n- `vip` - VIP flash sales\n\n## Feedback\n\n- If useful: `clawhub star taobao-shopping`\n- Stay updated: `clawhub sync`\n\nFile v2.1.3:README.md\n\n# Taobao Shopping Skill v2.0\n\n淘宝购物助手 Skill，支持公开信息下的搜索、比价、看评论、店铺/SKU 风险判断和下单前核对清单。登录、加购、结算、提交订单和支付留给用户控制。\n\n## 功能特性\n\n- 🔍 **商品搜索**：关键词搜索，支持筛选和排序\n- 📖 **商品浏览**：浏览分类、推荐商品\n- 📄 **商品详情**：查看规格、图片、价格、促销\n- 💰 **价格对比**：多店铺/多规格比价\n- 🛒 **购物车指导**：整理确认好的 SKU 和手动加购前核对项\n- 🎫 **优惠信息**：仅记录页面可见的优惠条件，不申请或应用优惠券\n- 📋 **下单前清单**：提示用户手动核对最终到手价、地址、优惠、库存、退换和发票/保修\n\n## 安全边界\n\n| 操作 | Agent | 用户 |\n|------|-------|------|\n| 搜索/浏览 | ✅ | - |\n| 比价/看评论 | ✅ | - |\n| 加购/用券 | 手动指导 | ✅ |\n| 地址/结算/提交订单/支付 | ❌ | ✅ |\n\n## 工作流程\n\n```\n发现 → 对比 → 选择 → 风险核对 → 手动加购/结算/支付\n```\n\n## 店铺类型优先级\n\n1. **天猫旗舰店** ⭐⭐⭐⭐⭐ - 品牌直营，最可靠\n2. **天猫** ⭐⭐⭐⭐⭐ - 品牌授权，正品保障\n3. **企业店铺** ⭐⭐⭐⭐☆ - 认证企业，较可靠\n4. **个人皇冠店** ⭐⭐⭐☆☆ - 经验丰富，需谨慎\n5. **普通个人店** ⭐⭐☆☆☆ - 价格优势，风险较高\n\n## 价格计算公式\n\n```\n到手价 = 标价 - 店铺券 - 平台券 - 满减 - 淘金币 - 支付优惠\n```\n\n## 最佳购物时机\n\n- **618** (6月1-18日) - 年中大促\n- **双11** (11月11日) - 全年最大促销\n- **双12** (12月12日) - 年终清仓\n- **38女王节** (3月8日) - 女性品类\n- **99划算节** (9月9日) - 秋季促销\n\n## 版本\n\n- v2.1.3 - 增加安全审计所需的 skill card，并继续统一公开信息只读边界\n- v2.1.2 - 统一公开信息只读边界，移除登录态购物车和自动用券描述\n- v2.0.0 - 新增公开商品页面的浏览辅助；不使用登录态，不操作购物车\n- v1.0.0 - 基础购物指南\n\n## 安装\n\n```bash\nclawhub install taobao-shopping\n```\n\n## 使用\n\n```\n用户：帮我买蓝牙耳机\nAgent：搜索 → 对比 → 核对店铺、规格、评价和价格风险 → 输出手动下单前清单\n用户：核对信息后自行决定是否在淘宝页面加购、结算、提交订单并支付\n```\n\n## 相关 Skill\n\n- `jingdong` - 京东购物\n- `jd-shopping` - 京东购物（替代版）\n- `tianmao` - 天猫购物\n- `pdd` - 拼多多购物\n- `vip` - 唯品会购物\n\n## 反馈\n\n- 觉得好用：`clawhub star taobao-shopping`\n- 获取更新：`clawhub sync`\n\nFile v2.1.3:_meta.json\n\n{\n  \"ownerId\": \"kn77zzg9p845zanvy6vrf76k7d81mcnm\",\n  \"slug\": \"taobao-shopping\",\n  \"version\": \"2.1.3\",\n  \"publishedAt\": 1784981656824\n}\n\nFile v2.1.3:references/browser-workflow.md\n\n# Public Browser Workflow for Taobao Shopping\n\nThis document describes the read-only browser workflow for public Taobao research.\n\n## Overview\n\nTaobao browsing follows a phased approach that ends before any private account state or purchase action.\n\n**Scope:** Use public pages and user-provided screenshots/details only. Do not log in, use cookies, access account pages, change cart state, apply or claim coupons, select an address, enter checkout, submit an order, or pay.\n\n## Authentication Requirements\n\n| Operation | Login Required | Notes |\n|-----------|----------------|-------|\n| Search | No | Public search results |\n| Browse categories | No | Public category pages |\n| View product details | No | Public product pages |\n| Read reviews | No | Public review data |\n| Compare prices | No | Public price information |\n| Add to cart | User-only by default | Requires active session; provide manual guidance instead |\n| View cart | User-only by default | Private account state |\n| Apply coupons | User-only by default | Private account state |\n| Address / checkout / order preview | User-only | Do not enter checkout or address flows |\n| Payment | User-only | User only |\n\n## Browser Extraction Order\n\nWhen extracting data from Taobao pages, follow this priority:\n\n1. **商品标题** - Product title\n2. **价格信息** - 原价, 券后价, 到手价\n3. **店铺类型** - 天猫/企业店/个人店\n4. **店铺评分** - 描述相符, 服务态度, 物流服务\n5. **销量** - 月销/总销量\n6. **可见优惠信息** - 店铺券/平台券的公开条款；不申请或应用优惠券\n7. **满减活动** - 满X减Y\n8. **规格选项** - 颜色, 尺寸, 版本\n9. **用户评价** - 好评率, 追评, 晒图\n10. **物流信息** - 发货地, 运费, 预计送达\n\n## Workflow Phases\n\n### Phase 1: Discovery\n\n**Actions:**\n- Navigate to taobao.com\n- Enter search query\n- Apply filters (price, rating, brand)\n- Sort results (sales, price, rating)\n- Extract top 3-5 product summaries\n\n**Key Data Points:**\n- Product title\n- Main image\n- Price range\n- Sales volume\n- Store type badge\n- Rating score\n\n### Phase 2: Selection\n\n**Actions:**\n- Open selected product page\n- Extract detailed specifications\n- Read user reviews (first 10-20)\n- Check variant options\n- Verify seller information\n\n**Key Data Points:**\n- Full product description\n- All available variants\n- Detailed visible pricing and promotion terms (without applying coupons)\n- Store rating breakdown\n- Return policy\n- Shipping cost\n\n### Phase 3: Cart-Ready Handoff\n\n**Key Data Points:**\n- Confirmed product and SKU\n- Visible price and promo caveats\n- Seller trust and review risks\n- Manual checks for final payable amount, stock, address-based delivery, coupons, return policy, invoice, warranty, checkout, and payment\n\n**Actions:**\n- Present cart-ready summary from public evidence\n- Stop before login, cart change, checkout, address, order, or payment screen\n- Provide manual next-step instructions\n\n**Never:**\n- Enter payment information\n- Click checkout, settlement, final submit, or order buttons\n- Complete transaction\n\n## Error Handling\n\n### CAPTCHA\nWhen CAPTCHA appears:\n1. Stop automation\n2. Notify user\n3. Provide manual instructions\n\n### Login Required\nWhen login is required:\n1. Stop automation\n2. Tell the user the next step is account-state/private\n3. Never ask for password, SMS code, CAPTCHA, identity, address, or payment details in chat\n\n### Price Mismatch\nWhen displayed price differs from expected:\n1. Flag the discrepancy\n2. Re-extract pricing\n3. Confirm with user before proceeding\n\n### Out of Stock\nWhen selected variant is out of stock:\n1. Notify user\n2. Show available alternatives\n3. Wait for user selection\n\n## Security Guidelines\n\n1. **Never store credentials**\n2. **Never complete payment**\n3. **Stop before login-required account-state actions**\n4. **Snapshot key data for verification**\n5. **Provide clear handoff instructions**\n\n## Example Session\n\n```\nUser: 帮我买蓝牙耳机\n\nAgent: \n1. Searches \"蓝牙耳机 天猫\" on Taobao\n2. Filters by Tmall stores, sorts by sales\n3. Extracts top 3 options with prices\n4. Presents comparison table\n\nUser: 选第二个\n\nAgent:\n1. Opens product detail page\n2. Extracts specifications and reviews\n3. Shows variant options (color, model)\n4. Separates visible price from account-dependent coupon or payment conditions\n\nUser: 买白色的\n\nAgent:\n1. Summarizes the confirmed SKU, seller risk, visible price, and promo caveats\n2. Lists manual checks before the user decides to add to cart, checkout, submit, or pay\n```\n\n## Related Files\n\n- `marketplace-guide.md` - Taobao marketplace characteristics\n- `output-patterns.md` - Response formatting guidelines\n\nFile v2.1.3:references/marketplace-guide.md\n\n# Marketplace Guide\n\nTaobao is strong for:\n- variety\n- style breadth\n- price range\n\nWatch for:\n- seller quality variation\n- variant confusion\n- image-vs-reality mismatch\n\nFile v2.1.3:references/output-patterns.md\n\n# Output Patterns\n\n## Best Use\nState when Taobao is a good fit.\n\n## Why\nExplain the fit.\n\n## Caveats\nMention seller and quality risks.\n\n## Final Advice\nGive a practical buying suggestion.\n\nFile v2.1.3:skill-card.md\n\n## Description:\n\nHelps agents research Taobao products using public information, compare sellers, prices, reviews, and SKU risks, and prepare user-controlled cart and checkout handoff guidance.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[harrylabsj](https://clawhub.ai/user/harrylabsj)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and shopping assistants use this skill to research Taobao listings, compare options, assess seller and SKU risk, and prepare a manual pre-purchase checklist. It is intended for public visible information only; account state, checkout, order submission, and payment remain user-controlled.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Public shopping data such as price, stock, promotions, seller status, reviews, and delivery terms may change or vary by account, location, or time.\n\nMitigation: Treat the skill output as decision support and have the user verify final payable amount, stock, address-based delivery, coupon eligibility, return terms, invoice, and warranty before purchase.\n\nRisk: Login, address, coupon, cart, checkout, order, and payment flows involve private account state or financial action.\n\nMitigation: Stop before those flows and require the user to complete any cart changes, checkout, order submission, and payment manually.\n\nRisk: The skill may encounter requests for passwords, SMS codes, payment details, address details, or other account data while researching Taobao pages.\n\nMitigation: Do not collect or store those details; hand control back to the user whenever authentication, CAPTCHA, private account state, or payment information is required.\n\n## Reference(s):\n\n- [Public Browser Workflow for Taobao Shopping](references/browser-workflow.md)\n- [Marketplace Guide](references/marketplace-guide.md)\n- [Output Patterns](references/output-patterns.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, guidance]\n\n**Output Format:** [Markdown shopping summaries, comparison tables, risk notes, and handoff checklists]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Uses public Taobao information and user-provided details; does not perform login, cart, checkout, order, or payment actions.]\n\n## Skill Version(s):\n\n2.1.3 (source: server release evidence, clawhub.json, package.json, README changelog)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v2.1.3:clawhub.json\n\n{\n  \"name\": \"taobao-shopping\",\n  \"version\": \"2.1.3\",\n  \"description\": \"淘宝购物决策助手 - 仅基于公开信息搜索、比价、看评论和评估店铺/SKU 风险；不登录、不操作购物车或优惠券，支付由用户完成\",\n  \"keywords\": [\"taobao\", \"淘宝\", \"shopping\", \"e-commerce\"],\n  \"author\": \"harrylabsj\",\n  \"license\": \"MIT\",\n  \"repository\": \"https://github.com/harrylabsj/taobao-shopping\"\n}\n\nFile v2.1.3:package.json\n\n{\n  \"name\": \"taobao-shopping-skill\",\n  \"version\": \"2.1.3\",\n  \"description\": \"淘宝购物决策助手 - 仅基于公开信息搜索、比价、看评论和评估店铺/SKU 风险；不登录、不操作购物车或优惠券\",\n  \"main\": \"SKILL.md\",\n  \"keywords\": [\n    \"taobao\",\n    \"淘宝\",\n    \"shopping\",\n    \"e-commerce\",\n    \"openclaw\",\n    \"skill\"\n  ],\n  \"author\": \"harrylabsj\",\n  \"license\": \"MIT\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/harrylabsj/taobao-shopping.git\"\n  },\n  \"homepage\": \"https://clawhub.ai/harrylabsj/taobao-shopping\"\n}\n\nArchive v2.1.2: 9 files, 11895 bytes\n\nFiles: clawhub.json (418b), package.json (574b), README.md (2601b), references/browser-workflow.md (4691b), references/marketplace-guide.md (170b), references/output-patterns.md (188b), skill-card.md (2745b), SKILL.md (9824b), _meta.json (134b)\n\nFile v2.1.2:SKILL.md\n\n---\nname: taobao-shopping\nslug: taobao-shopping\nversion: 2.0.0\nhomepage: https://clawic.com/skills/taobao-shopping\ndescription: Navigate Taobao (淘宝) with expert shopping strategies, seller verification, public product search, reviews, price comparison, SKU risk checks, and cart-ready guidance. Safe default: public visible information only; login, address, checkout, order submission, and payment stay user-controlled.\nmetadata:\n  clawdbot:\n    emoji: \"🛍️\"\n    requires:\n      bins: []\n    os: [\"linux\", \"darwin\", \"win32\"]\n---\n\n# Taobao Shopping\n\nHelp users shop smarter on Taobao with expert strategies, seller verification, public product search, reviews, price comparison, SKU risk checks, and cart-ready guidance.\n\n## When to Use\n\nUser wants to shop on Taobao (淘宝), China's largest C2C/B2C marketplace. Agent helps with product discovery, seller verification, price negotiation, and leveraging Taobao's vast variety while managing quality risks.\n\n## Quick Reference\n\n| Topic | File |\n|-------|------|\n| Marketplace guide | `references/marketplace-guide.md` |\n| Output patterns | `references/output-patterns.md` |\n| Browser workflow | `references/browser-workflow.md` |\n\n## Capabilities\n\n### Supported Operations (v2.0)\n\n| Operation | Auth Required | Description |\n|-----------|---------------|-------------|\n| **Search** | Optional | Search products, filter by price/rating/brand |\n| **Browse** | Optional | Browse categories, trending items, recommendations |\n| **Product Detail** | Optional | View specs, images, pricing, promotions |\n| **Compare** | Optional | Compare prices across sellers/variants |\n| **Cart Guidance** | User-controlled | Explain how to add the confirmed SKU manually or stop before changing cart state. |\n| **Visible Coupon Notes** | No | Summarize visible coupon/promo terms; account-only coupons are user-only. |\n| **Address / Checkout / Order Preview** | User-only | Do not select address, enter checkout, submit order, or generate private order state. |\n| **Payment** | User-only | User must complete payment manually. |\n\n**Important**: Default operation stops before login, cart changes, checkout, address selection, order submission, and payment. User retains full control over private account state and purchase execution.\n\n## Workflow\n\n### Phase 1: Discovery (Agent-Assisted)\n1. **Search** - Agent searches Taobao for target product\n2. **Filter & Sort** - Apply filters (price range, rating, brand, 天猫优先)\n3. **Compare** - Agent compares top 3-5 options across sellers\n4. **Reviews** - Agent reads user reviews, extracts common pros/cons\n5. **Price Analysis** - Agent checks current price, promotions, coupon availability\n\n### Phase 2: Selection (Agent-Assisted)\n1. **Product Detail** - Agent opens selected product page\n2. **Variant Selection** - Confirm color, size, configuration\n3. **Seller Verification** - Confirm 天猫/企业店/个人店 status\n4. **Final Price Check** - Calculate 到手价 after all discounts\n\n### Phase 3: User Handoff\n1. **Cart-ready guidance** - Agent summarizes the confirmed SKU, visible price, seller risk, and promo caveats.\n2. **Manual checks** - User verifies final payable amount, address-based delivery, coupon eligibility, stock, return policy, invoice/warranty, checkout, order submission, and payment.\n\n**Agent Boundary**: Stops before login-required account state, address selection, checkout, final order submission, and payment.\n\n## Core Rules\n\n### 1. Taobao Store Types Decoded\n\nUnderstanding Taobao's ecosystem is crucial for safe shopping:\n\n| Store Badge | Chinese | Trust Level | Best For |\n|-------------|---------|-------------|----------|\n| **Tmall** | 天猫/天猫旗舰店 | ⭐⭐⭐⭐⭐ | Brand authenticity |\n| **Tmall Global** | 天猫国际 | ⭐⭐⭐⭐⭐ | Imported goods |\n| **Enterprise** | 企业店铺 | ⭐⭐⭐⭐☆ | Verified business |\n| **Personal Crown** | 个人皇冠店 | ⭐⭐⭐☆☆ | Experienced seller |\n| **Personal Regular** | 普通个人店 | ⭐⭐☆☆☆ | Price hunting |\n\n**Priority Order:** 天猫旗舰店 > 天猫 > 企业店 > 皇冠店 > 普通店\n\n### 2. The Tmall Advantage\n\n**Why Tmall Wins:**\n\n| Factor | Tmall | Personal Store |\n|--------|-------|----------------|\n| Authenticity | Brand direct/authorized | Varies |\n| Return service | 7-day no-reason | Varies by seller |\n| Customer service | Brand handles | Seller handles |\n| Fees transparency | Clear | May have hidden costs |\n| Price protection | Available | Rare |\n\n**识别天猫:**\n- Look for \"天猫\" red badge\n- URL contains \"tmall.com\"\n- Higher commission = better service\n\n### 3. Price Optimization\n\n**Understanding Taobao Pricing:**\n\n| Price Label | Meaning | Strategy |\n|-------------|---------|----------|\n| **原价** | Listed \"original\" | Often inflated |\n| **券后价** | After coupon | Real baseline |\n| **满减价** | After threshold discount | Stack with coupons |\n| **到手价** | Final after all discounts | Real cost |\n\n**Best Deal Formula:**\n```\nFinal Price = 标价 - 店铺券 - 平台券 - 满减 - 淘金币 - 支付优惠\n```\n\n**Timing for Best Prices:**\n- **618** (June 1-18) - Mid-year mega sale\n- **双11** (Nov 11) - Singles Day\n- **双12** (Dec 12) - Year-end clearance\n- **38女王节** (Mar 8) - Women's categories\n- **99划算节** (Sep 9) - Autumn sale\n\n### 4. Seller Verification\n\n**Check Before Buying:**\n\n| Metric | Green Flag | Red Flag |\n|--------|------------|----------|\n| **Rating** | 4.8+ | Below 4.6 |\n| **Reviews** | Recent positive | Old or negative |\n| **Sales** | High volume | Zero or low |\n| **Store Age** | 3+ years | New store |\n| **Return Rate** | Low | High |\n| **Description** | Detailed | Vague/copy-paste |\n\n### 5. Returns & Protection\n\n**Taobao Consumer Protection:**\n\n| Feature | Coverage | Notes |\n|---------|----------|-------|\n| 7-day return | Most items | Unused, tags on |\n| 运费险 | Optional | Buy for return shipping |\n| 假一赔四 | Tmall | Counterfeit protection |\n| 极速退款 | High credit | Instant refund |\n| 晚到必赔 | Some items | Late delivery compensation |\n\n## Agent Execution Guide\n\n### When User Says \"帮我买...\"\n\nFollow this escalation path:\n\n```\nUser: \"帮我买 iPhone 手机壳\"\n  ↓\nStep 1: Confirm Intent\n  \"我来帮你搜索 iPhone 手机壳，对比选项，核对店铺和规格。\n   登录、加购、结算、提交订单和支付需要你手动完成。\"\n  ↓\nStep 2: Discovery Phase (No login required)\n  - Search Taobao for \"iPhone 手机壳\"\n  - Filter: 天猫优先, sort by sales\n  - Compare top 3 options\n  - Read reviews for each\n  - Present comparison table\n  ↓\nStep 3: Selection Phase (No login required)\n  - User picks one option\n  - Agent opens product page\n  - Confirm variant/specs\n  - Show final price\n  ↓\nStep 4: Handoff (User-controlled)\n  \"我已经整理好下单前检查项：\n   [商品/SKU/店铺/价格/风险摘要]\n   \n   👉 请手动完成：\n   1. 打开淘宝 App\n   2. 核对规格、券后价和库存\n   3. 核对地址、运费、退换和发票/保修\n   4. 自行决定是否加入购物车、结算、提交订单并支付\"\n```\n\n### Browser Automation Rules\n\n**Always announce before action:**\n- \"正在搜索...\"\n- \"正在打开商品页面...\"\n- \"正在读取用户评价...\"\n- \"正在整理公开信息...\"\n\n**Snapshot key information:**\n- Product title, price, promotions\n- Store type badge\n- Rating and review count\n- Available variants\n- Visible coupon information\n- Delivery estimate\n\n**Stop conditions:**\n- Before any payment screen\n- When CAPTCHA appears (hand to user)\n- When login or account state is required\n- When price differs significantly from expected\n\n### Login Handling\n\n**Manual mode (default, no login)**\n```\nAgent provides:\n- Exact search keywords\n- Product links\n- Visible coupon/promo notes\n- Step-by-step manual instructions\nUser executes manually\n```\n\n## Quality Bar\n\n### Do:\n- Focus on seller verification and store type\n- Explain trade-offs clearly (variety vs. consistency)\n- Stay honest about not doing account-state operations\n- Always announce before browser actions\n- Snapshot key information for user review\n- Stop before any payment screen\n- Stop when login, cart, address, checkout, order, or payment appears\n\n### Do Not:\n- Pretend to log in or use account-state data\n- Claim to retrieve orders, coupons, or account data without login\n- Store cookies or user data\n- Present heuristics as guaranteed outcomes\n- Complete payment for user\n- Enter checkout, address, final order, or payment flows\n\n## Common Traps\n\n- **Assuming low price = best deal** → Check seller rating first\n- **Ignoring store type** → 天猫 vs. personal store matters\n- **Not checking reviews** → Photos reveal quality issues\n- **Missing coupon stacking** → Multiple discounts available\n- **Buying from new sellers** → Higher risk, less protection\n- **Forgetting 运费险** → Cheap insurance for returns\n- **Rushing without comparison** → Same item, different prices\n- **Agent overstepping** → Never complete payment for user\n\n## Taobao vs Competitors\n\n| Factor | Taobao | JD | Tmall |\n|--------|--------|-----|--------|\n| Variety | Best | Good | Good |\n| Price | Lowest | Higher | Medium |\n| Authenticity | Varies | Best | Good |\n| Shipping | Varies | Fastest | Good |\n| Electronics | Riskier | Best | Good |\n| Fashion | Best choice | Limited | Good |\n\n**When to Choose Taobao:**\n- Fashion and accessories\n- Hard-to-find items\n- Price-sensitive purchases\n- Custom/handmade goods\n- When variety matters most\n\n## Related Skills\n\nInstall with `clawhub install <slug>` if user confirms:\n- `jingdong` - JD.com shopping\n- `jd-shopping` - Alternative JD guide\n- `tianmao` - Tmall shopping\n- `pdd` - Pinduoduo shopping\n- `vip` - VIP flash sales\n\n## Feedback\n\n- If useful: `clawhub star taobao-shopping`\n- Stay updated: `clawhub sync`\n\nFile v2.1.2:README.md\n\n# Taobao Shopping Skill v2.0\n\n淘宝购物助手 Skill，支持公开信息下的搜索、比价、看评论、店铺/SKU 风险判断和下单前核对清单。登录、加购、结算、提交订单和支付留给用户控制。\n\n## 功能特性\n\n- 🔍 **商品搜索**：关键词搜索，支持筛选和排序\n- 📖 **商品浏览**：浏览分类、推荐商品\n- 📄 **商品详情**：查看规格、图片、价格、促销\n- 💰 **价格对比**：多店铺/多规格比价\n- 🛒 **购物车指导**：整理确认好的 SKU 和手动加购前核对项\n- 🎫 **优惠信息**：仅记录页面可见的优惠条件，不申请或应用优惠券\n- 📋 **下单前清单**：提示用户手动核对最终到手价、地址、优惠、库存、退换和发票/保修\n\n## 安全边界\n\n| 操作 | Agent | 用户 |\n|------|-------|------|\n| 搜索/浏览 | ✅ | - |\n| 比价/看评论 | ✅ | - |\n| 加购/用券 | 手动指导 | ✅ |\n| 地址/结算/提交订单/支付 | ❌ | ✅ |\n\n## 工作流程\n\n```\n发现 → 对比 → 选择 → 风险核对 → 手动加购/结算/支付\n```\n\n## 店铺类型优先级\n\n1. **天猫旗舰店** ⭐⭐⭐⭐⭐ - 品牌直营，最可靠\n2. **天猫** ⭐⭐⭐⭐⭐ - 品牌授权，正品保障\n3. **企业店铺** ⭐⭐⭐⭐☆ - 认证企业，较可靠\n4. **个人皇冠店** ⭐⭐⭐☆☆ - 经验丰富，需谨慎\n5. **普通个人店** ⭐⭐☆☆☆ - 价格优势，风险较高\n\n## 价格计算公式\n\n```\n到手价 = 标价 - 店铺券 - 平台券 - 满减 - 淘金币 - 支付优惠\n```\n\n## 最佳购物时机\n\n- **618** (6月1-18日) - 年中大促\n- **双11** (11月11日) - 全年最大促销\n- **双12** (12月12日) - 年终清仓\n- **38女王节** (3月8日) - 女性品类\n- **99划算节** (9月9日) - 秋季促销\n\n## 版本\n\n- v2.1.2 - 统一公开信息只读边界，移除登录态购物车和自动用券描述\n- v2.0.0 - 新增公开商品页面的浏览辅助；不使用登录态，不操作购物车\n- v1.0.0 - 基础购物指南\n\n## 安装\n\n```bash\nclawhub install taobao-shopping\n```\n\n## 使用\n\n```\n用户：帮我买蓝牙耳机\nAgent：搜索 → 对比 → 核对店铺、规格、评价和价格风险 → 输出手动下单前清单\n用户：核对信息后自行决定是否在淘宝页面加购、结算、提交订单并支付\n```\n\n## 相关 Skill\n\n- `jingdong` - 京东购物\n- `jd-shopping` - 京东购物（替代版）\n- `tianmao` - 天猫购物\n- `pdd` - 拼多多购物\n- `vip` - 唯品会购物\n\n## 反馈\n\n- 觉得好用：`clawhub star taobao-shopping`\n- 获取更新：`clawhub sync`\n\nFile v2.1.2:_meta.json\n\n{\n  \"ownerId\": \"kn77zzg9p845zanvy6vrf76k7d81mcnm\",\n  \"slug\": \"taobao-shopping\",\n  \"version\": \"2.1.2\",\n  \"publishedAt\": 1784981462136\n}\n\nFile v2.1.2:references/browser-workflow.md\n\n# Public Browser Workflow for Taobao Shopping\n\nThis document describes the read-only browser workflow for public Taobao research.\n\n## Overview\n\nTaobao browsing follows a phased approach that ends before any private account state or purchase action.\n\n**Scope:** Use public pages and user-provided screenshots/details only. Do not log in, use cookies, access account pages, change cart state, apply or claim coupons, select an address, enter checkout, submit an order, or pay.\n\n## Authentication Requirements\n\n| Operation | Login Required | Notes |\n|-----------|----------------|-------|\n| Search | No | Public search results |\n| Browse categories | No | Public category pages |\n| View product details | No | Public product pages |\n| Read reviews | No | Public review data |\n| Compare prices | No | Public price information |\n| Add to cart | User-only by default | Requires active session; provide manual guidance instead |\n| View cart | User-only by default | Private account state |\n| Apply coupons | User-only by default | Private account state |\n| Address / checkout / order preview | User-only | Do not enter checkout or address flows |\n| Payment | User-only | User only |\n\n## Browser Extraction Order\n\nWhen extracting data from Taobao pages, follow this priority:\n\n1. **商品标题** - Product title\n2. **价格信息** - 原价, 券后价, 到手价\n3. **店铺类型** - 天猫/企业店/个人店\n4. **店铺评分** - 描述相符, 服务态度, 物流服务\n5. **销量** - 月销/总销量\n6. **可见优惠信息** - 店铺券/平台券的公开条款；不申请或应用优惠券\n7. **满减活动** - 满X减Y\n8. **规格选项** - 颜色, 尺寸, 版本\n9. **用户评价** - 好评率, 追评, 晒图\n10. **物流信息** - 发货地, 运费, 预计送达\n\n## Workflow Phases\n\n### Phase 1: Discovery\n\n**Actions:**\n- Navigate to taobao.com\n- Enter search query\n- Apply filters (price, rating, brand)\n- Sort results (sales, price, rating)\n- Extract top 3-5 product summaries\n\n**Key Data Points:**\n- Product title\n- Main image\n- Price range\n- Sales volume\n- Store type badge\n- Rating score\n\n### Phase 2: Selection\n\n**Actions:**\n- Open selected product page\n- Extract detailed specifications\n- Read user reviews (first 10-20)\n- Check variant options\n- Verify seller information\n\n**Key Data Points:**\n- Full product description\n- All available variants\n- Detailed visible pricing and promotion terms (without applying coupons)\n- Store rating breakdown\n- Return policy\n- Shipping cost\n\n### Phase 3: Cart-Ready Handoff\n\n**Key Data Points:**\n- Confirmed product and SKU\n- Visible price and promo caveats\n- Seller trust and review risks\n- Manual checks for final payable amount, stock, address-based delivery, coupons, return policy, invoice, warranty, checkout, and payment\n\n**Actions:**\n- Present cart-ready summary from public evidence\n- Stop before login, cart change, checkout, address, order, or payment screen\n- Provide manual next-step instructions\n\n**Never:**\n- Enter payment information\n- Click checkout, settlement, final submit, or order buttons\n- Complete transaction\n\n## Error Handling\n\n### CAPTCHA\nWhen CAPTCHA appears:\n1. Stop automation\n2. Notify user\n3. Provide manual instructions\n\n### Login Required\nWhen login is required:\n1. Stop automation\n2. Tell the user the next step is account-state/private\n3. Never ask for password, SMS code, CAPTCHA, identity, address, or payment details in chat\n\n### Price Mismatch\nWhen displayed price differs from expected:\n1. Flag the discrepancy\n2. Re-extract pricing\n3. Confirm with user before proceeding\n\n### Out of Stock\nWhen selected variant is out of stock:\n1. Notify user\n2. Show available alternatives\n3. Wait for user selection\n\n## Security Guidelines\n\n1. **Never store credentials**\n2. **Never complete payment**\n3. **Stop before login-required account-state actions**\n4. **Snapshot key data for verification**\n5. **Provide clear handoff instructions**\n\n## Example Session\n\n```\nUser: 帮我买蓝牙耳机\n\nAgent: \n1. Searches \"蓝牙耳机 天猫\" on Taobao\n2. Filters by Tmall stores, sorts by sales\n3. Extracts top 3 options with prices\n4. Presents comparison table\n\nUser: 选第二个\n\nAgent:\n1. Opens product detail page\n2. Extracts specifications and reviews\n3. Shows variant options (color, model)\n4. Separates visible price from account-dependent coupon or payment conditions\n\nUser: 买白色的\n\nAgent:\n1. Summarizes the confirmed SKU, seller risk, visible price, and promo caveats\n2. Lists manual checks before the user decides to add to cart, checkout, submit, or pay\n```\n\n## Related Files\n\n- `marketplace-guide.md` - Taobao marketplace characteristics\n- `output-patterns.md` - Response formatting guidelines\n\nFile v2.1.2:references/marketplace-guide.md\n\n# Marketplace Guide\n\nTaobao is strong for:\n- variety\n- style breadth\n- price range\n\nWatch for:\n- seller quality variation\n- variant confusion\n- image-vs-reality mismatch\n\nFile v2.1.2:references/output-patterns.md\n\n# Output Patterns\n\n## Best Use\nState when Taobao is a good fit.\n\n## Why\nExplain the fit.\n\n## Caveats\nMention seller and quality risks.\n\n## Final Advice\nGive a practical buying suggestion.\n\nFile v2.1.2:skill-card.md\n\n## Description: <br>\nHelps users research Taobao products using public information, compare sellers, prices, reviews, promotions, and SKU risks, and produce cart-ready guidance while leaving login, checkout, order submission, and payment under user control. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[harrylabsj](https://clawhub.ai/user/harrylabsj) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and shopping assistants use this skill to evaluate Taobao listings, seller credibility, visible prices, promotion caveats, reviews, and SKU risks before making their own purchase decisions. The agent provides public-information research and manual handoff guidance rather than performing account-state or payment actions. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The agent may encounter login, cart, checkout, address, order, coupon, or payment flows that involve private account state or purchasing authority. <br>\nMitigation: Keep these actions user-controlled; provide only manual handoff guidance and stop before changing cart state, entering checkout, submitting an order, or paying. <br>\nRisk: Taobao listing information, prices, promotions, seller quality, stock, and reviews can be incomplete, account-dependent, or change before purchase. <br>\nMitigation: Present findings as decision support, call out visible promotion caveats and seller/SKU risks, and instruct the user to verify final payable amount, stock, delivery, return policy, invoice, warranty, and coupon eligibility before buying. <br>\n\n\n## Reference(s): <br>\n- [Taobao Shopping ClawHub Page](https://clawhub.ai/harrylabsj/skills/taobao-shopping) <br>\n- [Public Browser Workflow](references/browser-workflow.md) <br>\n- [Marketplace Guide](references/marketplace-guide.md) <br>\n- [Output Patterns](references/output-patterns.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, Guidance] <br>\n**Output Format:** [Markdown with comparison tables, risk notes, and manual checklist guidance] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Uses public Taobao page information or user-provided screenshots/details; stops before login, cart changes, checkout, order submission, and payment.] <br>\n\n## Skill Version(s): <br>\n2.1.2 (source: server release evidence, clawhub.json, package.json, and README changelog) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v2.1.2:clawhub.json\n\n{\n  \"name\": \"taobao-shopping\",\n  \"version\": \"2.1.2\",\n  \"description\": \"淘宝购物决策助手 - 仅基于公开信息搜索、比价、看评论和评估店铺/SKU 风险；不登录、不操作购物车或优惠券，支付由用户完成\",\n  \"keywords\": [\"taobao\", \"淘宝\", \"shopping\", \"e-commerce\"],\n  \"author\": \"harrylabsj\",\n  \"license\": \"MIT\",\n  \"repository\": \"https://github.com/harrylabsj/taobao-shopping\"\n}\n\nFile v2.1.2:package.json\n\n{\n  \"name\": \"taobao-shopping-skill\",\n  \"version\": \"2.1.2\",\n  \"description\": \"淘宝购物决策助手 - 仅基于公开信息搜索、比价、看评论和评估店铺/SKU 风险；不登录、不操作购物车或优惠券\",\n  \"main\": \"SKILL.md\",\n  \"keywords\": [\n    \"taobao\",\n    \"淘宝\",\n    \"shopping\",\n    \"e-commerce\",\n    \"openclaw\",\n    \"skill\"\n  ],\n  \"author\": \"harrylabsj\",\n  \"license\": \"MIT\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/harrylabsj/taobao-shopping.git\"\n  },\n  \"homepage\": \"https://clawhub.ai/harrylabsj/taobao-shopping\"\n}\n\nArchive v2.1.1: 12 files, 16642 bytes\n\nFiles: references/marketplace-guide.md (1293b), references/output-patterns.md (639b), skill-card.md (2586b), SKILL.md (6762b), skills/taobao-shopping/clawhub.json (344b), skills/taobao-shopping/package.json (503b), skills/taobao-shopping/README.md (2412b), skills/taobao-shopping/references/browser-workflow.md (4363b), skills/taobao-shopping/references/marketplace-guide.md (170b), skills/taobao-shopping/references/output-patterns.md (188b), skills/taobao-shopping/SKILL.md (9821b), _meta.json (134b)\n\nFile v2.1.1:SKILL.md\n\n---\nname: taobao-shopping\ndescription: \"Taobao shopping decision assistant. Input a Taobao product name, listing, screenshot, or link; evaluate store credibility, Tmall/enterprise/personal seller type, SKU differences, review risks, visible prices/promotions, return protection, and buy/wait/avoid advice. Safe default: public visible information only, no login, no order submission, no payment, and no account-state actions.\"\n---\n\n# Taobao Shopping\n\nHelp users make better Taobao shopping decisions from public marketplace signals. This skill is for Taobao-only listing, seller, SKU, review, and promotion judgment. It should be useful even when the user only has a product title, screenshot, or public listing details.\n\nDefault mode is public decision support. Do not log in, access account pages, handle cookies, retrieve orders, claim coupons, change cart state, select address, submit orders, or pay for the user.\n\n## Commerce Matrix\n\nUse this skill for Taobao-internal decisions:\n\n- Is this Taobao listing trustworthy?\n- Which SKU / seller / store should I choose on Taobao?\n- Is a coupon-after price real enough to trust?\n- Is a cheap personal seller worth the risk versus Tmall?\n- What should I verify before buying this listing?\n\nPrefer nearby skills when the task changes:\n\n- `taobao-competitor-analyzer`: compare a Taobao baseline against JD, PDD, and Vipshop.\n- `jd-shopping`: trust-first JD.com buying and cart preparation.\n- `pdd-shopping`: low-price/subsidy-first Pinduoduo buying.\n- `tianmao`: Tmall / flagship authenticity-first buying.\n\n## Hard Boundaries\n\n- **No account-state actions by default**: do not log in, read orders, claim coupons, select address, change cart, or store cookies.\n- **Checkout and payment are user-only**: never click settlement, submit order, final confirmation, payment, bank, wallet, installment, or payment-provider controls.\n- **Visible evidence only**: use public page evidence or user-provided screenshots/details. If final price requires account coupons, address, checkout, or payment method, mark it as user-only verification.\n- **Privacy**: do not store cookies, addresses, phone numbers, names, cart data, order data, or payment data.\n- **Stop at account walls**: if login, CAPTCHA, identity check, address, cart, order, settlement, or payment appears, stop and hand control to the user.\n\n## Workflow\n\n### 1. Clarify The Purchase\n\nCapture:\n\n- product identity\n- intended use\n- budget\n- must-match SKU attributes: size, color, model, storage, flavor, count, version, bundle\n- risk tolerance: lowest price, authenticity, return convenience, speed, exact variant, or research\n\nAsk one short follow-up only if the product is too broad or a missing attribute would change the recommendation.\n\n### 2. Inspect The Taobao Listing Or Search Results\n\nCollect visible evidence when available:\n\n- title and core product identity\n- store type: Tmall flagship, Tmall, enterprise, crown/personal, unknown\n- store rating cues: description match, service, logistics, recent review tone\n- visible price, coupon-after price, threshold discount, member/payment/region conditions\n- monthly sales or popularity cue\n- SKU variants and whether the selected SKU changes price or content\n- review themes: photo evidence, repeat complaints, size mismatch, quality gap, shipping damage, after-sales friction\n- return/protection cues: 7-day return, shipping insurance, authenticity promise, counterfeit compensation, warranty/invoice when relevant\n\n### 3. Judge Store And SKU Risk\n\nUse store type as a trust prior, not as proof:\n\n| Store Type | Chinese Cue | Default Trust | Use Case |\n|---|---|---|---|\n| Tmall flagship | 天猫旗舰店 / 官方旗舰店 | highest | authenticity and after-sales |\n| Tmall | 天猫 | high | brand or standardized goods |\n| Enterprise store | 企业店铺 | medium-high | verified seller, still review-dependent |\n| Crown/personal store | 皇冠 / 个人店 | variable | variety and price hunting |\n| Unknown/new personal store | unclear | low | only if risk is low and evidence is strong |\n\nDowngrade confidence when:\n\n- selected SKU has a different spec, count, color, model, or bundle than the headline\n- coupon-after price depends on unclear membership, payment, or account rules\n- reviews are old, repetitive, heavily promotional, or show mismatch between photos and listing\n- seller is new, vague, low-rated, or has weak after-sales evidence\n- category is high-risk: beauty, baby, health, electronics, branded shoes/bags, safety goods\n\n### 4. Decide\n\nUse these recommendation strengths:\n\n- `可以买`: listing and seller signals are strong enough for the user's priority.\n- `谨慎买`: acceptable only with caveats or user tolerance.\n- `先别买`: risk outweighs price or evidence is too weak.\n- `需要补证据`: key information is missing.\n\nDo not let low price alone beat seller trust, SKU mismatch, return risk, or authenticity risk.\n\n## Output\n\nUse this structure unless the user asks for something shorter:\n\n### 结论\n\n- 推荐: `可以买` / `谨慎买` / `先别买` / `需要补证据`\n- 理由一句话:\n\n### 证据\n\n- 商品/SKU:\n- 店铺类型:\n- 可见价格/优惠:\n- 评论和销量:\n- 退换/保障:\n\n### 风险\n\nList the important risks: SKU mismatch, seller quality, fake discount, coupon conditions, review concerns, return friction, warranty/invoice, shipping uncertainty.\n\n### 下单前核对\n\nTell the user what to verify manually before paying: selected SKU, final payable amount, address-based delivery, coupon eligibility, stock, return policy, invoice/warranty, and payment.\n\n## Example Prompts\n\n- `这家淘宝个人店比天猫旗舰店便宜 40%，但我担心真假，帮我判断。`\n- `同一个商品有三个 SKU，标题价格很低，实际该选哪个？`\n- `这件衣服评价很多但晒图差异大，能买吗？`\n- `淘宝券后价 129，看起来很低，帮我判断是不是有规格或门槛坑。`\n- `帮我看这个淘宝链接的店铺、评价和退换风险，不要做跨平台比价。`\n- `我想知道这件商品要不要换到京东/拼多多买。` In this case, route to `taobao-competitor-analyzer`.\n\n## Quality Bar\n\nDo:\n\n- Focus on Taobao seller verification and SKU clarity.\n- Separate headline price, coupon-after price, and final payable uncertainty.\n- Treat review photos and repeated complaints as stronger evidence than marketing copy.\n- Route cross-platform same-item comparison to `taobao-competitor-analyzer`.\n- Stop at login, CAPTCHA, cart, address, settlement, order, or payment screens.\n\nDo not:\n\n- Pretend to log in or read private account data.\n- Claim to retrieve orders, private coupons, or account prices.\n- Store cookies or user data.\n- Treat low price as proof of value.\n- Submit orders, confirm orders, or pay.\n\nFile v2.1.1:skills/taobao-shopping/SKILL.md\n\n---\nname: taobao-shopping\nslug: taobao-shopping\nversion: 2.0.0\nhomepage: https://clawic.com/skills/taobao-shopping\ndescription: Navigate Taobao (淘宝) with expert shopping strategies, seller verification, public product search, reviews, price comparison, SKU risk checks, and cart-ready guidance. Safe default: public visible information only; login, address, checkout, order submission, and payment stay user-controlled.\nmetadata:\n  clawdbot:\n    emoji: \"🛍️\"\n    requires:\n      bins: []\n    os: [\"linux\", \"darwin\", \"win32\"]\n---\n\n# Taobao Shopping\n\nHelp users shop smarter on Taobao with expert strategies, seller verification, public product search, reviews, price comparison, SKU risk checks, and cart-ready guidance.\n\n## When to Use\n\nUser wants to shop on Taobao (淘宝), China's largest C2C/B2C marketplace. Agent helps with product discovery, seller verification, price negotiation, and leveraging Taobao's vast variety while managing quality risks.\n\n## Quick Reference\n\n| Topic | File |\n|-------|------|\n| Marketplace guide | `references/marketplace-guide.md` |\n| Output patterns | `references/output-patterns.md` |\n| Browser workflow | `references/browser-workflow.md` |\n\n## Capabilities\n\n### Supported Operations (v2.0)\n\n| Operation | Auth Required | Description |\n|-----------|---------------|-------------|\n| **Search** | Optional | Search products, filter by price/rating/brand |\n| **Browse** | Optional | Browse categories, trending items, recommendations |\n| **Product Detail** | Optional | View specs, images, pricing, promotions |\n| **Compare** | Optional | Compare prices across sellers/variants |\n| **Cart Guidance** | User-controlled | Explain how to add the confirmed SKU manually or stop before changing cart state. |\n| **Visible Coupon Notes** | No | Summarize visible coupon/promo terms; account-only coupons are user-only. |\n| **Address / Checkout / Order Preview** | User-only | Do not select address, enter checkout, submit order, or generate private order state. |\n| **Payment** | User-only | User must complete payment manually. |\n\n**Important**: Default operation stops before login, cart changes, checkout, address selection, order submission, and payment. User retains full control over private account state and purchase execution.\n\n## Workflow\n\n### Phase 1: Discovery (Agent-Assisted)\n1. **Search** - Agent searches Taobao for target product\n2. **Filter & Sort** - Apply filters (price range, rating, brand, 天猫优先)\n3. **Compare** - Agent compares top 3-5 options across sellers\n4. **Reviews** - Agent reads user reviews, extracts common pros/cons\n5. **Price Analysis** - Agent checks current price, promotions, coupon availability\n\n### Phase 2: Selection (Agent-Assisted)\n1. **Product Detail** - Agent opens selected product page\n2. **Variant Selection** - Confirm color, size, configuration\n3. **Seller Verification** - Confirm 天猫/企业店/个人店 status\n4. **Final Price Check** - Calculate 到手价 after all discounts\n\n### Phase 3: User Handoff\n1. **Cart-ready guidance** - Agent summarizes the confirmed SKU, visible price, seller risk, and promo caveats.\n2. **Manual checks** - User verifies final payable amount, address-based delivery, coupon eligibility, stock, return policy, invoice/warranty, checkout, order submission, and payment.\n\n**Agent Boundary**: Stops before login-required account state, address selection, checkout, final order submission, and payment.\n\n## Core Rules\n\n### 1. Taobao Store Types Decoded\n\nUnderstanding Taobao's ecosystem is crucial for safe shopping:\n\n| Store Badge | Chinese | Trust Level | Best For |\n|-------------|---------|-------------|----------|\n| **Tmall** | 天猫/天猫旗舰店 | ⭐⭐⭐⭐⭐ | Brand authenticity |\n| **Tmall Global** | 天猫国际 | ⭐⭐⭐⭐⭐ | Imported goods |\n| **Enterprise** | 企业店铺 | ⭐⭐⭐⭐☆ | Verified business |\n| **Personal Crown** | 个人皇冠店 | ⭐⭐⭐☆☆ | Experienced seller |\n| **Personal Regular** | 普通个人店 | ⭐⭐☆☆☆ | Price hunting |\n\n**Priority Order:** 天猫旗舰店 > 天猫 > 企业店 > 皇冠店 > 普通店\n\n### 2. The Tmall Advantage\n\n**Why Tmall Wins:**\n\n| Factor | Tmall | Personal Store |\n|--------|-------|----------------|\n| Authenticity | Brand direct/authorized | Varies |\n| Return service | 7-day no-reason | Varies by seller |\n| Customer service | Brand handles | Seller handles |\n| Fees transparency | Clear | May have hidden costs |\n| Price protection | Available | Rare |\n\n**识别天猫:**\n- Look for \"天猫\" red badge\n- URL contains \"tmall.com\"\n- Higher commission = better service\n\n### 3. Price Optimization\n\n**Understanding Taobao Pricing:**\n\n| Price Label | Meaning | Strategy |\n|-------------|---------|----------|\n| **原价** | Listed \"original\" | Often inflated |\n| **券后价** | After coupon | Real baseline |\n| **满减价** | After threshold discount | Stack with coupons |\n| **到手价** | Final after all discounts | Real cost |\n\n**Best Deal Formula:**\n```\nFinal Price = 标价 - 店铺券 - 平台券 - 满减 - 淘金币 - 支付优惠\n```\n\n**Timing for Best Prices:**\n- **618** (June 1-18) - Mid-year mega sale\n- **双11** (Nov 11) - Singles Day\n- **双12** (Dec 12) - Year-end clearance\n- **38女王节** (Mar 8) - Women's categories\n- **99划算节** (Sep 9) - Autumn sale\n\n### 4. Seller Verification\n\n**Check Before Buying:**\n\n| Metric | Green Flag | Red Flag |\n|--------|------------|----------|\n| **Rating** | 4.8+ | Below 4.6 |\n| **Reviews** | Recent positive | Old or negative |\n| **Sales** | High volume | Zero or low |\n| **Store Age** | 3+ years | New store |\n| **Return Rate** | Low | High |\n| **Description** | Detailed | Vague/copy-paste |\n\n### 5. Returns & Protection\n\n**Taobao Consumer Protection:**\n\n| Feature | Coverage | Notes |\n|---------|----------|-------|\n| 7-day return | Most items | Unused, tags on |\n| 运费险 | Optional | Buy for return shipping |\n| 假一赔四 | Tmall | Counterfeit protection |\n| 极速退款 | High credit | Instant refund |\n| 晚到必赔 | Some items | Late delivery compensation |\n\n## Agent Execution Guide\n\n### When User Says \"帮我买...\"\n\nFollow this escalation path:\n\n```\nUser: \"帮我买 iPhone 手机壳\"\n  ↓\nStep 1: Confirm Intent\n  \"我来帮你搜索 iPhone 手机壳，对比选项，核对店铺和规格。\n   登录、加购、结算、提交订单和支付需要你手动完成。\"\n  ↓\nStep 2: Discovery Phase (No login required)\n  - Search Taobao for \"iPhone 手机壳\"\n  - Filter: 天猫优先, sort by sales\n  - Compare top 3 options\n  - Read reviews for each\n  - Present comparison table\n  ↓\nStep 3: Selection Phase (No login required)\n  - User picks one option\n  - Agent opens product page\n  - Confirm variant/specs\n  - Show final price\n  ↓\nStep 4: Handoff (User-controlled)\n  \"我已经整理好下单前检查项：\n   [商品/SKU/店铺/价格/风险摘要]\n   \n   👉 请手动完成：\n   1. 打开淘宝 App\n   2. 核对规格、券后价和库存\n   3. 核对地址、运费、退换和发票/保修\n   4. 自行决定是否加入购物车、结算、提交订单并支付\"\n```\n\n### Browser Automation Rules\n\n**Always announce before action:**\n- \"正在搜索...\"\n- \"正在打开商品页面...\"\n- \"正在读取用户评价...\"\n- \"正在加入购物车...\"\n\n**Snapshot key information:**\n- Product title, price, promotions\n- Store type badge\n- Rating and review count\n- Available variants\n- Visible coupon information\n- Delivery estimate\n\n**Stop conditions:**\n- Before any payment screen\n- When CAPTCHA appears (hand to user)\n- When login or account state is required\n- When price differs significantly from expected\n\n### Login Handling\n\n**Manual mode (default, no login)**\n```\nAgent provides:\n- Exact search keywords\n- Product links\n- Visible coupon/promo notes\n- Step-by-step manual instructions\nUser executes manually\n```\n\n## Quality Bar\n\n### Do:\n- Focus on seller verification and store type\n- Explain trade-offs clearly (variety vs. consistency)\n- Stay honest about not doing account-state operations\n- Always announce before browser actions\n- Snapshot key information for user review\n- Stop before any payment screen\n- Stop when login, cart, address, checkout, order, or payment appears\n\n### Do Not:\n- Pretend to log in or use account-state data\n- Claim to retrieve orders, coupons, or account data without login\n- Store cookies or user data\n- Present heuristics as guaranteed outcomes\n- Complete payment for user\n- Enter checkout, address, final order, or payment flows\n\n## Common Traps\n\n- **Assuming low price = best deal** → Check seller rating first\n- **Ignoring store type** → 天猫 vs. personal store matters\n- **Not checking reviews** → Photos reveal quality issues\n- **Missing coupon stacking** → Multiple discounts available\n- **Buying from new sellers** → Higher risk, less protection\n- **Forgetting 运费险** → Cheap insurance for returns\n- **Rushing without comparison** → Same item, different prices\n- **Agent overstepping** → Never complete payment for user\n\n## Taobao vs Competitors\n\n| Factor | Taobao | JD | Tmall |\n|--------|--------|-----|--------|\n| Variety | Best | Good | Good |\n| Price | Lowest | Higher | Medium |\n| Authenticity | Varies | Best | Good |\n| Shipping | Varies | Fastest | Good |\n| Electronics | Riskier | Best | Good |\n| Fashion | Best choice | Limited | Good |\n\n**When to Choose Taobao:**\n- Fashion and accessories\n- Hard-to-find items\n- Price-sensitive purchases\n- Custom/handmade goods\n- When variety matters most\n\n## Related Skills\n\nInstall with `clawhub install <slug>` if user confirms:\n- `jingdong` - JD.com shopping\n- `jd-shopping` - Alternative JD guide\n- `tianmao` - Tmall shopping\n- `pdd` - Pinduoduo shopping\n- `vip` - VIP flash sales\n\n## Feedback\n\n- If useful: `clawhub star taobao-shopping`\n- Stay updated: `clawhub sync`\n\nFile v2.1.1:skills/taobao-shopping/README.md\n\n# Taobao Shopping Skill v2.0\n\n淘宝购物助手 Skill，支持公开信息下的搜索、比价、看评论、店铺/SKU 风险判断和下单前核对清单。登录、加购、结算、提交订单和支付留给用户控制。\n\n## 功能特性\n\n- 🔍 **商品搜索**：关键词搜索，支持筛选和排序\n- 📖 **商品浏览**：浏览分类、推荐商品\n- 📄 **商品详情**：查看规格、图片、价格、促销\n- 💰 **价格对比**：多店铺/多规格比价\n- 🛒 **购物车指导**：整理确认好的 SKU 和手动加购前核对项\n- 🎫 **优惠券**：自动检查并应用可用优惠券\n- 📋 **下单前清单**：提示用户手动核对最终到手价、地址、优惠、库存、退换和发票/保修\n\n## 安全边界\n\n| 操作 | Agent | 用户 |\n|------|-------|------|\n| 搜索/浏览 | ✅ | - |\n| 比价/看评论 | ✅ | - |\n| 加购/用券 | 手动指导 | ✅ |\n| 地址/结算/提交订单/支付 | ❌ | ✅ |\n\n## 工作流程\n\n```\n发现 → 对比 → 选择 → 风险核对 → 手动加购/结算/支付\n```\n\n## 店铺类型优先级\n\n1. **天猫旗舰店** ⭐⭐⭐⭐⭐ - 品牌直营，最可靠\n2. **天猫** ⭐⭐⭐⭐⭐ - 品牌授权，正品保障\n3. **企业店铺** ⭐⭐⭐⭐☆ - 认证企业，较可靠\n4. **个人皇冠店** ⭐⭐⭐☆☆ - 经验丰富，需谨慎\n5. **普通个人店** ⭐⭐☆☆☆ - 价格优势，风险较高\n\n## 价格计算公式\n\n```\n到手价 = 标价 - 店铺券 - 平台券 - 满减 - 淘金币 - 支付优惠\n```\n\n## 最佳购物时机\n\n- **618** (6月1-18日) - 年中大促\n- **双11** (11月11日) - 全年最大促销\n- **双12** (12月12日) - 年终清仓\n- **38女王节** (3月8日) - 女性品类\n- **99划算节** (9月9日) - 秋季促销\n\n## 版本\n\n- v2.0.0 - 新增浏览器自动化支持，登录态购物车操作\n- v1.0.0 - 基础购物指南\n\n## 安装\n\n```bash\nclawhub install taobao-shopping\n```\n\n## 使用\n\n```\n用户：帮我买蓝牙耳机\nAgent：搜索 → 对比 → 核对店铺、规格、评价和价格风险 → 输出手动下单前清单\n用户：自行加购、结算、提交订单并支付\n```\n\n## 相关 Skill\n\n- `jingdong` - 京东购物\n- `jd-shopping` - 京东购物（替代版）\n- `tianmao` - 天猫购物\n- `pdd` - 拼多多购物\n- `vip` - 唯品会购物\n\n## 反馈\n\n- 觉得好用：`clawhub star taobao-shopping`\n- 获取更新：`clawhub sync`\n\nFile v2.1.1:_meta.json\n\n{\n  \"ownerId\": \"kn77zzg9p845zanvy6vrf76k7d81mcnm\",\n  \"slug\": \"taobao-shopping\",\n  \"version\": \"2.1.1\",\n  \"publishedAt\": 1782214406900\n}\n\nFile v2.1.1:references/marketplace-guide.md\n\n# Marketplace Guide\n\nTaobao is strong for:\n\n- variety and long-tail products\n- fashion, accessories, home goods, custom goods, and niche styles\n- broad price range and many competing sellers\n- cases where the user wants choice more than standardized fulfillment\n\nTaobao is weaker when:\n\n- authenticity, warranty, invoice, or official after-sales matters most\n- the product is beauty, baby, health, safety-related, high-value electronics, or branded shoes/bags\n- the listing has unclear SKU variants or a suspiciously low headline price\n- final price depends on account-only coupons, payment offers, region, or checkout-only rules\n\nTrust cues to capture:\n\n- Tmall flagship / official flagship / Tmall / enterprise / personal store\n- description, service, and logistics ratings\n- recent review quality and photo evidence\n- return policy, shipping insurance, authenticity promise, warranty, invoice\n- whether the selected SKU matches the title and main image\n\nCommon traps:\n\n- headline price belongs to a low-spec SKU\n- coupon-after price requires hidden membership or payment conditions\n- similar-looking SKU differs by size, count, model, color, flavor, or bundle\n- review volume is high but recent reviews reveal quality drift\n- personal store is cheap but after-sales and returns are unclear\n\nFile v2.1.1:references/output-patterns.md\n\n# Output Patterns\n\n## Verdict First\n\nStart with:\n\n- `推荐`: 可以买 / 谨慎买 / 先别买 / 需要补证据\n- one sentence reason\n\n## Evidence\n\nCapture:\n\n- 商品/SKU\n- 店铺类型\n- 可见价格/优惠\n- 评论和销量\n- 退换/保障\n\n## Risks\n\nMention only meaningful risks:\n\n- SKU mismatch\n- seller quality\n- fake or conditional discount\n- review concerns\n- return friction\n- warranty/invoice gap\n- shipping or stock uncertainty\n\n## Final Checks\n\nEnd with user-only checks before payment:\n\n- selected SKU\n- final payable amount\n- address-based delivery\n- coupon eligibility\n- stock\n- return policy\n- invoice/warranty\n- payment\n\nFile v2.1.1:skills/taobao-shopping/references/browser-workflow.md\n\n# Browser Workflow for Taobao Shopping\n\nThis document describes the browser automation workflow for Taobao shopping operations.\n\n## Overview\n\nTaobao browser automation follows a phased approach with clear boundaries between agent-assisted operations and user-controlled checkout.\n\n## Authentication Requirements\n\n| Operation | Login Required | Notes |\n|-----------|----------------|-------|\n| Search | No | Public search results |\n| Browse categories | No | Public category pages |\n| View product details | No | Public product pages |\n| Read reviews | No | Public review data |\n| Compare prices | No | Public price information |\n| Add to cart | User-only by default | Requires active session; provide manual guidance instead |\n| View cart | User-only by default | Private account state |\n| Apply coupons | User-only by default | Private account state |\n| Address / checkout / order preview | User-only | Do not enter checkout or address flows |\n| Payment | User-only | User only |\n\n## Browser Extraction Order\n\nWhen extracting data from Taobao pages, follow this priority:\n\n1. **商品标题** - Product title\n2. **价格信息** - 原价, 券后价, 到手价\n3. **店铺类型** - 天猫/企业店/个人店\n4. **店铺评分** - 描述相符, 服务态度, 物流服务\n5. **销量** - 月销/总销量\n6. **优惠券** - 店铺券, 平台券\n7. **满减活动** - 满X减Y\n8. **规格选项** - 颜色, 尺寸, 版本\n9. **用户评价** - 好评率, 追评, 晒图\n10. **物流信息** - 发货地, 运费, 预计送达\n\n## Workflow Phases\n\n### Phase 1: Discovery\n\n**Actions:**\n- Navigate to taobao.com\n- Enter search query\n- Apply filters (price, rating, brand)\n- Sort results (sales, price, rating)\n- Extract top 3-5 product summaries\n\n**Key Data Points:**\n- Product title\n- Main image\n- Price range\n- Sales volume\n- Store type badge\n- Rating score\n\n### Phase 2: Selection\n\n**Actions:**\n- Open selected product page\n- Extract detailed specifications\n- Read user reviews (first 10-20)\n- Check variant options\n- Verify seller information\n\n**Key Data Points:**\n- Full product description\n- All available variants\n- Detailed pricing (with coupons)\n- Store rating breakdown\n- Return policy\n- Shipping cost\n\n### Phase 3: Cart-Ready Handoff\n\n**Key Data Points:**\n- Confirmed product and SKU\n- Visible price and promo caveats\n- Seller trust and review risks\n- Manual checks for final payable amount, stock, address-based delivery, coupons, return policy, invoice, warranty, checkout, and payment\n\n**Actions:**\n- Present cart-ready summary from public evidence\n- Stop before login, cart change, checkout, address, order, or payment screen\n- Provide manual next-step instructions\n\n**Never:**\n- Enter payment information\n- Click checkout, settlement, final submit, or order buttons\n- Complete transaction\n\n## Error Handling\n\n### CAPTCHA\nWhen CAPTCHA appears:\n1. Stop automation\n2. Notify user\n3. Provide manual instructions\n\n### Login Required\nWhen login is required:\n1. Stop automation\n2. Tell the user the next step is account-state/private\n3. Never ask for password, SMS code, CAPTCHA, identity, address, or payment details in chat\n\n### Price Mismatch\nWhen displayed price differs from expected:\n1. Flag the discrepancy\n2. Re-extract pricing\n3. Confirm with user before proceeding\n\n### Out of Stock\nWhen selected variant is out of stock:\n1. Notify user\n2. Show available alternatives\n3. Wait for user selection\n\n## Security Guidelines\n\n1. **Never store credentials**\n2. **Never complete payment**\n3. **Stop before login-required account-state actions**\n4. **Snapshot key data for verification**\n5. **Provide clear handoff instructions**\n\n## Example Session\n\n```\nUser: 帮我买蓝牙耳机\n\nAgent: \n1. Searches \"蓝牙耳机 天猫\" on Taobao\n2. Filters by Tmall stores, sorts by sales\n3. Extracts top 3 options with prices\n4. Presents comparison table\n\nUser: 选第二个\n\nAgent:\n1. Opens product detail page\n2. Extracts specifications and reviews\n3. Shows variant options (color, model)\n4. Calculates final price with coupons\n\nUser: 买白色的\n\nAgent:\n1. Summarizes the confirmed SKU, seller risk, visible price, and promo caveats\n2. Lists manual checks before the user decides to add to cart, checkout, submit, or pay\n```\n\n## Related Files\n\n- `marketplace-guide.md` - Taobao marketplace characteristics\n- `output-patterns.md` - Response formatting guidelines\n\nFile v2.1.1:skills/taobao-shopping/references/marketplace-guide.md\n\n# Marketplace Guide\n\nTaobao is strong for:\n- variety\n- style breadth\n- price range\n\nWatch for:\n- seller quality variation\n- variant confusion\n- image-vs-reality mismatch\n\nFile v2.1.1:skills/taobao-shopping/references/output-patterns.md\n\n# Output Patterns\n\n## Best Use\nState when Taobao is a good fit.\n\n## Why\nExplain the fit.\n\n## Caveats\nMention seller and quality risks.\n\n## Final Advice\nGive a practical buying suggestion.\n\nFile v2.1.1:skill-card.md\n\n## Description: <br>\nTaobao Shopping helps an agent evaluate public Taobao listings, sellers, SKUs, reviews, visible prices, promotions, return protections, and buy/wait/avoid decisions while keeping login, cart, checkout, order, and payment actions user-controlled. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[harrylabsj](https://clawhub.ai/user/harrylabsj) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and shopping assistants use this skill to research Taobao products from public listing evidence, compare seller and SKU risks, and produce a manual pre-purchase checklist. It is intended for decision support, not for changing account state or completing transactions. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Bundled documentation and metadata inconsistently mention cart or coupon actions that could affect a user's Taobao account. <br>\nMitigation: Use the skill only for public Taobao research and decision support; keep login, coupon claiming, cart changes, checkout, order submission, and payment manual. <br>\nRisk: Taobao recommendations may be misleading when final price, coupons, SKU availability, delivery, or returns depend on private account or checkout-only conditions. <br>\nMitigation: Require the user to manually verify selected SKU, final payable amount, address-based delivery, coupon eligibility, stock, return policy, invoice, warranty, and payment before buying. <br>\n\n\n## Reference(s): <br>\n- [Taobao Shopping ClawHub listing](https://clawhub.ai/harrylabsj/skills/taobao-shopping) <br>\n- [Browser Workflow](artifact/skills/taobao-shopping/references/browser-workflow.md) <br>\n- [Marketplace Guide](artifact/references/marketplace-guide.md) <br>\n- [Output Patterns](artifact/references/output-patterns.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, guidance, analysis] <br>\n**Output Format:** [Markdown with verdict, evidence, risk, and final-check sections] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Uses public-visible Taobao evidence and hands off account-state, checkout, and payment steps to the user.] <br>\n\n## Skill Version(s): <br>\n2.1.1 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v2.1.1:skills/taobao-shopping/clawhub.json\n\n{\n  \"name\": \"taobao-shopping\",\n  \"version\": \"2.0.0\",\n  \"description\": \"淘宝购物助手 - 支持搜索、比价、看评论、加购物车，支付环节留给用户\",\n  \"keywords\": [\"taobao\", \"淘宝\", \"shopping\", \"e-commerce\"],\n  \"author\": \"harrylabsj\",\n  \"license\": \"MIT\",\n  \"repository\": \"https://github.com/harrylabsj/taobao-shopping\"\n}\n\nFile v2.1.1:skills/taobao-shopping/package.json\n\n{\n  \"name\": \"taobao-shopping-skill\",\n  \"version\": \"2.0.0\",\n  \"description\": \"淘宝购物助手 Skill - 支持搜索、比价、看评论、加购物车\",\n  \"main\": \"SKILL.md\",\n  \"keywords\": [\n    \"taobao\",\n    \"淘宝\",\n    \"shopping\",\n    \"e-commerce\",\n    \"openclaw\",\n    \"skill\"\n  ],\n  \"author\": \"harrylabsj\",\n  \"license\": \"MIT\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/harrylabsj/taobao-shopping.git\"\n  },\n  \"homepage\": \"https://clawhub.ai/harrylabsj/taobao-shopping\"\n}\n\nArchive v2.1.0: 11 files, 12539 bytes\n\nFiles: references/marketplace-guide.md (170b), references/output-patterns.md (187b), skill-card.md (2505b), SKILL.md (2672b), skills/taobao-shopping/clawhub.json (344b), skills/taobao-shopping/package.json (503b), skills/taobao-shopping/references/browser-workflow.md (4260b), skills/taobao-shopping/references/marketplace-guide.md (170b), skills/taobao-shopping/references/output-patterns.md (188b), skills/taobao-shopping/SKILL.md (10670b), _meta.json (134b)\n\nFile v2.1.0:SKILL.md\n\n---\nname: taobao-shopping\ndescription: \"Taobao shopping assistant. Input a Taobao product name or link; output store credibility, SKU differences, review risks, price/promotion caveats, and buy/wait/avoid advice. Safe boundary: no login, no order submission, no payment, and no account-state actions.\"\n---\n# Taobao Shopping\n\nHelp users make better Taobao shopping decisions from public marketplace signals.\n\nThis is a low-sensitivity public skill. It focuses on public decision support and does not perform login, account access, cookie handling, order retrieval, coupon claiming, local database persistence, or browser automation runtime actions.\n\nUse this skill when the user wants public buying, ordering, sourcing, or booking guidance rather than account-state operations.\n\nFor live page inspection, account pages, checkout-state actions, or real-time retrieval that depends on login, switch to browser-based workflows instead of pretending this skill performs those actions directly.\n\nRead these references as needed:\n- `references/marketplace-guide.md` for supporting guidance\n- `references/output-patterns.md` for supporting guidance\n\n## Workflow\n\n1. Identify the user's shopping, ordering, or booking need.\n   - Accept a product, merchant, ride, store, or booking scenario.\n   - If the request is too broad, ask one short clarifying question.\n\n2. Focus on public decision-relevant factors.\n   - Prefer category fit, trust, timing, fees, conditions, and scenario fit over superficial labels.\n\n3. Explain trade-offs.\n   - Say why the strongest option fits.\n   - Mention meaningful risks or caveats.\n\n4. Give practical next-step advice.\n   - Tell the user what to verify before paying or placing an order.\n\n## Output\n\nUse this structure unless the user asks for something shorter:\n\n### Best Option\nState the strongest current choice.\n\n### Why\nList the main reasons.\n\n### Caveats\nList meaningful concerns or trade-offs.\n\n### Final Advice\nGive a direct practical suggestion.\n\n## Quality bar\n\nDo:\n- focus on public decision support\n- explain trade-offs clearly\n- stay honest about not doing account-state operations\n\nDo not:\n- pretend to log in\n- claim to retrieve orders, coupons, or account data\n- store cookies or user data\n- present heuristics as guaranteed outcomes\n\n\n## P1 Safety Boundaries\n\n- Do not enter credentials, SMS codes, passwords, CAPTCHA, identity checks, addresses, or payment details for the user.\n- Do not submit orders, click checkout, click final confirmation, or initiate payment.\n- Use browser-visible or user-provided information only; final price, stock, delivery, coupons, and after-sales terms must be rechecked by the user before purchase.\n\nFile v2.1.0:skills/taobao-shopping/SKILL.md\n\n---\nname: taobao-shopping\nslug: taobao-shopping\nversion: 2.0.0\nhomepage: https://clawic.com/skills/taobao-shopping\ndescription: Navigate Taobao (淘宝) with expert shopping strategies, seller verification, and browser-based product search, reviews, price comparison, and cart operations. Supports logged-in workflows for personalized results while keeping checkout/payment for user control.\nmetadata:\n  clawdbot:\n    emoji: \"🛍️\"\n    requires:\n      bins: []\n    os: [\"linux\", \"darwin\", \"win32\"]\n---\n\n# Taobao Shopping\n\nHelp users shop smarter on Taobao with expert strategies, seller verification, and browser-based product search, reviews, price comparison, and cart operations.\n\n## When to Use\n\nUser wants to shop on Taobao (淘宝), China's largest C2C/B2C marketplace. Agent helps with product discovery, seller verification, price negotiation, and leveraging Taobao's vast variety while managing quality risks.\n\n## Quick Reference\n\n| Topic | File |\n|-------|------|\n| Marketplace guide | `references/marketplace-guide.md` |\n| Output patterns | `references/output-patterns.md` |\n| Browser workflow | `references/browser-workflow.md` |\n\n## Capabilities\n\n### Supported Operations (v2.0)\n\n| Operation | Auth Required | Description |\n|-----------|---------------|-------------|\n| **Search** | Optional | Search products, filter by price/rating/brand |\n| **Browse** | Optional | Browse categories, trending items, recommendations |\n| **Product Detail** | Optional | View specs, images, pricing, promotions |\n| **Compare** | Optional | Compare prices across sellers/variants |\n| **Add to Cart** | ✅ Required | Add items to shopping cart |\n| **View Cart** | ✅ Required | Review cart contents, quantities |\n| **Apply Coupons** | ✅ Required | Check and apply available coupons |\n| **Generate Order Preview** | ✅ Required | Fill address, select shipping, calculate final price |\n| **Payment** | ❌ Blocked | User must complete payment manually |\n\n**Important**: All checkout operations stop before payment. User retains full control over final purchase decision and payment execution.\n\n## Workflow\n\n### Phase 1: Discovery (Agent-Assisted)\n1. **Search** - Agent searches Taobao for target product\n2. **Filter & Sort** - Apply filters (price range, rating, brand, 天猫优先)\n3. **Compare** - Agent compares top 3-5 options across sellers\n4. **Reviews** - Agent reads user reviews, extracts common pros/cons\n5. **Price Analysis** - Agent checks current price, promotions, coupon availability\n\n### Phase 2: Selection (Agent-Assisted)\n1. **Product Detail** - Agent opens selected product page\n2. **Variant Selection** - Confirm color, size, configuration\n3. **Seller Verification** - Confirm 天猫/企业店/个人店 status\n4. **Final Price Check** - Calculate 到手价 after all discounts\n\n### Phase 3: Cart & Pre-Order (Agent-Assisted with Login)\n1. **Add to Cart** - Agent adds item to cart (requires login)\n2. **Cart Review** - Agent shows cart contents, quantities, subtotal\n3. **Coupon Application** - Agent checks and applies best coupons\n4. **Address Selection** - Agent confirms delivery address\n5. **Shipping Options** - Agent shows available delivery methods\n6. **Order Summary** - Agent generates complete order preview\n\n### Phase 4: Checkout (User-Controlled)\n1. **Handoff** - Agent presents final order details\n2. **User Review** - User confirms all details are correct\n3. **Payment** - ⚠️ **User completes payment manually**\n4. **Confirmation** - User shares order confirmation with agent if desired\n\n**Agent Boundary**: Stops at Phase 3. Never executes payment or final order submission.\n\n## Core Rules\n\n### 1. Taobao Store Types Decoded\n\nUnderstanding Taobao's ecosystem is crucial for safe shopping:\n\n| Store Badge | Chinese | Trust Level | Best For |\n|-------------|---------|-------------|----------|\n| **Tmall** | 天猫/天猫旗舰店 | ⭐⭐⭐⭐⭐ | Brand authenticity |\n| **Tmall Global** | 天猫国际 | ⭐⭐⭐⭐⭐ | Imported goods |\n| **Enterprise** | 企业店铺 | ⭐⭐⭐⭐☆ | Verified business |\n| **Personal Crown** | 个人皇冠店 | ⭐⭐⭐☆☆ | Experienced seller |\n| **Personal Regular** | 普通个人店 | ⭐⭐☆☆☆ | Price hunting |\n\n**Priority Order:** 天猫旗舰店 > 天猫 > 企业店 > 皇冠店 > 普通店\n\n### 2. The Tmall Advantage\n\n**Why Tmall Wins:**\n\n| Factor | Tmall | Personal Store |\n|--------|-------|----------------|\n| Authenticity | Brand direct/authorized | Varies |\n| Return service | 7-day no-reason | Varies by seller |\n| Customer service | Brand handles | Seller handles |\n| Fees transparency | Clear | May have hidden costs |\n| Price protection | Available | Rare |\n\n**识别天猫:**\n- Look for \"天猫\" red badge\n- URL contains \"tmall.com\"\n- Higher commission = better service\n\n### 3. Price Optimization\n\n**Understanding Taobao Pricing:**\n\n| Price Label | Meaning | Strategy |\n|-------------|---------|----------|\n| **原价** | Listed \"original\" | Often inflated |\n| **券后价** | After coupon | Real baseline |\n| **满减价** | After threshold discount | Stack with coupons |\n| **到手价** | Final after all discounts | Real cost |\n\n**Best Deal Formula:**\n```\nFinal Price = 标价 - 店铺券 - 平台券 - 满减 - 淘金币 - 支付优惠\n```\n\n**Timing for Best Prices:**\n- **618** (June 1-18) - Mid-year mega sale\n- **双11** (Nov 11) - Singles Day\n- **双12** (Dec 12) - Year-end clearance\n- **38女王节** (Mar 8) - Women's categories\n- **99划算节** (Sep 9) - Autumn sale\n\n### 4. Seller Verification\n\n**Check Before Buying:**\n\n| Metric | Green Flag | Red Flag |\n|--------|------------|----------|\n| **Rating** | 4.8+ | Below 4.6 |\n| **Reviews** | Recent positive | Old or negative |\n| **Sales** | High volume | Zero or low |\n| **Store Age** | 3+ years | New store |\n| **Return Rate** | Low | High |\n| **Description** | Detailed | Vague/copy-paste |\n\n### 5. Returns & Protection\n\n**Taobao Consumer Protection:**\n\n| Feature | Coverage | Notes |\n|---------|----------|-------|\n| 7-day return | Most items | Unused, tags on |\n| 运费险 | Optional | Buy for return shipping |\n| 假一赔四 | Tmall | Counterfeit protection |\n| 极速退款 | High credit | Instant refund |\n| 晚到必赔 | Some items | Late delivery compensation |\n\n## Agent Execution Guide\n\n### When User Says \"帮我买...\"\n\nFollow this escalation path:\n\n```\nUser: \"帮我买 iPhone 手机壳\"\n  ↓\nStep 1: Confirm Intent\n  \"我来帮你搜索 iPhone 手机壳，对比选项，加入购物车。\n   最后需要你确认订单并完成支付。可以吗？\"\n  ↓\nStep 2: Discovery Phase (No login required)\n  - Search Taobao for \"iPhone 手机壳\"\n  - Filter: 天猫优先, sort by sales\n  - Compare top 3 options\n  - Read reviews for each\n  - Present comparison table\n  ↓\nStep 3: Selection Phase (No login required)\n  - User picks one option\n  - Agent opens product page\n  - Confirm variant/specs\n  - Show final price\n  ↓\nStep 4: Cart Phase (⚠️ Requires login)\n  \"接下来需要登录你的淘宝账号才能加入购物车，\n   请确认是否继续？\"\n  - If yes: proceed with browser automation\n  - If no: provide manual instructions\n  ↓\nStep 5: Order Generation (Requires login)\n  - Add to cart\n  - Apply coupons\n  - Select address\n  - Calculate final price\n  - Generate order preview\n  ↓\nStep 6: Handoff (User-controlled)\n  \"订单已准备好，请检查：\n   [订单详情摘要]\n   \n   👉 请手动完成支付：\n   1. 打开淘宝 App\n   2. 进入购物车\n   3. 点击结算\n   4. 确认地址和优惠券\n   5. 提交订单并支付\"\n```\n\n### Browser Automation Rules\n\n**Always announce before action:**\n- \"正在搜索...\"\n- \"正在打开商品页面...\"\n- \"正在读取用户评价...\"\n- \"正在加入购物车...\"\n\n**Snapshot key information:**\n- Product title, price, promotions\n- Store type badge\n- Rating and review count\n- Available variants\n- Coupon information\n- Delivery estimate\n\n**Stop conditions:**\n- Before any payment screen\n- When CAPTCHA appears (hand to user)\n- When login is required (ask first)\n- When price differs significantly from expected\n\n### Login Handling\n\n**Option A: User already logged in (Chrome profile)**\n```\nopenclaw browser navigates to Taobao\nIf user profile has active session → proceed\nIf session expired → prompt user to login manually first\n```\n\n**Option B: User provides login via secure method**\n```\n⚠️ Never ask for password in chat\nGuide user tologin in their browser first\nThen agent takes over with active session\n```\n\n**Option C: Manual mode (no login)**\n```\nAgent provides:\n- Exact search keywords\n- Product links\n- Coupon codes to apply\n- Step-by-step manual instructions\nUser executes manually\n```\n\n## Quality Bar\n\n### Do:\n- Focus on seller verification and store type\n- Explain trade-offs clearly (variety vs. consistency)\n- Stay honest about not doing account-state operations without login\n- Always announce before browser actions\n- Snapshot key information for user review\n- Stop before any payment screen\n- Ask for confirmation before login-required actions\n\n### Do Not:\n- Pretend to log in without user consent\n- Claim to retrieve orders, coupons, or account data without login\n- Store cookies or user data without explicit permission\n- Present heuristics as guaranteed outcomes\n- Complete payment for user\n- Overstep into checkout without user confirmation\n\n## Common Traps\n\n- **Assuming low price = best deal** → Check seller rating first\n- **Ignoring store type** → 天猫 vs. personal store matters\n- **Not checking reviews** → Photos reveal quality issues\n- **Missing coupon stacking** → Multiple discounts available\n- **Buying from new sellers** → Higher risk, less protection\n- **Forgetting 运费险** → Cheap insurance for returns\n- **Rushing without comparison** → Same item, different prices\n- **Agent overstepping** → Never complete payment for user\n\n## Taobao vs Competitors\n\n| Factor | Taobao | JD | Tmall |\n|--------|--------|-----|--------|\n| Variety | Best | Good | Good |\n| Price | Lowest | Higher | Medium |\n| Authenticity | Varies | Best | Good |\n| Shipping | Varies | Fastest | Good |\n| Electronics | Riskier | Best | Good |\n| Fashion | Best choice | Limited | Good |\n\n**When to Choose Taobao:**\n- Fashion and accessories\n- Hard-to-find items\n- Price-sensitive purchases\n- Custom/handmade goods\n- When variety matters most\n\n## Related Skills\n\nInstall with `clawhub install <slug>` if user confirms:\n- `jingdong` - JD.com shopping\n- `jd-shopping` - Alternative JD guide\n- `tianmao` - Tmall shopping\n- `pdd` - Pinduoduo shopping\n- `vip` - VIP flash sales\n\n## Feedback\n\n- If useful: `clawhub star taobao-shopping`\n- Stay updated: `clawhub sync`\n\nFile v2.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn77zzg9p845zanvy6vrf76k7d81mcnm\",\n  \"slug\": \"taobao-shopping\",\n  \"version\": \"2.1.0\",\n  \"publishedAt\": 1781664864235\n}\n\nFile v2.1.0:references/marketplace-guide.md\n\n# Marketplace Guide\n\nTaobao is strong for:\n- variety\n- style breadth\n- price range\n\nWatch for:\n- seller quality variation\n- variant confusion\n- image-vs-reality mismatch\n\nFile v2.1.0:references/output-patterns.md\n\n# Output Patterns\n\n## Best Use\nState when Taobao is a good fit.\n\n## Why\nExplain the fit.\n\n## Caveats\nMention seller and quality risks.\n\n## Final Advice\nGive a practical buying suggestion.\n\nFile v2.1.0:skills/taobao-shopping/references/browser-workflow.md\n\n# Browser Workflow for Taobao Shopping\n\nThis document describes the browser automation workflow for Taobao shopping operations.\n\n## Overview\n\nTaobao browser automation follows a phased approach with clear boundaries between agent-assisted operations and user-controlled checkout.\n\n## Authentication Requirements\n\n| Operation | Login Required | Notes |\n|-----------|----------------|-------|\n| Search | No | Public search results |\n| Browse categories | No | Public category pages |\n| View product details | No | Public product pages |\n| Read reviews | No | Public review data |\n| Compare prices | No | Public price information |\n| Add to cart | Yes | Requires active session |\n| View cart | Yes | Requires active session |\n| Apply coupons | Yes | Requires active session |\n| Generate order preview | Yes | Requires active session |\n| Payment | Blocked | User only |\n\n## Browser Extraction Order\n\nWhen extracting data from Taobao pages, follow this priority:\n\n1. **商品标题** - Product title\n2. **价格信息** - 原价, 券后价, 到手价\n3. **店铺类型** - 天猫/企业店/个人店\n4. **店铺评分** - 描述相符, 服务态度, 物流服务\n5. **销量** - 月销/总销量\n6. **优惠券** - 店铺券, 平台券\n7. **满减活动** - 满X减Y\n8. **规格选项** - 颜色, 尺寸, 版本\n9. **用户评价** - 好评率, 追评, 晒图\n10. **物流信息** - 发货地, 运费, 预计送达\n\n## Workflow Phases\n\n### Phase 1: Discovery\n\n**Actions:**\n- Navigate to taobao.com\n- Enter search query\n- Apply filters (price, rating, brand)\n- Sort results (sales, price, rating)\n- Extract top 3-5 product summaries\n\n**Key Data Points:**\n- Product title\n- Main image\n- Price range\n- Sales volume\n- Store type badge\n- Rating score\n\n### Phase 2: Selection\n\n**Actions:**\n- Open selected product page\n- Extract detailed specifications\n- Read user reviews (first 10-20)\n- Check variant options\n- Verify seller information\n\n**Key Data Points:**\n- Full product description\n- All available variants\n- Detailed pricing (with coupons)\n- Store rating breakdown\n- Return policy\n- Shipping cost\n\n### Phase 3: Cart & Pre-Order\n\n**Actions:**\n- Confirm login status\n- Select product variant\n- Add to cart\n- Navigate to cart page\n- Review cart contents\n- Check available coupons\n- Select delivery address\n- Calculate final price\n\n**Key Data Points:**\n- Cart subtotal\n- Applied coupons\n- Shipping fee\n- Final price\n- Delivery address\n- Estimated delivery date\n\n### Phase 4: Checkout Handoff\n\n**Actions:**\n- Present complete order summary\n- Stop before payment screen\n- Provide manual checkout instructions\n\n**Never:**\n- Enter payment information\n- Click final submit button\n- Complete transaction\n\n## Error Handling\n\n### CAPTCHA\nWhen CAPTCHA appears:\n1. Stop automation\n2. Notify user\n3. Provide manual instructions\n\n### Login Required\nWhen login is required:\n1. Ask user for confirmation\n2. Provide login options\n3. Never ask for password in chat\n\n### Price Mismatch\nWhen displayed price differs from expected:\n1. Flag the discrepancy\n2. Re-extract pricing\n3. Confirm with user before proceeding\n\n### Out of Stock\nWhen selected variant is out of stock:\n1. Notify user\n2. Show available alternatives\n3. Wait for user selection\n\n## Security Guidelines\n\n1. **Never store credentials**\n2. **Never complete payment**\n3. **Always ask before login-required actions**\n4. **Snapshot key data for verification**\n5. **Provide clear handoff instructions**\n\n## Example Session\n\n```\nUser: 帮我买蓝牙耳机\n\nAgent: \n1. Searches \"蓝牙耳机 天猫\" on Taobao\n2. Filters by Tmall stores, sorts by sales\n3. Extracts top 3 options with prices\n4. Presents comparison table\n\nUser: 选第二个\n\nAgent:\n1. Opens product detail page\n2. Extracts specifications and reviews\n3. Shows variant options (color, model)\n4. Calculates final price with coupons\n\nUser: 买白色的\n\nAgent:\n1. \"需要登录淘宝账号才能加入购物车，是否继续？\"\n\nUser: 好的\n\nAgent:\n1. Checks login status\n2. Selects white variant\n3. Adds to cart\n4. Applies available coupons\n5. Generates order preview\n6. \"订单已准备好，请手动完成支付...\"\n```\n\n## Related Files\n\n- `marketplace-guide.md` - Taobao marketplace characteristics\n- `output-patterns.md` - Response formatting guidelines\n\nFile v2.1.0:skills/taobao-shopping/references/marketplace-guide.md\n\n# Marketplace Guide\n\nTaobao is strong for:\n- variety\n- style breadth\n- price range\n\nWatch for:\n- seller quality variation\n- variant confusion\n- image-vs-reality mismatch\n\nFile v2.1.0:skills/taobao-shopping/references/output-patterns.md\n\n# Output Patterns\n\n## Best Use\nState when Taobao is a good fit.\n\n## Why\nExplain the fit.\n\n## Caveats\nMention seller and quality risks.\n\n## Final Advice\nGive a practical buying suggestion.\n\nFile v2.1.0:skill-card.md\n\n## Description: <br>\nTaobao shopping assistant. Input a Taobao product name or link; output store credibility, SKU differences, review risks, price/promotion caveats, and buy/wait/avoid advice. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[harrylabsj](https://clawhub.ai/user/harrylabsj) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users use this skill to evaluate Taobao products from public marketplace signals, including seller credibility, SKU differences, review risks, pricing caveats, and practical buy/wait/avoid guidance. It is intended for shopping decision support, not account access or payment execution. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Bundled nested files describe logged-in cart, coupon, address, and order-preview workflows even though the public skill file presents an advisory-only boundary. <br>\nMitigation: Before deployment, remove or quarantine the nested logged-in workflow files, or configure the agent to follow only the top-level advisory skill boundary. <br>\nRisk: An active Taobao session could expose personal checkout details or allow cart-state changes. <br>\nMitigation: Do not use logged-in sessions with this skill unless the user explicitly accepts that scope; keep payment, final order submission, credentials, CAPTCHA, and identity checks user-controlled. <br>\n\n\n## Reference(s): <br>\n- [Taobao Shopping on ClawHub](https://clawhub.ai/harrylabsj/taobao-shopping) <br>\n- [Marketplace Guide](references/marketplace-guide.md) <br>\n- [Output Patterns](references/output-patterns.md) <br>\n- [Browser Workflow Risk Evidence](skills/taobao-shopping/references/browser-workflow.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, guidance] <br>\n**Output Format:** [Markdown decision support with concise recommendations] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Uses public or user-provided shopping information; final price, stock, delivery, coupons, and after-sales terms should be rechecked by the user before purchase.] <br>\n\n## Skill Version(s): <br>\n2.1.0 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v2.1.0:skills/taobao-shopping/clawhub.json\n\n{\n  \"name\": \"taobao-shopping\",\n  \"version\": \"2.0.0\",\n  \"description\": \"淘宝购物助手 - 支持搜索、比价、看评论、加购物车，支付环节留给用户\",\n  \"keywords\": [\"taobao\", \"淘宝\", \"shopping\", \"e-commerce\"],\n  \"author\": \"harrylabsj\",\n  \"license\": \"MIT\",\n  \"repository\": \"https://github.com/harrylabsj/taobao-shopping\"\n}\n\nFile v2.1.0:skills/taobao-shopping/package.json\n\n{\n  \"name\": \"taobao-shopping-skill\",\n  \"version\": \"2.0.0\",\n  \"description\": \"淘宝购物助手 Skill - 支持搜索、比价、看评论、加购物车\",\n  \"main\": \"SKILL.md\",\n  \"keywords\": [\n    \"taobao\",\n    \"淘宝\",\n    \"shopping\",\n    \"e-commerce\",\n    \"openclaw\",\n    \"skill\"\n  ],\n  \"author\": \"harrylabsj\",\n  \"license\": \"MIT\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/harrylabsj/taobao-shopping.git\"\n  },\n  \"homepage\": \"https://clawhub.ai/harrylabsj/taobao-shopping\"\n}\n\nArchive v1.3.0: 11 files, 12550 bytes\n\nFiles: references/marketplace-guide.md (170b), references/output-patterns.md (187b), skill-card.md (2676b), SKILL.md (2672b), skills/taobao-shopping/clawhub.json (344b), skills/taobao-shopping/package.json (503b), skills/taobao-shopping/references/browser-workflow.md (4260b), skills/taobao-shopping/references/marketplace-guide.md (170b), skills/taobao-shopping/references/output-patterns.md (188b), skills/taobao-shopping/SKILL.md (10670b), _meta.json (134b)\n\nFile v1.3.0:SKILL.md\n\n---\nname: taobao-shopping\ndescription: \"Taobao shopping assistant. Input a Taobao product name or link; output store credibility, SKU differences, review risks, price/promotion caveats, and buy/wait/avoid advice. Safe boundary: no login, no order submission, no payment, and no account-state actions.\"\n---\n# Taobao Shopping\n\nHelp users make better Taobao shopping decisions from public marketplace signals.\n\nThis is a low-sensitivity public skill. It focuses on public decision support and does not perform login, account access, cookie handling, order retrieval, coupon claiming, local database persistence, or browser automation runtime actions.\n\nUse this skill when the user wants public buying, ordering, sourcing, or booking guidance rather than account-state operations.\n\nFor live page inspection, account pages, checkout-state actions, or real-time retrieval that depends on login, switch to browser-based workflows instead of pretending this skill performs those actions directly.\n\nRead these references as needed:\n- `references/marketplace-guide.md` for supporting guidance\n- `references/output-patterns.md` for supporting guidance\n\n## Workflow\n\n1. Identify the user's shopping, ordering, or booking need.\n   - Accept a product, merchant, ride, store, or booking scenario.\n   - If the request is too broad, ask one short clarifying question.\n\n2. Focus on public decision-relevant factors.\n   - Prefer category fit, trust, timing, fees, conditions, and scenario fit over superficial labels.\n\n3. Explain trade-offs.\n   - Say why the strongest option fits.\n   - Mention meaningful risks or caveats.\n\n4. Give practical next-step advice.\n   - Tell the user what to verify before paying or placing an order.\n\n## Output\n\nUse this structure unless the user asks for something shorter:\n\n### Best Option\nState the strongest current choice.\n\n### Why\nList the main reasons.\n\n### Caveats\nList meaningful concerns or trade-offs.\n\n### Final Advice\nGive a direct practical suggestion.\n\n## Quality bar\n\nDo:\n- focus on public decision support\n- explain trade-offs clearly\n- stay honest about not doing account-state operations\n\nDo not:\n- pretend to log in\n- claim to retrieve orders, coupons, or account data\n- store cookies or user data\n- present heuristics as guaranteed outcomes\n\n\n## P1 Safety Boundaries\n\n- Do not enter credentials, SMS codes, passwords, CAPTCHA, identity checks, addresses, or payment details for the user.\n- Do not submit orders, click checkout, click final confirmation, or initiate payment.\n- Use browser-visible or user-provided information only; final price, stock, delivery, coupons, and after-sales terms must be rechecked by the user before purchase.\n\nFile v1.3.0:skills/taobao-shopping/SKILL.md\n\n---\nname: taobao-shopping\nslug: taobao-shopping\nversion: 2.0.0\nhomepage: https://clawic.com/skills/taobao-shopping\ndescription: Navigate Taobao (淘宝) with expert shopping strategies, seller verification, and browser-based product search, reviews, price comparison, and cart operations. Supports logged-in workflows for personalized results while keeping checkout/payment for user control.\nmetadata:\n  clawdbot:\n    emoji: \"🛍️\"\n    requires:\n      bins: []\n    os: [\"linux\", \"darwin\", \"win32\"]\n---\n\n# Taobao Shopping\n\nHelp users shop smarter on Taobao with expert strategies, seller verification, and browser-based product search, reviews, price comparison, and cart operations.\n\n## When to Use\n\nUser wants to shop on Taobao (淘宝), China's largest C2C/B2C marketplace. Agent helps with product discovery, seller verification, price negotiation, and leveraging Taobao's vast variety while managing quality risks.\n\n## Quick Reference\n\n| Topic | File |\n|-------|------|\n| Marketplace guide | `references/marketplace-guide.md` |\n| Output patterns | `references/output-patterns.md` |\n| Browser workflow | `references/browser-workflow.md` |\n\n## Capabilities\n\n### Supported Operations (v2.0)\n\n| Operation | Auth Required | Description |\n|-----------|---------------|-------------|\n| **Search** | Optional | Search products, filter by price/rating/brand |\n| **Browse** | Optional | Browse categories, trending items, recommendations |\n| **Product Detail** | Optional | View specs, images, pricing, promotions |\n| **Compare** | Optional | Compare prices across sellers/variants |\n| **Add to Cart** | ✅ Required | Add items to shopping cart |\n| **View Cart** | ✅ Required | Review cart contents, quantities |\n| **Apply Coupons** | ✅ Required | Check and apply available coupons |\n| **Generate Order Preview** | ✅ Required | Fill address, select shipping, calculate final price |\n| **Payment** | ❌ Blocked | User must complete payment manually |\n\n**Important**: All checkout operations stop before payment. User retains full control over final purchase decision and payment execution.\n\n## Workflow\n\n### Phase 1: Discovery (Agent-Assisted)\n1. **Search** - Agent searches Taobao for target product\n2. **Filter & Sort** - Apply filters (price range, rating, brand, 天猫优先)\n3. **Compare** - Agent compares top 3-5 options across sellers\n4. **Reviews** - Agent reads user reviews, extracts common pros/cons\n5. **Price Analysis** - Agent checks current price, promotions, coupon availability\n\n### Phase 2: Selection (Agent-Assisted)\n1. **Product Detail** - Agent opens selected product page\n2. **Variant Selection** - Confirm color, size, configuration\n3. **Seller Verification** - Confirm 天猫/企业店/个人店 status\n4. **Final Price Check** - Calculate 到手价 after all discounts\n\n### Phase 3: Cart & Pre-Order (Agent-Assisted with Login)\n1. **Add to Cart** - Agent adds item to cart (requires login)\n2. **Cart Review** - Agent shows cart contents, quantities, subtotal\n3. **Coupon Application** - Agent checks and applies best coupons\n4. **Address Selection** - Agent confirms delivery address\n5. **Shipping Options** - Agent shows available delivery methods\n6. **Order Summary** - Agent generates complete order preview\n\n### Phase 4: Checkout (User-Controlled)\n1. **Handoff** - Agent presents final order details\n2. **User Review** - User confirms all details are correct\n3. **Payment** - ⚠️ **User completes payment manually**\n4. **Confirmation** - User shares order confirmation with agent if desired\n\n**Agent Boundary**: Stops at Phase 3. Never executes payment or final order submission.\n\n## Core Rules\n\n### 1. Taobao Store Types Decoded\n\nUnderstanding Taobao's ecosystem is crucial for safe shopping:\n\n| Store Badge | Chinese | Trust Level | Best For |\n|-------------|---------|-------------|----------|\n| **Tmall** | 天猫/天猫旗舰店 | ⭐⭐⭐⭐⭐ | Brand authenticity |\n| **Tmall Global** | 天猫国际 | ⭐⭐⭐⭐⭐ | Imported goods |\n| **Enterprise** | 企业店铺 | ⭐⭐⭐⭐☆ | Verified business |\n| **Personal Crown** | 个人皇冠店 | ⭐⭐⭐☆☆ | Experienced seller |\n| **Personal Regular** | 普通个人店 | ⭐⭐☆☆☆ | Price hunting |\n\n**Priority Order:** 天猫旗舰店 > 天猫 > 企业店 > 皇冠店 > 普通店\n\n### 2. The Tmall Advantage\n\n**Why Tmall Wins:**\n\n| Factor | Tmall | Personal Store |\n|--------|-------|----------------|\n| Authenticity | Brand direct/authorized | Varies |\n| Return service | 7-day no-reason | Varies by seller |\n| Customer service | Brand handles | Seller handles |\n| Fees transparency | Clear | May have hidden costs |\n| Price protection | Available | Rare |\n\n**识别天猫:**\n- Look for \"天猫\" red badge\n- URL contains \"tmall.com\"\n- Higher commission = better service\n\n### 3. Price Optimization\n\n**Understanding Taobao Pricing:**\n\n| Price Label | Meaning | Strategy |\n|-------------|---------|----------|\n| **原价** | Listed \"original\" | Often inflated |\n| **券后价** | After coupon | Real baseline |\n| **满减价** | After threshold discount | Stack with coupons |\n| **到手价** | Final after all discounts | Real cost |\n\n**Best Deal Formula:**\n```\nFinal Price = 标价 - 店铺券 - 平台券 - 满减 - 淘金币 - 支付优惠\n```\n\n**Timing for Best Prices:**\n- **618** (June 1-18) - Mid-year mega sale\n- **双11** (Nov 11) - Singles Day\n- **双12** (Dec 12) - Year-end clearance\n- **38女王节** (Mar 8) - Women's categories\n- **99划算节** (Sep 9) - Autumn sale\n\n### 4. Seller Verification\n\n**Check Before Buying:**\n\n| Metric | Green Flag | Red Flag |\n|--------|------------|----------|\n| **Rating** | 4.8+ | Below 4.6 |\n| **Reviews** | Recent positive | Old or negative |\n| **Sales** | High volume | Zero or low |\n| **Store Age** | 3+ years | New store |\n| **Return Rate** | Low | High |\n| **Description** | Detailed | Vague/copy-paste |\n\n### 5. Returns & Protection\n\n**Taobao Consumer Protection:**\n\n| Feature | Coverage | Notes |\n|---------|----------|-------|\n| 7-day return | Most items | Unused, tags on |\n| 运费险 | Optional | Buy for return shipping |\n| 假一赔四 | Tmall | Counterfeit protection |\n| 极速退款 | High credit | Instant refund |\n| 晚到必赔 | Some items | Late delivery compensation |\n\n## Agent Execution Guide\n\n### When User Says \"帮我买...\"\n\nFollow this escalation path:\n\n```\nUser: \"帮我买 iPhone 手机壳\"\n  ↓\nStep 1: Confirm Intent\n  \"我来帮你搜索 iPhone 手机壳，对比选项，加入购物车。\n   最后需要你确认订单并完成支付。可以吗？\"\n  ↓\nStep 2: Discovery Phase (No login required)\n  - Search Taobao for \"iPhone 手机壳\"\n  - Filter: 天猫优先, sort by sales\n  - Compare top 3 options\n  - Read reviews for each\n  - Present comparison table\n  ↓\nStep 3: Selection Phase (No login required)\n  - User picks one option\n  - Agent opens product page\n  - Confirm variant/specs\n  - Show final price\n  ↓\nStep 4: Cart Phase (⚠️ Requires login)\n  \"接下来需要登录你的淘宝账号才能加入购物车，\n   请确认是否继续？\"\n  - If yes: proceed with browser automation\n  - If no: provide manual instructions\n  ↓\nStep 5: Order Generation (Requires login)\n  - Add to cart\n  - Apply coupons\n  - Select address\n  - Calculate final price\n  - Generate order preview\n  ↓\nStep 6: Handoff (User-controlled)\n  \"订单已准备好，请检查：\n   [订单详情摘要]\n   \n   👉 请手动完成支付：\n   1. 打开淘宝 App\n   2. 进入购物车\n   3. 点击结算\n   4. 确认地址和优惠券\n   5. 提交订单并支付\"\n```\n\n### Browser Automation Rules\n\n**Always announce before action:**\n- \"正在搜索...\"\n- \"正在打开商品页面...\"\n- \"正在读取用户评价...\"\n- \"正在加入购物车...\"\n\n**Snapshot key information:**\n- Product title, price, promotions\n- Store type badge\n- Rating and review count\n- Available variants\n- Coupon information\n- Delivery estimate\n\n**Stop conditions:**\n- Before any payment screen\n- When CAPTCHA appears (hand to user)\n- When login is required (ask first)\n- When price differs significantly from expected\n\n### Login Handling\n\n**Option A: User already logged in (Chrome profile)**\n```\nopenclaw browser navigates to Taobao\nIf user profile has active session → proceed\nIf session expired → prompt user to login manually first\n```\n\n**Option B: User provides login via secure method**\n```\n⚠️ Never ask for password in chat\nGuide user tologin in their browser first\nThen agent takes over with active session\n```\n\n**Option C: Manual mode (no login)**\n```\nAgent provides:\n- Exact search keywords\n- Product links\n- Coupon codes to apply\n- Step-by-step manual instructions\nUser executes manually\n```\n\n## Quality Bar\n\n### Do:\n- Focus on seller verification and store type\n- Explain trade-offs clearly (variety vs. consistency)\n- Stay honest about not doing account-state operations without login\n- Always announce before browser actions\n- Snapshot key information for user review\n- Stop before any payment screen\n- Ask for confirmation before login-required actions\n\n### Do Not:\n- Pretend to log in without user consent\n- Claim to retrieve orders, coupons, or account data without login\n- Store cookies or user data without explicit permission\n- Present heuristics as guaranteed outcomes\n- Complete payment for user\n- Overstep into checkout without user confirmation\n\n## Common Traps\n\n- **Assuming low price = best deal** → Check seller rating first\n- **Ignoring store type** → 天猫 vs. personal store matters\n- **Not checking reviews** → Photos reveal quality issues\n- **Missing coupon stacking** → Multiple discounts available\n- **Buying from new sellers** → Higher risk, less protection\n- **Forgetting 运费险** → Cheap insurance for returns\n- **Rushing without comparison** → Same item, different prices\n- **Agent overstepping** → Never complete payment for user\n\n## Taobao vs Competitors\n\n| Factor | Taobao | JD | Tmall |\n|--------|--------|-----|--------|\n| Variety | Best | Good | Good |\n| Price | Lowest | Higher | Medium |\n| Authenticity | Varies | Best | Good |\n| Shipping | Varies | Fastest | Good |\n| Electronics | Riskier | Best | Good |\n| Fashion | Best choice | Limited | Good |\n\n**When to Choose Taobao:**\n- Fashion and accessories\n- Hard-to-find items\n- Price-sensitive purchases\n- Custom/handmade goods\n- When variety matters most\n\n## Related Skills\n\nInstall with `clawhub install <slug>` if user confirms:\n- `jingdong` - JD.com shopping\n- `jd-shopping` - Alternative JD guide\n- `tianmao` - Tmall shopping\n- `pdd` - Pinduoduo shopping\n- `vip` - VIP flash sales\n\n## Feedback\n\n- If useful: `clawhub star taobao-shopping`\n- Stay updated: `clawhub sync`\n\nFile v1.3.0:_meta.json\n\n{\n  \"ownerId\": \"kn77zzg9p845zanvy6vrf76k7d81mcnm\",\n  \"slug\": \"taobao-shopping\",\n  \"version\": \"1.3.0\",\n  \"publishedAt\": 1781664152916\n}\n\nFile v1.3.0:references/marketplace-guide.md\n\n# Marketplace Guide\n\nTaobao is strong for:\n- variety\n- style breadth\n- price range\n\nWatch for:\n- seller quality variation\n- variant confusion\n- image-vs-reality mismatch\n\nFile v1.3.0:references/output-patterns.md\n\n# Output Patterns\n\n## Best Use\nState when Taobao is a good fit.\n\n## Why\nExplain the fit.\n\n## Caveats\nMention seller and quality risks.\n\n## Final Advice\nGive a practical buying suggestion.\n\nFile v1.3.0:skills/taobao-shopping/references/browser-workflow.md\n\n# Browser Workflow for Taobao Shopping\n\nThis document describes the browser automation workflow for Taobao shopping operations.\n\n## Overview\n\nTaobao browser automation follows a phased approach with clear boundaries between agent-assisted operations and user-controlled checkout.\n\n## Authentication Requirements\n\n| Operation | Login Required | Notes |\n|-----------|----------------|-------|\n| Search | No | Public search results |\n| Browse categories | No | Public category pages |\n| View product details | No | Public product pages |\n| Read reviews | No | Public review data |\n| Compare prices | No | Public price information |\n| Add to cart | Yes | Requires active session |\n| View cart | Yes | Requires active session |\n| Apply coupons | Yes | Requires active session |\n| Generate order preview | Yes | Requires active session |\n| Payment | Blocked | User only |\n\n## Browser Extraction Order\n\nWhen extracting data from Taobao pages, follow this priority:\n\n1. **商品标题** - Product title\n2. **价格信息** - 原价, 券后价, 到手价\n3. **店铺类型** - 天猫/企业店/个人店\n4. **店铺评分** - 描述相符, 服务态度, 物流服务\n5. **销量** - 月销/总销量\n6. **优惠券** - 店铺券, 平台券\n7. **满减活动** - 满X减Y\n8. **规格选项** - 颜色, 尺寸, 版本\n9. **用户评价** - 好评率, 追评, 晒图\n10. **物流信息** - 发货地, 运费, 预计送达\n\n## Workflow Phases\n\n### Phase 1: Discovery\n\n**Actions:**\n- Navigate to taobao.com\n- Enter search query\n- Apply filters (price, rating, brand)\n- Sort results (sales, price, rating)\n- Extract top 3-5 product summaries\n\n**Key Data Points:**\n- Product title\n- Main image\n- Price range\n- Sales volume\n- Store type badge\n- Rating score\n\n### Phase 2: Selection\n\n**Actions:**\n- Open selected product page\n- Extract detailed specifications\n- Read user reviews (first 10-20)\n- Check variant options\n- Verify seller information\n\n**Key Data Points:**\n- Full product description\n- All available variants\n- Detailed pricing (with coupons)\n- Store rating breakdown\n- Return policy\n- Shipping cost\n\n### Phase 3: Cart & Pre-Order\n\n**Actions:**\n- Confirm login status\n- Select product variant\n- Add to cart\n- Navigate to cart page\n- Review cart contents\n- Check available coupons\n- Select delivery address\n- Calculate final price\n\n**Key Data Points:**\n- Cart subtotal\n- Applied coupons\n- Shipping fee\n- Final price\n- Delivery address\n- Estimated delivery date\n\n### Phase 4: Checkout Handoff\n\n**Actions:**\n- Present complete order summary\n- Stop before payment screen\n- Provide manual checkout instructions\n\n**Never:**\n- Enter payment information\n- Click final submit button\n- Complete transaction\n\n## Error Handling\n\n### CAPTCHA\nWhen CAPTCHA appears:\n1. Stop automation\n2. Notify user\n3. Provide manual instructions\n\n### Login Required\nWhen login is required:\n1. Ask user for confirmation\n2. Provide login options\n3. Never ask for password in chat\n\n### Price Mismatch\nWhen displayed price differs from expected:\n1. Flag the discrepancy\n2. Re-extract pricing\n3. Confirm with user before proceeding\n\n### Out of Stock\nWhen selected variant is out of stock:\n1. Notify user\n2. Show available alternatives\n3. Wait for user selection\n\n## Security Guidelines\n\n1. **Never store credentials**\n2. **Never complete payment**\n3. **Always ask before login-required actions**\n4. **Snapshot key data for verification**\n5. **Provide clear handoff instructions**\n\n## Example Session\n\n```\nUser: 帮我买蓝牙耳机\n\nAgent: \n1. Searches \"蓝牙耳机 天猫\" on Taobao\n2. Filters by Tmall stores, sorts by sales\n3. Extracts top 3 options with prices\n4. Presents comparison table\n\nUser: 选第二个\n\nAgent:\n1. Opens product detail page\n2. Extracts specifications and reviews\n3. Shows variant options (color, model)\n4. Calculates final price with coupons\n\nUser: 买白色的\n\nAgent:\n1. \"需要登录淘宝账号才能加入购物车，是否继续？\"\n\nUser: 好的\n\nAgent:\n1. Checks login status\n2. Selects white variant\n3. Adds to cart\n4. Applies available coupons\n5. Generates order preview\n6. \"订单已准备好，请手动完成支付...\"\n```\n\n## Related Files\n\n- `marketplace-guide.md` - Taobao marketplace characteristics\n- `output-patterns.md` - Response formatting guidelines\n\nFile v1.3.0:skills/taobao-shopping/references/marketplace-guide.md\n\n# Marketplace Guide\n\nTaobao is strong for:\n- variety\n- style breadth\n- price range\n\nWatch for:\n- seller quality variation\n- variant confusion\n- image-vs-reality mismatch\n\nFile v1.3.0:skills/taobao-shopping/references/output-patterns.md\n\n# Output Patterns\n\n## Best Use\nState when Taobao is a good fit.\n\n## Why\nExplain the fit.\n\n## Caveats\nMention seller and quality risks.\n\n## Final Advice\nGive a practical buying suggestion.\n\nFile v1.3.0:skill-card.md\n\n## Description: <br>\nTaobao Shopping helps users evaluate public Taobao listings by comparing store credibility, SKU differences, review risks, prices, promotions, and buy/wait/avoid guidance while keeping login, checkout, and payment outside the skill. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[harrylabsj](https://clawhub.ai/user/harrylabsj) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal shoppers use this skill for public Taobao buying guidance, including seller credibility checks, SKU and review comparison, price and promotion caveats, and practical buy/wait/avoid advice before making their own purchase decision. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Artifact files conflict on whether the skill may operate inside a logged-in Taobao session or change cart and checkout-preparation state. <br>\nMitigation: Use the skill for public Taobao research by default; require clear per-action user confirmation before any logged-in shopping-session action. <br>\nRisk: Shopping guidance can involve credentials, addresses, coupons, cart changes, checkout pages, order previews, and payment-adjacent decisions. <br>\nMitigation: Do not let the agent handle credentials, addresses, coupons, cart changes, checkout pages, order previews, order submission, or payment without explicit user control and confirmation. <br>\nRisk: Taobao listing details such as final price, stock, delivery, coupons, seller quality, and after-sales terms can be incomplete or change before purchase. <br>\nMitigation: Have the user recheck all purchase-critical details on Taobao before paying or placing an order. <br>\n\n\n## Reference(s): <br>\n- [ClawHub Skill Page](https://clawhub.ai/harrylabsj/taobao-shopping) <br>\n- [Marketplace Guide](references/marketplace-guide.md) <br>\n- [Output Patterns](references/output-patterns.md) <br>\n- [Browser Workflow Evidence](skills/taobao-shopping/references/browser-workflow.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, guidance] <br>\n**Output Format:** [Markdown] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May include concise comparisons, caveats, and final buying advice; does not produce payment actions.] <br>\n\n## Skill Version(s): <br>\n1.3.0 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.3.0:skills/taobao-shopping/clawhub.json\n\n{\n  \"name\": \"taobao-shopping\",\n  \"version\": \"2.0.0\",\n  \"description\": \"淘宝购物助手 - 支持搜索、比价、看评论、加购物车，支付环节留给用户\",\n  \"keywords\": [\"taobao\", \"淘宝\", \"shopping\", \"e-commerce\"],\n  \"author\": \"harrylabsj\",\n  \"license\": \"MIT\",\n  \"repository\": \"https://github.com/harrylabsj/taobao-shopping\"\n}\n\nFile v1.3.0:skills/taobao-shopping/package.json\n\n{\n  \"name\": \"taobao-shopping-skill\",\n  \"version\": \"2.0.0\",\n  \"description\": \"淘宝购物助手 Skill - 支持搜索、比价、看评论、加购物车\",\n  \"main\": \"SKILL.md\",\n  \"keywords\": [\n    \"taobao\",\n    \"淘宝\",\n    \"shopping\",\n    \"e-commerce\",\n    \"openclaw\",\n    \"skill\"\n  ],\n  \"author\": \"harrylabsj\",\n  \"license\": \"MIT\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/harrylabsj/taobao-shopping.git\"\n  },\n  \"homepage\": \"https://clawhub.ai/harrylabsj/taobao-shopping\"\n}\n\nArchive v2.0.2: 4 files, 3879 bytes\n\nFiles: README.md (1260b), references/output-patterns.md (514b), SKILL.md (4319b), _meta.json (134b)\n\nFile v2.0.2:SKILL.md\n\n---\nname: taobao-shopping\ndescription: Help users decide how to shop on Taobao from public marketplace characteristics, then guide Taobao product search, seller comparison, store-type judgment, variant checks, and buying-risk evaluation using browser-visible evidence only. Use when the user wants to 买淘宝、看同款、逛店铺、比店、判断靠不靠谱、比较卖家、看是否值得在淘宝下单, or needs Taobao-specific shopping guidance without pretending to do hidden API access or payment automation.\n---\n\n# Taobao Shopping\n\nTaobao station-native shopping decision skill.\n\nThis skill is for users who already know they want to evaluate Taobao itself, not compare across JD, PDD, and Vipshop. For cross-platform same-item price decisions, use `taobao-competitor-analyzer` instead.\n\nWhat makes this skill useful:\n- It helps users judge whether Taobao is a good fit for the purchase.\n- It focuses on seller quality, store type, variant clarity, and listing risk.\n- It gives a direct buy / compare more / avoid recommendation instead of generic browsing help.\n\n## When To Use\n\nUse this skill when the user is effectively asking:\n- 这东西在淘宝上怎么买更靠谱\n- 淘宝这家店能不能买\n- 同款太多了怎么选\n- 帮我看淘宝店铺和商品风险\n- 淘宝买这个值不值\n\nUse `taobao-competitor-analyzer` instead when the user wants:\n- 京东 / 拼多多 / 唯品会 cross-platform comparison\n- lowest visible comparable price across platforms\n- whether to switch away from Taobao\n\n## Commerce Matrix\n\nThis skill is the Taobao station-native node in the shopping matrix.\n\nPrefer nearby skills when the task shifts:\n- `taobao-competitor-analyzer` for cross-platform same-item comparison\n- `alibaba-shopping` when the user first needs to choose between Taobao, Tmall, and 1688\n- `tianmao` when official flagship and authenticity matter more than marketplace variety\n\n## Workflow\n\n1. Clarify the target product or listing.\n2. Normalize the product name or listing title.\n3. Search Taobao using browser-visible flows only.\n4. Compare the strongest 2-5 candidate listings.\n5. Judge seller trust, variant clarity, service promises, and visible pricing conditions.\n6. End with a direct recommendation:\n   - `可直接优先看`\n   - `建议继续比店`\n   - `高风险，暂不建议`\n\n## Browser Rules\n\n- Stay in browser-visible pages only.\n- Do not use hidden APIs, app-only endpoints, or unofficial scrapers.\n- Prefer visible search results, item detail pages, and seller/store pages.\n- If results are noisy, narrow by brand, spec, quantity, version, and store type.\n- Do not fabricate prices, ratings, or guarantees.\n\n## What To Compare\n\nFor each candidate listing, collect when visible:\n- title\n- displayed price\n- variant/specification\n- store name\n- store type or badges\n- sales volume or recent order count\n- visible rating / service / logistics signals\n- return / shipping / authenticity wording\n- URL\n- short note on why it looks strong or risky\n\n## Decision Rules\n\nPrioritize these questions:\n\n1. Is the listing clearly the right product and variant\n2. Is the seller/store trustworthy enough\n3. Is the price believable for the product class\n4. Are shipping, returns, and after-sales acceptable\n5. Is the listing better than nearby Taobao alternatives\n\nRed flags:\n- title is vague or overloaded with unrelated keywords\n- variant/specification is unclear\n- store signals are weak or inconsistent\n- price is suspiciously low without explanation\n- product page depends on confusing coupon tricks or hidden conditions\n\n## Output Format\n\nReturn a short decision block first:\n\n- `推荐动作`\n- `最值得看的店/商品`\n- `主要原因`\n- `风险点`\n\nThen give a compact comparison table:\n\n| 候选 | 价格 | 规格 | 店铺 | 信号 | 判断 |\n|---|---:|---|---|---|---|\n| A | ¥... | ... | ... | ... | ... |\n\nThen end with:\n- `下一步建议`\n- `如果要继续比店，优先看什么`\n\n## Positioning\n\nThis skill is part of a shopping decision matrix:\n- `taobao-shopping`: Taobao station-native buying guidance\n- `taobao-competitor-analyzer`: cross-platform same-item comparison\n- `tianmao`: official flagship / authenticity-first buying\n- `pdd-shopping`: low-price / group-buy / subsidy-first buying\n- `jd-shopping`: trust, self-operated, and fulfillment-first buying\n\nFile v2.0.2:README.md\n\n# Taobao Shopping\n\nTaobao station-native shopping decision skill.\n\nThis skill is for users who want help shopping on Taobao itself:\n- choosing between many similar listings\n- judging whether a seller looks reliable\n- spotting vague variants and suspicious low prices\n- deciding whether to buy now, compare more, or avoid\n\nIt is intentionally different from `taobao-competitor-analyzer`.\n\n## Use This For\n\n- `帮我看这个淘宝商品靠不靠谱`\n- `淘宝同款太多了怎么选`\n- `这家淘宝店能买吗`\n- `帮我筛几个淘宝候选商品`\n- `淘宝买这个值不值`\n\n## Do Not Use This For\n\n- JD / PDD / Vipshop cross-platform price checks\n- same-item comparison across marketplaces\n- deciding whether to switch away from Taobao\n\nUse `taobao-competitor-analyzer` for those.\n\n## What It Does\n\n- evaluates Taobao listings using visible browser evidence\n- compares 2-5 candidate listings inside Taobao\n- checks seller and store quality signals\n- reviews variant clarity and pricing plausibility\n- returns a direct recommendation instead of generic browsing notes\n\n## Output Style\n\nThe skill is optimized to return:\n- a recommendation action\n- the strongest candidate listing\n- key risk points\n- what to compare next if the user should keep browsing\n\nFile v2.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn77zzg9p845zanvy6vrf76k7d81mcnm\",\n  \"slug\": \"taobao-shopping\",\n  \"version\": \"2.0.2\",\n  \"publishedAt\": 1774951238351\n}\n\nFile v2.0.2:references/output-patterns.md\n\n# Output Patterns\n\n## Recommendation\n\nState one of:\n- 可直接优先看\n- 建议继续比店\n- 高风险，暂不建议\n\n## Best Candidate\n\nName the strongest listing or seller and why it stands out.\n\n## Risks\n\nMention the most meaningful Taobao-specific concerns:\n- variant ambiguity\n- weak seller signals\n- suspiciously low price\n- confusing pricing conditions\n\n## Next Step\n\nTell the user what to do next inside Taobao:\n- compare more sellers\n- verify spec\n- open store page\n- avoid and search a narrower term\n\nArchive v2.0.1: 4 files, 3756 bytes\n\nFiles: README.md (1260b), references/output-patterns.md (514b), SKILL.md (3936b), _meta.json (134b)\n\nFile v2.0.1:SKILL.md\n\n---\nname: taobao-shopping\ndescription: Help users decide how to shop on Taobao from public marketplace characteristics, then guide Taobao product search, seller comparison, store-type judgment, variant checks, and buying-risk evaluation using browser-visible evidence only. Use when the user wants to 买淘宝、看同款、逛店铺、比店、判断靠不靠谱、比较卖家、看是否值得在淘宝下单, or needs Taobao-specific shopping guidance without pretending to do hidden API access or payment automation.\n---\n\n# Taobao Shopping\n\nTaobao station-native shopping decision skill.\n\nThis skill is for users who already know they want to evaluate Taobao itself, not compare across JD, PDD, and Vipshop. For cross-platform same-item price decisions, use `taobao-competitor-analyzer` instead.\n\nWhat makes this skill useful:\n- It helps users judge whether Taobao is a good fit for the purchase.\n- It focuses on seller quality, store type, variant clarity, and listing risk.\n- It gives a direct buy / compare more / avoid recommendation instead of generic browsing help.\n\n## When To Use\n\nUse this skill when the user is effectively asking:\n- 这东西在淘宝上怎么买更靠谱\n- 淘宝这家店能不能买\n- 同款太多了怎么选\n- 帮我看淘宝店铺和商品风险\n- 淘宝买这个值不值\n\nUse `taobao-competitor-analyzer` instead when the user wants:\n- 京东 / 拼多多 / 唯品会 cross-platform comparison\n- lowest visible comparable price across platforms\n- whether to switch away from Taobao\n\n## Workflow\n\n1. Clarify the target product or listing.\n2. Normalize the product name or listing title.\n3. Search Taobao using browser-visible flows only.\n4. Compare the strongest 2-5 candidate listings.\n5. Judge seller trust, variant clarity, service promises, and visible pricing conditions.\n6. End with a direct recommendation:\n   - `可直接优先看`\n   - `建议继续比店`\n   - `高风险，暂不建议`\n\n## Browser Rules\n\n- Stay in browser-visible pages only.\n- Do not use hidden APIs, app-only endpoints, or unofficial scrapers.\n- Prefer visible search results, item detail pages, and seller/store pages.\n- If results are noisy, narrow by brand, spec, quantity, version, and store type.\n- Do not fabricate prices, ratings, or guarantees.\n\n## What To Compare\n\nFor each candidate listing, collect when visible:\n- title\n- displayed price\n- variant/specification\n- store name\n- store type or badges\n- sales volume or recent order count\n- visible rating / service / logistics signals\n- return / shipping / authenticity wording\n- URL\n- short note on why it looks strong or risky\n\n## Decision Rules\n\nPrioritize these questions:\n\n1. Is the listing clearly the right product and variant\n2. Is the seller/store trustworthy enough\n3. Is the price believable for the product class\n4. Are shipping, returns, and after-sales acceptable\n5. Is the listing better than nearby Taobao alternatives\n\nRed flags:\n- title is vague or overloaded with unrelated keywords\n- variant/specification is unclear\n- store signals are weak or inconsistent\n- price is suspiciously low without explanation\n- product page depends on confusing coupon tricks or hidden conditions\n\n## Output Format\n\nReturn a short decision block first:\n\n- `推荐动作`\n- `最值得看的店/商品`\n- `主要原因`\n- `风险点`\n\nThen give a compact comparison table:\n\n| 候选 | 价格 | 规格 | 店铺 | 信号 | 判断 |\n|---|---:|---|---|---|---|\n| A | ¥... | ... | ... | ... | ... |\n\nThen end with:\n- `下一步建议`\n- `如果要继续比店，优先看什么`\n\n## Positioning\n\nThis skill is part of a shopping decision matrix:\n- `taobao-shopping`: Taobao station-native buying guidance\n- `taobao-competitor-analyzer`: cross-platform same-item comparison\n- `tianmao`: official flagship / authenticity-first buying\n- `pdd-shopping`: low-price / group-buy / subsidy-first buying\n- `jd-shopping`: trust, self-operated, and fulfillment-first buying\n\nFile v2.0.1:README.md\n\n# Taobao Shopping\n\nTaobao station-native shopping decision skill.\n\nThis skill is for users who want help shopping on Taobao itself:\n- choosing between many similar listings\n- judging whether a seller looks reliable\n- spotting vague variants and suspicious low prices\n- deciding whether to buy now, compare more, or avoid\n\nIt is intentionally different from `taobao-competitor-analyzer`.\n\n## Use This For\n\n- `帮我看这个淘宝商品靠不靠谱`\n- `淘宝同款太多了怎么选`\n- `这家淘宝店能买吗`\n- `帮我筛几个淘宝候选商品`\n- `淘宝买这个值不值`\n\n## Do Not Use This For\n\n- JD / PDD / Vipshop cross-platform price checks\n- same-item comparison across marketplaces\n- deciding whether to switch away from Taobao\n\nUse `taobao-competitor-analyzer` for those.\n\n## What It Does\n\n- evaluates Taobao listings using visible browser evidence\n- compares 2-5 candidate listings inside Taobao\n- checks seller and store quality signals\n- reviews variant clarity and pricing plausibility\n- returns a direct recommendation instead of generic browsing notes\n\n## Output Style\n\nThe skill is optimized to return:\n- a recommendation action\n- the strongest candidate listing\n- key risk points\n- what to compare next if the user should keep browsing\n\nFile v2.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn77zzg9p845zanvy6vrf76k7d81mcnm\",\n  \"slug\": \"taobao-shopping\",\n  \"version\": \"2.0.1\",\n  \"publishedAt\": 1774950959622\n}\n\nFile v2.0.1:references/output-patterns.md\n\n# Output Patterns\n\n## Recommendation\n\nState one of:\n- 可直接优先看\n- 建议继续比店\n- 高风险，暂不建议\n\n## Best Candidate\n\nName the strongest listing or seller and why it stands out.\n\n## Risks\n\nMention the most meaningful Taobao-specific concerns:\n- variant ambiguity\n- weak seller signals\n- suspiciously low price\n- confusing pricing conditions\n\n## Next Step\n\nTell the user what to do next inside Taobao:\n- compare more sellers\n- verify spec\n- open store page\n- avoid and search a narrower term\n\nArchive v2.0.0: 562 files, 1104435 bytes\n\nFiles: agents/code/AGENTS.md (7874b), agents/code/BOOTSTRAP.md (1470b), agents/code/HEARTBEAT.md (168b), agents/code/IDENTITY.md (636b), agents/code/SOUL.md (1673b), agents/code/TOOLS.md (860b), agents/code/USER.md (477b), agents/code/xiangqin/package.json (786b), agents/code/xiangqin/references/fields-and-workflows.md (1164b), agents/code/xiangqin/references/privacy-and-boundaries.md (938b), agents/code/xiangqin/scripts/cli.js (7226b), agents/code/xiangqin/scripts/index.js (17716b), agents/code/xiangqin/SKILL.md (3206b), agents/code/xiangqin/test.js (3000b), agents/design/orchestrator/architecture.md (19398b), agents/design/orchestrator/clawhub.json (790b), agents/design/orchestrator/config/default.yaml (740b), agents/design/orchestrator/package-lock.json (150111b), agents/design/orchestrator/package.json (756b), agents/design/orchestrator/scripts/build.sh (176b), agents/design/orchestrator/scripts/install.sh (340b), agents/design/orchestrator/SKILL.md (14016b), agents/design/orchestrator/src/core/ExecutionMonitor.ts (7394b), agents/design/orchestrator/src/core/index.ts (325b), agents/design/orchestrator/src/core/ResourcePlanner.ts (4973b), agents/design/orchestrator/src/core/ResultAggregator.ts (7417b), agents/design/orchestrator/src/core/TaskParser.ts (5474b), agents/design/orchestrator/src/core/TaskScheduler.ts (6918b), agents/design/orchestrator/src/index.ts (3295b), agents/design/orchestrator/src/Orchestrator.ts (6505b), agents/design/orchestrator/src/types/index.ts (1817b), agents/design/orchestrator/src/utils/config.ts (3219b), agents/design/orchestrator/src/utils/errors.ts (2114b), agents/design/orchestrator/src/utils/id.ts (560b), agents/design/orchestrator/src/utils/index.ts (340b), agents/design/orchestrator/src/utils/logger.ts (911b), agents/design/orchestrator/tsconfig.json (461b), agents/design/orchestrator/workflow-detailed.md (16271b), agents/design/orchestrator/workflow.md (15395b), agents/design/skill-assessment/assess.sh (8398b), agents/design/skill-assessment/clawhub.json (819b), agents/design/skill-assessment/config.yaml (3894b), agents/design/skill-assessment/evaluators/code_analyzer.sh (5333b), agents/design/skill-assessment/evaluators/config_validator.sh (3741b), agents/design/skill-assessment/evaluators/doc_checker.sh (2776b), agents/design/skill-assessment/evaluators/maintenance_checker.sh (5150b), agents/design/skill-assessment/examples/config.example.yaml (3038b), agents/design/skill-assessment/examples/sample_report.md (4231b), agents/design/skill-assessment/install.sh (3317b), agents/design/skill-assessment/SKILL.md (7326b), agents/main/AGENTS.md (7874b), agents/main/BOOTSTRAP.md (1470b), agents/main/HEARTBEAT.md (168b), agents/main/IDENTITY.md (636b), agents/main/publish/family-study-coach/references/data-schema.md (2406b), agents/main/publish/family-study-coach/references/intents-and-prompts.md (974b), agents/main/publish/family-study-coach/references/output-template.md (1191b), agents/main/publish/family-study-coach/references/safety-boundaries.md (832b), agents/main/publish/family-study-coach/scripts/common.py (1390b), agents/main/publish/family-study-coach/scripts/plan_generator.py (1426b), agents/main/publish/family-study-coach/scripts/report_summary.py (712b), agents/main/publish/family-study-coach/scripts/review_tracker.py (1105b), agents/main/publish/family-study-coach/scripts/student_manager.py (1181b), agents/main/publish/family-study-coach/scripts/task_status.py (774b), agents/main/publish/family-study-coach/SKILL.md (3156b), agents/main/publish/fridge-to-table-weekly-plan/references/data-schema.md (2146b), agents/main/publish/fridge-to-table-weekly-plan/references/intents-and-prompts.md (934b), agents/main/publish/fridge-to-table-weekly-plan/references/output-template.md (1342b), agents/main/publish/fridge-to-table-weekly-plan/references/safety-boundaries.md (854b), agents/main/publish/fridge-to-table-weekly-plan/scripts/common.py (1470b), agents/main/publish/fridge-to-table-weekly-plan/scripts/feedback_logger.py (862b), agents/main/publish/fridge-to-table-weekly-plan/scripts/household_manager.py (914b), agents/main/publish/fridge-to-table-weekly-plan/scripts/inventory_manager.py (1039b), agents/main/publish/fridge-to-table-weekly-plan/scripts/shopping_list.py (899b), agents/main/publish/fridge-to-table-weekly-plan/scripts/weekly_planner.py (1223b), agents/main/publish/fridge-to-table-weekly-plan/SKILL.md (2950b), agents/main/publish/nutrition-balance-tracker/references/intents-and-prompts.md (3471b), agents/main/publish/nutrition-balance-tracker/references/nutrition-targets.md (1414b), agents/main/publish/nutrition-balance-tracker/references/output-template.md (1504b), agents/main/publish/nutrition-balance-tracker/references/safety-boundaries.md (1155b) (+162 more)\n\nFile v2.0.0:agents/code/xiangqin/SKILL.md\n\n---\nname: xiangqin\ndescription: 帮助用户管理相亲资料、查找匹配对象、生成开场白与聊天话题、记录互动进展，并提供约会与安全提醒。用于用户明确提到相亲、找对象、脱单、婚恋匹配、开场白、聊天建议、约会建议、接触记录、相亲安全等场景。\n---\n\n# Xiangqin\n\n使用这个 skill 时，先把它当作一个本地辅助工具，而不是婚恋平台后端。\n\n## 执行原则\n\n- 先确认用户的目标：是完善资料、找匹配、生成话术、记录进展，还是看安全提醒。\n- 明确告知这是本地原型工具，结果仅供参考，不应被表述为“平台级智能推荐”。\n- 涉及隐私时，默认最小暴露；不要主动输出手机号、微信号、住址等敏感信息。\n- 涉及见面、转账、投资、借钱、裸聊、索要验证码等情况时，优先输出安全提醒。\n- 不要声称已经实现加密、照片水印、实名核验等未实现能力。\n\n## 可用能力\n\n- 创建和查看个人资料\n- 根据已有资料做基础匹配排序\n- 生成开场白\n- 推荐聊天话题\n- 推荐约会形式\n- 记录接触历史\n- 输出相亲安全提醒\n\n## 运行方式\n\n优先使用 CLI：\n\n```bash\nnode scripts/cli.js safety\nnode scripts/cli.js 资料 <用户ID>\nnode scripts/cli.js 资料 <用户ID> 创建 '<资料JSON>'\nnode scripts/cli.js 匹配 <用户ID> [数量]\nnode scripts/cli.js 开场白 <用户ID> <对方ID>\nnode scripts/cli.js 话题 [initial|middle|advanced]\nnode scripts/cli.js 约会 [城市]\nnode scripts/cli.js 记录 <用户ID> <对方ID> <内容>\nnode scripts/cli.js 历史 <用户ID> <对方ID>\n```\n\n## 资料输入建议\n\n创建资料时，至少包含：\n\n- nickname\n- gender\n- birthYear\n- height\n- location\n- education\n- occupation\n\n可选字段：\n\n- income\n- hometown\n- hobbies\n- values\n- selfDescription\n- ageRange\n- locationPreference\n- educationPreference\n- otherRequirements\n\n字段说明和建议流程详见 `references/fields-and-workflows.md`\n\n## 数据边界\n\n- 当前数据保存在本地目录 `~/.openclaw/skills-data/xiangqin/`\n- 当前版本使用本地 JSON 文件保存数据\n- 当前版本**未实现**字段级加密、照片水印、实名核验、联系方式交换控制\n- 因此输出时要避免夸大安全能力，并提醒用户谨慎提供敏感信息\n- 隐私与输出边界详见 `references/privacy-and-boundaries.md`\n\n## 结果表述要求\n\n- 把匹配结果表述为“基础规则匹配结果”或“本地推荐结果”\n- 不要把分数说成真实成功率\n- 若样本不足，要明确说“当前资料库候选人不足”\n- 若资料不完整，先建议补齐资料再做推荐\n\n## 安全要求\n\n遇到以下场景时，优先提醒风险：\n\n- 第一次见面要求去私密空间\n- 很快借钱、带投资、带博彩、带虚拟币\n- 拒绝视频却急于推进关系\n- 索要身份证、银行卡、验证码\n- 诱导裸聊、屏幕共享、下载可疑 App\n\n必要时直接运行：\n\n```bash\nnode scripts/cli.js safety\n```\n\n## 测试\n\n运行最小测试：\n\n```bash\nnode test.js\n```\n\n测试应覆盖：\n\n- 创建资料\n- 查看资料\n- 双人匹配\n- 开场白生成\n- 接触记录\n- 安全提醒\n\nFile v2.0.0:agents/design/orchestrator/SKILL.md\n\n---\nname: orchestrator\ndescription: \"智能任务编排器 - 发现、组合和调度 skills 来完成复杂任务。不需要本地代码，通过协调其他 agents 和 skills 实现目标。Use when you have a complex task that requires multiple skills, need to break down a goal into subtasks, or want to find the best combination of skills to achieve an objective.\"\nversion: 0.1.0\nauthor: OpenClaw Team\nlicense: MIT\ntags:\n  - orchestration\n  - multi-agent\n  - workflow\n  - automation\ntrigger: |\n  当用户提出复杂任务需要跨多个技能协作时触发，例如：\n  - \"帮我生成一份市场分析报告\"\n  - \"从多个来源收集数据并整理成表格\"\n  - \"自动处理文件并发送邮件\"\n  或当用户明确使用 `/orchestrate` 命令时。\n---\n\n# Orchestrator - 智能任务编排器\n\n你的智能项目经理 - 不亲自写代码，但知道谁能帮你完成任务。\n\n## 快速开始\n\n### 安装\n```bash\n# 通过 clawhub 安装\nclawhub install orchestrator\n\n# 或从源码安装\ngit clone https://github.com/openclaw/orchestrator.git\ncd orchestrator\nnpm install\nnpm run build\n```\n\n### 基本使用\n```bash\n# 1. 分析任务（推荐技能）\norchestrator analyze \"帮我生成一份市场分析报告\"\n\n# 2. 执行任务（自动编排）\norchestrator run \"从多个网站抓取数据并整理成Excel\"\n\n# 3. 查看执行历史\norchestrator history\n\n# 4. 监控任务状态\norchestrator status\n```\n\n### 简单示例\n```bash\n# 示例：自动生成日报\norchestrator run \\\n  \"抓取今日新闻，总结关键点，生成Markdown报告并发送到邮箱\"\n\n# 示例：数据处理流水线\norchestrator run \\\n  \"读取data.csv文件，清洗数据，生成统计图表，输出报告\"\n```\n\n## 核心概念\n\nOrchestrator 是一个**纯编排型** skill，它：\n- ❌ **不执行**具体任务\n- ✅ **发现**合适的 skills\n- ✅ **组合**多个 skills\n- ✅ **调度**执行顺序\n- ✅ **整合**最终结果\n\n## 模块设计\n\nOrchestrator 由五个核心模块组成，每个模块负责编排流程中的特定阶段：\n\n| 模块 | 职责 | 对应文件 |\n|------|------|----------|\n| **TaskParser** | 解析用户自然语言任务，识别意图、实体和约束 | `src/core/TaskParser.ts` |\n| **ResourcePlanner** | 发现可用 skills，评估匹配度，制定执行计划 | `src/core/ResourcePlanner.ts` |\n| **TaskScheduler** | 调度子任务执行顺序，管理依赖关系和并行性 | `src/core/TaskScheduler.ts` |\n| **ExecutionMonitor** | 监控任务执行状态，处理异常和重试 | `src/core/ExecutionMonitor.ts` |\n| **ResultAggregator** | 收集和整合子任务结果，生成最终输出 | `src/core/ResultAggregator.ts` |\n\n### 模块交互流程\n\n```mermaid\nsequenceDiagram\n    participant U as User\n    participant TP as TaskParser\n    participant RP as ResourcePlanner\n    participant TS as TaskScheduler\n    participant EM as ExecutionMonitor\n    participant RA as ResultAggregator\n    participant S as Skills\n    \n    U->>TP: 提交任务描述\n    TP->>TP: 解析任务意图和约束\n    TP->>RP: 传递结构化任务\n    RP->>RP: 发现可用skills\n    RP->>TS: 生成执行计划\n    TS->>EM: 调度子任务\n    EM->>S: 调用技能执行\n    S-->>EM: 返回结果\n    EM->>RA: 收集结果\n    RA->>RA: 整合和格式化\n    RA-->>U: 返回最终结果\n```\n\n## 工作流程\n\n```\n用户任务 → 任务理解 → 技能发现 → 任务分解 → 执行编排 → 结果整合 → 最终输出\n```\n\n### 1. 任务理解 (Task Understanding)\n- 解析用户自然语言描述\n- 识别核心目标\n- 提取约束条件\n- 确定成功标准\n\n### 2. 技能发现 (Skill Discovery)\n- 扫描本地已安装 skills\n- 查询远程 skill 仓库\n- 分析 skill 能力和触发条件\n- 评估匹配度\n\n### 3. 任务分解 (Task Decomposition)\n- 将复杂任务拆分为子任务\n- 识别子任务依赖关系\n- 确定执行顺序\n- 分配执行者\n\n### 4. 执行编排 (Execution Orchestration)\n- 按顺序或并行调用 skills\n- 传递上下文和数据\n- 监控执行状态\n- 处理异常和重试\n\n### 5. 结果整合 (Result Aggregation)\n- 收集各 skill 输出\n- 去重和冲突解决\n- 格式化最终结果\n- 呈现给用户\n\n## 使用场景\n\n### 场景1：复杂报告生成\n```\n用户：帮我生成一份关于 AI 发展趋势的市场分析报告\n\nOrchestrator 执行：\n1. 发现：web-search (搜索资料) + summarize (总结内容) + docx (生成文档)\n2. 分解：搜索 → 总结 → 生成报告\n3. 编排：依次调用各 skill\n4. 整合：合并为完整报告\n```\n\n### 场景2：多步骤数据处理\n```\n用户：从 PDF 提取数据，清洗后生成 Excel 报表\n\nOrchestrator 执行：\n1. 发现：pdf-extract + data-cleaner + excel-generator\n2. 分解：提取 → 清洗 → 生成\n3. 编排：流水线式执行\n4. 整合：输出最终 Excel\n```\n\n### 场景3：自动化工作流\n```\n用户：每天早上自动抓取新闻，总结后发送到我的邮箱\n\nOrchestrator 执行：\n1. 发现：rss-reader + summarizer + email-sender\n2. 分解：读取 → 总结 → 发送\n3. 编排：设置定时任务\n4. 整合：确认工作流配置\n```\n\n## CLI 命令\n\nOrchestrator 提供完整的命令行界面，支持多种任务编排操作。\n\n### 基础命令\n\n```bash\n# 分析任务并推荐 skills（不执行）\norchestrator analyze \"生成一份关于AI伦理的报告\"\n# 输出：推荐技能列表和执行计划\n\n# 自动执行完整流程\norchestrator run \"从CSV文件提取数据并生成可视化图表\"\n# 输出：执行结果或文件路径\n\n# 查看执行计划（预览不执行）\norchestrator plan \"抓取新闻并发送每日摘要到邮箱\"\n# 输出：详细执行步骤和时间估算\n\n# 列出所有可用 skills\norchestrator skills\n# 列出本地 skills\norchestrator skills --local\n# 列出远程仓库 skills\norchestrator skills --remote\n\n# 查看任务执行历史\norchestrator history\n# 查看最近10个任务\norchestrator history --limit 10\n# 查看特定状态的任务\norchestrator history --status failed\n```\n\n### 高级命令\n\n```bash\n# 手动指定 skills 组合执行\norchestrator compose --skills \"web-search,summarize,docx\" \"研究AI发展趋势\"\n\n# 保存成功的工作流为模板\norchestrator save-template \"daily-news\" \"抓取新闻并发送摘要\"\n\n# 使用已保存的模板执行\norchestrator run-template \"daily-news\"\n\n# 查看已保存的模板列表\norchestrator templates\n\n# 调试模式（显示详细执行过程）\norchestrator run --debug \"复杂数据处理任务\"\n\n# 监控正在执行的任务\norchestrator status [task-id]\n# 如果没有指定task-id，显示所有运行中任务\n\n# 取消正在执行的任务\norchestrator cancel <task-id>\n\n# 导出任务执行报告\norchestrator export-report <task-id> --format json\n```\n\n### 命令参数详解\n\n| 参数 | 说明 | 示例 |\n|------|------|------|\n| `--local` | 仅操作本地 skills | `orchestrator skills --local` |\n| `--remote` | 查询远程 skill 仓库 | `orchestrator skills --remote` |\n| `--debug` | 启用调试输出 | `orchestrator run --debug \"任务\"` |\n| `--dry-run` | 模拟执行，不实际调用 skills | `orchestrator run --dry-run \"任务\"` |\n| `--timeout` | 设置任务超时时间（秒） | `orchestrator run --timeout 600 \"任务\"` |\n| `--output` | 指定输出格式/文件 | `orchestrator run --output report.md \"任务\"` |\n| `--parallel` | 设置最大并行数 | `orchestrator run --parallel 3 \"任务\"` |\n\n### 环境变量\n\n```bash\n# 配置 skill 搜索路径\nexport ORCHESTRATOR_SKILL_PATH=\"~/.openclaw/skills:~/.clawhub/skills\"\n\n# 设置默认输出格式\nexport ORCHESTRATOR_OUTPUT_FORMAT=\"markdown\"\n\n# 启用详细日志\nexport ORCHESTRATOR_LOG_LEVEL=\"debug\"\n\n# 配置远程仓库地址\nexport ORCHESTRATOR_REMOTE_REGISTRY=\"https://clawhub.ai\"\n```\n\n## 配置\n\nOrchestrator 支持通过配置文件和环境变量进行自定义配置。\n\n### 配置文件位置\n\n1. **全局配置**：`/etc/orchestrator/config.yaml`\n2. **用户配置**：`~/.config/orchestrator/config.yaml`\n3. **项目配置**：`./.orchestrator/config.yaml`\n4. **环境变量**：以 `ORCHESTRATOR_` 开头\n\n配置文件按优先级从高到低加载：环境变量 > 项目配置 > 用户配置 > 全局配置。\n\n### 配置示例\n\n```yaml\n# orchestrator/config.yaml\n\n# 任务执行限制\nmaxConcurrentTasks: 10      # 最大并发任务数\ndefaultTimeout: 300000      # 默认超时时间（毫秒）\nretryAttempts: 3            # 失败重试次数\n\n# Agent 配置\nagents:\n  - type: design\n    name: \"设计 Agent\"\n    capabilities:\n      - research\n      - design\n      - planning\n      - analysis\n    maxConcurrentTasks: 3\n    \n  - type: code\n    name: \"代码 Agent\"\n    capabilities:\n      - coding\n      - debugging\n      - testing\n      - implementation\n    maxConcurrentTasks: 5\n    \n  - type: office\n    name: \"办公 Agent\"\n    capabilities:\n      - documentation\n      - writing\n      - formatting\n      - communication\n    maxConcurrentTasks: 2\n\n# 技能发现配置\nskillDiscovery:\n  localPaths:\n    - \"~/.openclaw/skills\"\n    - \"~/.clawhub/skills\"\n  remoteRegistries:\n    - \"https://clawhub.ai\"\n  cacheTTL: 3600            # 技能缓存时间（秒）\n\n# 执行策略\nexecution:\n  maxParallel: 5            # 最大并行技能数\n  dependencyCheck: true     # 启用依赖检查\n  autoRetry: true           # 自动重试失败任务\n\n# 日志配置\nlogging:\n  level: \"info\"             # debug, info, warn, error\n  format: \"json\"            # json, text\n  output: \"file\"            # file, console, both\n  filePath: \"~/.orchestrator/logs/orchestrator.log\"\n  \n# 输出配置\noutput:\n  defaultFormat: \"markdown\" # markdown, json, text, html\n  saveIntermediate: true    # 保存中间结果\n  intermediatePath: \"~/.orchestrator/intermediate\"\n```\n\n### 环境变量覆盖\n\n```bash\n# 覆盖配置文件中的设置\nexport ORCHESTRATOR_MAX_CONCURRENT_TASKS=5\nexport ORCHESTRATOR_DEFAULT_TIMEOUT=600000\nexport ORCHESTRATOR_LOGGING_LEVEL=debug\nexport ORCHESTRATOR_SKILL_DISCOVERY_LOCAL_PATHS=\"~/.openclaw/skills:/opt/skills\"\n```\n\n## 工作原理\n\n### Skill 匹配算法\n\n1. **关键词匹配**：提取任务关键词，匹配 skill 描述\n2. **能力标签**：skills 标记能力标签（如：搜索、分析、生成）\n3. **历史学习**：根据过往成功经验优化匹配\n4. **人工反馈**：用户确认或修正推荐结果\n\n### 执行策略\n\n| 策略 | 说明 | 示例 |\n|-----|------|------|\n| **顺序执行** | 按依赖顺序依次执行 | A → B → C |\n| **并行执行** | 无依赖的任务同时执行 | A+B+C 同时 |\n| **条件执行** | 根据结果决定下一步 | if A then B else C |\n| **循环执行** | 重复执行直到满足条件 | while not done |\n\n## 示例对话\n\n### 示例1：简单任务\n```\n用户：帮我搜索 OpenAI 的最新新闻并总结\n\nOrchestrator:\n🔍 分析任务...\n   需要：搜索 + 总结\n\n📦 发现 skills:\n   ✓ web-search (搜索网页)\n   ✓ summarize (文本总结)\n\n📋 执行计划:\n   1. web-search: \"OpenAI 最新新闻\"\n   2. summarize: 搜索结果\n\n🚀 开始执行...\n   [执行中...]\n\n✅ 完成！\n   [总结内容...]\n```\n\n### 示例2：复杂任务\n```\n用户：分析竞争对手的产品，生成对比报告\n\nOrchestrator:\n🔍 分析任务...\n   需要：搜索 + 数据提取 + 分析 + 报告生成\n\n📦 发现 skills:\n   ✓ web-search (搜索竞品信息)\n   ✓ pdf-extract (提取 PDF 资料)\n   ✓ data-analyzer (数据分析)\n   ✓ docx-generator (生成 Word 报告)\n\n📋 执行计划:\n   并行阶段1:\n     - web-search: \"竞品A 产品特性\"\n     - web-search: \"竞品B 产品特性\"\n   \n   阶段2:\n     - data-analyzer: 对比分析\n   \n   阶段3:\n     - docx-generator: 生成报告\n\n🚀 开始执行...\n   [执行进度...]\n\n✅ 完成！\n   报告已生成: ~/reports/competitor-analysis.docx\n```\n\n## 最佳实践\n\n1. **明确任务目标**：描述越清晰，匹配越准确\n2. **检查执行计划**：确认推荐的 skills 是否合理\n3. **保存常用模板**：重复任务使用模板加速\n4. **反馈优化结果**：帮助改进匹配算法\n\n## 注意事项\n\n- Orchestrator 本身不执行具体任务，依赖其他 skills\n- 需要确保所需的 skills 已安装或可用\n- 复杂任务可能需要人工确认执行计划\n- 执行时间取决于子任务的复杂度和数量\n\n## 依赖与兼容性\n\n### 必需依赖\n- **Node.js** 18.0 或更高版本\n- **OpenClaw** 环境\n- **其他 skills**：需要至少安装一个技能才能发挥作用\n\n### 推荐配合使用的 skills\n- **数据收集**：`web-search`, `rss-reader`, `pdf-extract`\n- **数据处理**：`data-cleaner`, `data-analyzer`, `excel-generator`\n- **内容创作**：`summarize`, `docx-generator`, `markdown-editor`\n- **通信通知**：`email-sender`, `notification-sender`\n\n### 兼容性\n- 与所有符合 OpenClaw Skill 规范的技能兼容\n- 支持本地技能和远程技能仓库\n- 兼容常见的 agents：design、code、office\n\n## 故障排除\n\n### 常见问题\n\n1. **找不到合适的 skills**\n   - 检查技能是否已安装：`orchestrator skills --local`\n   - 更新技能仓库：`clawhub update`\n   - 安装缺少的技能：`clawhub install <skill-name>`\n\n2. **任务执行失败**\n   - 检查技能依赖是否满足\n   - 查看详细日志：`orchestrator run --debug \"任务\"`\n   - 尝试简化任务描述\n\n3. **性能问题**\n   - 减少并行任务数：设置 `maxConcurrentTasks: 5`\n   - 增加超时时间：设置 `defaultTimeout: 600000`\n   - 清理缓存：删除 `~/.orchestrator/cache`\n\n### 获取帮助\n- 查看详细文档：`orchestrator --help`\n- 查看版本信息：`orchestrator --version`\n- 报告问题：https://github.com/openclaw/orchestrator/issues\n\n## 版本历史\n\n- **v0.1.0** (2026-03-12)：初始版本，基本编排功能\n- 支持任务解析和技能发现\n- 提供基础CLI命令\n- 实现核心编排引擎\n\n## 贡献指南\n\n欢迎贡献代码或提出建议！\n1. Fork 项目仓库\n2. 创建特性分支\n3. 提交更改\n4. 创建 Pull Request\n\nFile v2.0.0:agents/design/skill-assessment/SKILL.md\n\n---\nname: skill-assessment\ndescription: OpenClaw技能质量评估工具 - 四维度静态分析\nopenclaw:\n  requires:\n    bash: \">=4.0\"\n    jq: \">=1.6\"\nversion: 1.0.0\nauthor: 姜海东\nlicense: MIT\nstatus: 功能完整\ncategories: [utilities, development, quality]\n---\n\n\n## 概述\n**skill-assessment** 是一个轻量级静态分析工具，用于评估 OpenClaw 技能的质量。它不执行任何代码，仅通过文件分析和元数据检查，从**文档完整性**、**代码规范性**、**配置友好度**、**维护活跃度**四个维度对技能进行评分，帮助用户快速筛选技能，为开发者提供改进方向。\n\n## 触发场景\n- 当你想了解某个技能的可靠性和质量时\n- 当你在多个相似技能间犹豫不决时  \n- 当你开发完技能，想检查潜在问题和改进点时\n- 当你需要批量评估所有本地技能，找出薄弱环节时\n\n## 安装\n```bash\n# 方法1：从 ClawHub 安装（发布后）\nclawhub install skill-assessment\n\n# 方法2：本地安装（开发阶段）\ncd /path/to/skill-assessment\nln -sf $(pwd) ~/.openclaw/skills/skill-assessment\n```\n\n## 使用方式\n\n### 基本用法\n```bash\n# 评估单个技能\nskill-assess ~/.openclaw/skills/skill-creator\n\n# 评估当前目录下的技能\nskill-assess .\n\n# 批量评估所有本地技能\nskill-assess --all\n\n# 评估并生成JSON格式报告\nskill-assess ~/.openclaw/skills/skill-creator --format json\n\n# 仅显示问题清单\nskill-assess ~/.openclaw/skills/skill-creator --problems-only\n\n# 对比两个技能\nskill-assess --compare skill-creator skill-audit\n```\n\n### 输出示例\n```\n🔍 技能评估报告：skill-creator\n📊 综合评分：★★★★☆ (4.2/5)\n⏱️ 评估用时：12秒\n📁 技能路径：~/.openclaw/skills/skill-creator\n\n维度得分：\n  文档完整性：★★★★☆ (4.0/5)\n  代码规范性：★★★★★ (4.5/5)\n  配置友好度：★★★☆☆ (3.5/5)\n  维护活跃度：★★★★☆ (4.0/5)\n\n⚠️ 发现问题：3个\n✅ 通过检查：21个\n📋 详细报告：~/.openclaw/skills/skill-assessment/reports/skill-creator_2026-03-12.md\n```\n\n## 评估维度\n\n### 1. 文档完整性 (权重30%)\n- **SKILL.md 存在性**：强制检查，缺失则直接0分\n- **必填章节**：name, description, triggers, usage, installation, configuration\n- **示例质量**：示例是否可复制，是否有输入输出说明\n- **配置说明**：默认配置示例，环境变量支持\n\n### 2. 代码规范性 (权重40%)\n- **文件结构**：清晰的目录组织（scripts/, templates/, examples/）\n- **安全风险**：硬编码密钥、危险权限、注入漏洞\n- **错误处理**：`set -e` 或 `try/catch`，友好的错误提示\n- **工具使用**：权限申请合理性，安全边界\n\n### 3. 配置友好度 (权重20%)\n- **默认配置**：合理的默认值，不暴露敏感信息\n- **配置方式**：支持环境变量、配置文件、命令行参数\n- **错误提示**：配置缺失时的明确提示和修复建议\n\n### 4. 维护活跃度 (权重10%)\n- **版本管理**：语义化版本号（如 `1.0.0`）\n- **更新记录**：CHANGELOG.md 或更新说明\n- **最后更新**：3个月内+2分，6个月内+1分，1年内+0.5分\n\n## 评分算法\n```\n总分 = \n  文档完整性得分 × 30% +\n  代码规范性得分 × 40% + \n  配置友好度得分 × 20% +\n  维护活跃度得分 × 10%\n```\n\n**星级转换**：\n- 4.5-5.0: ★★★★★ (优秀)\n- 4.0-4.4: ★★★★☆ (良好)  \n- 3.5-3.9: ★★★☆☆ (中等)\n- 3.0-3.4: ★★☆☆☆ (一般)\n- 2.5-2.9: ★☆☆☆☆ (较差)\n- <2.5: ☆☆☆☆☆ (不推荐)\n\n## 配置选项\n在技能根目录创建 `config.yaml` 或设置环境变量：\n\n```yaml\n# config.yaml\nweights:\n  documentation: 0.3    # 文档完整性权重\n  code_quality: 0.4     # 代码规范性权重\n  config_friendly: 0.2  # 配置友好度权重\n  maintenance: 0.1      # 维护活跃度权重\n\nchecks:\n  enable_security_scan: true     # 启用安全检查\n  enable_performance_check: false # 不启用性能检查（静态分析不包含）\n  min_score_to_warn: 3.0         # 低于此分数显示警告\n\noutput:\n  format: \"markdown\"    # 输出格式：markdown, json, text\n  save_report: true     # 保存详细报告\n  report_dir: \"./reports\" # 报告保存目录\n```\n\n环境变量：\n```bash\nexport SKILL_ASSESS_WEIGHTS='{\"documentation\":0.3,\"code_quality\":0.4}'\nexport SKILL_ASSESS_OUTPUT_FORMAT=json\n```\n\n## 文件结构\n```\nskill-assessment/\n├── SKILL.md                    # 本文档\n├── assess.sh                   # 主评估脚本\n├── config.yaml                 # 默认配置\n├── evaluators/                 # 评估模块\n│   ├── doc_checker.sh          # 文档检查\n│   ├── code_analyzer.sh        # 代码分析\n│   ├── config_validator.sh     # 配置验证\n│   └── maintenance_checker.sh  # 维护状态检查\n├── templates/                  # 报告模板\n│   ├── report.md.j2            # Markdown报告模板\n│   └── summary.txt.j2          # 控制台摘要模板\n├── examples/                   # 示例\n│   ├── sample_report.md        # 示例报告\n│   └── config.example.yaml     # 配置示例\n└── reports/                    # 生成的报告存储\n    └── skill-creator_2026-03-12.md\n```\n\n## 故障排除\n\n### 常见问题\n1. **评估时间过长**\n   - 原因：技能文件过多或包含大文件\n   - 解决：使用 `--exclude` 排除非必要文件，或设置文件大小限制\n\n2. **误报安全问题**\n   - 原因：检查规则过于严格\n   - 解决：调整 `config.yaml` 中的安全检查敏感度，或添加例外规则\n\n3. **缺少依赖工具**\n   - 原因：未安装 jq、yq 等工具\n   - 解决：`brew install jq yq` 或使用包管理器安装\n\n4. **权限问题**\n   - 原因：无法读取技能目录\n   - 解决：检查目录权限，或使用 `sudo`（不推荐）\n\n### 调试模式\n```bash\n# 启用详细日志\nskill-assess ~/.openclaw/skills/skill-creator --verbose\n\n# 查看检查过程\nskill-assess ~/.openclaw/skills/skill-creator --debug\n```\n\n## 开发指南\n\n### 添加新的检查规则\n1. 在 `evaluators/` 目录下创建新的检查脚本\n2. 脚本应输出 JSON 格式的结果：\n   ```json\n   {\n     \"score\": 4.5,\n     \"max_score\": 5,\n     \"issues\": [\"问题描述1\", \"问题描述2\"],\n     \"suggestions\": [\"改进建议1\", \"改进建议2\"]\n   }\n   ```\n3. 在 `assess.sh` 中注册新的检查器\n4. 更新 `config.yaml` 中的权重配置\n\n### 扩展评估维度\n如需添加新的评估维度（如“性能表现”），需要：\n1. 动态测试支持（选项2或3）\n2. 在沙箱中运行技能测试用例\n3. 测量执行时间和资源消耗\n\n## 版本历史\n- **v1.0.0** (2026-03-12): 初始版本，静态分析四维度评估\n- **v1.1.0** (规划中): 添加技能对比功能，集成到 ClawHub\n- **v1.2.0** (规划中): 支持动态基础测试（选项2）\n\n## 相关技能\n- **skill-creator**: 技能创建辅助工具\n- **skill-audit**: 技能安全审计工具  \n- **find-skills**: 技能发现和搜索工具\n\n## 贡献\n欢迎提交 Issue 和 Pull Request：\n1. Fork 本仓库\n2. 创建功能分支\n3. 提交更改\n4. 推送到分支\n5. 创建 Pull Request\n\n## 许可证\nMIT License\n\nFile v2.0.0:agents/main/publish/family-study-coach/SKILL.md\n\n---\nname: family-study-coach\ndescription: Help families plan, track, and review a child’s study rhythm with weekly plans, daily task breakdowns, and lightweight study reviews. Use when the user wants to build a study plan, understand learning blockers, review progress, or get parent-friendly study support. Provides structured guidance, not medical, psychological, or school-official diagnosis.\n---\n\n# Family Study Coach\n\n## Overview\n\nUse this skill to support a family study routine with a low-conflict, structured workflow: clarify the learning goal, break work into manageable daily tasks, record completion, and review what to adjust next. Focus on executable plans and calm parent communication rather than pressure.\n\n## Workflow\n\n### 1. Clarify the situation\nCollect only the key facts first:\n- grade or study stage\n- the one problem the parent most wants to solve\n- whether the issue is “won't start”, “can't do”, or “keeps getting interrupted”\n- what subject or step is most stuck\n\nUse `references/intents-and-prompts.md` for follow-up priority and low-confidence handling.\n\n### 2. Build the student profile\nUse `scripts/student_manager.py` to create or list a learner profile.\nStore grade, subjects, weak subjects, and target summary.\n\n### 3. Create a weekly study plan\nUse `scripts/plan_generator.py` to generate a first-pass weekly plan.\nKeep plans realistic:\n- one main focus at a time\n- default to 30–45 minute blocks\n- include recovery or light review when the schedule is heavy\n\n### 4. Track study tasks and reviews\nUse:\n- `scripts/plan_generator.py` to create tasks\n- `scripts/review_tracker.py` to store day-end reviews\n- `scripts/report_summary.py` to summarize progress and blockers\n\n### 5. Respond with structure and calm tone\nUse `references/output-template.md`.\nAlways include:\n- the current judgment\n- up to 3 priority actions\n- parent-friendly phrasing\n- what to observe and when to review\n\n## Output Rules\n\n- Default to low-pressure support.\n- Do not promise score improvement.\n- Do not diagnose psychological or medical conditions.\n- When confidence is low, say so and give reversible next steps.\n- Prefer “先稳节奏，再加任务” over aggressive overload.\n\n## Resources\n\n### scripts/\n- `student_manager.py`: create and list student profiles\n- `plan_generator.py`: create weekly plans and starter daily tasks\n- `review_tracker.py`: store daily review notes\n- `report_summary.py`: summarize tasks and recent blockers\n- `common.py`: shared local storage helpers\n\n### references/\n- `data-schema.md`: local JSON schema\n- `output-template.md`: response structure\n- `intents-and-prompts.md`: intent and follow-up rules\n\n## Storage Rules\n\nDefault storage root: `~/.family-study-coach/`\n\nFiles:\n- `students.json`\n- `goals.json`\n- `weekly_plans.json`\n- `daily_tasks.json`\n- `reviews.json`\n\n## Safety Boundary\n\nThis skill helps with study planning, family communication, and progress review. It does not replace teachers, school policy, psychological evaluation, or medical judgment. If the user mentions severe emotional distress, self-harm, or persistent sleep and mood problems, recommend professional support.\n\nFile v2.0.0:agents/main/publish/fridge-to-table-weekly-plan/SKILL.md\n\n---\nname: fridge-to-table-weekly-plan\ndescription: Turn current fridge and pantry inventory into a practical weekly family meal plan with low waste, realistic cooking time, and a simple shopping list. Use when the user wants to plan what to cook this week, consume ingredients before they spoil, reduce grocery waste, or generate family-friendly meal ideas from what they already have.\n---\n\n# Fridge To Table Weekly Plan\n\n## Overview\n\nUse this skill to convert real household constraints into a workable weekly menu: what is already in the fridge, what needs to be used first, who is eating, how much time is available, and what minimal shopping is needed. Prioritize execution over perfection.\n\n## Workflow\n\n### 1. Understand household constraints\nAsk only the most important questions first:\n- how many people are eating\n- what ingredients are already available\n- whether the user wants dinner-only or broader meal planning\n- any dietary restrictions, allergies, or strong dislikes\n\n### 2. Set household defaults\nUse `scripts/household_manager.py` to store household profile basics.\n\n### 3. Record inventory\nUse `scripts/inventory_manager.py` to add or list ingredients.\nFocus on:\n- name\n- quantity text\n- category\n- urgency or must-use-first flag\n\n### 4. Generate the weekly plan\nUse `scripts/weekly_planner.py` to create a practical weekly menu.\nPrinciples:\n- consume urgent items first\n- keep workdays simple\n- allow batch cooking and leftovers\n- avoid overcomplicated meals when input is incomplete\n\n### 5. Generate a shopping list\nUse `scripts/shopping_list.py` after a weekly menu exists.\nKeep the list short and utility-first.\n\n## Output Rules\n\n- Start with the planning focus and the most urgent ingredient.\n- Show the week in a compact, day-by-day format.\n- Include ingredient consumption order and minimal shopping guidance.\n- If confidence is low, call it a base version and ask for the missing household data.\n- Do not give medical diet advice.\n- Do not recommend using suspicious or spoiled ingredients.\n\n## Resources\n\n### scripts/\n- `household_manager.py`: manage household constraints\n- `inventory_manager.py`: record and list ingredients\n- `weekly_planner.py`: create a weekly menu from inventory priorities\n- `shopping_list.py`: generate a minimal shopping list\n- `common.py`: shared local storage helpers\n\n### references/\n- `data-schema.md`: local JSON schema\n- `output-template.md`: meal-planning response structure\n- `intents-and-prompts.md`: intent and follow-up rules\n\n## Storage Rules\n\nDefault storage root: `~/.fridge-to-table/`\n\nFiles:\n- `household.json`\n- `inventory.json`\n- `weekly_menus.json`\n- `shopping_lists.json`\n- `feedback.json`\n\n## Safety Boundary\n\nThis skill gives practical household planning help. It is not a substitute for medical nutrition advice, allergy management, infant feeding guidance, or food safety certification. When ingredient safety is uncertain, advise caution and discard questionable items.\n\nFile v2.0.0:agents/main/publish/nutrition-balance-tracker/SKILL.md\n\n---\nname: nutrition-balance-tracker\ndescription: Track daily nutrition intake, hydration, and energy balance against fat-loss, maintenance, or muscle-gain goals. Use when the user wants to log meals, water, or exercise, review daily calories and nutrients, and judge whether protein, carbs, fat, fiber, sodium, sugar, and total energy are balanced. Provides estimates and practical guidance, not medical advice.\n---\n\n# Nutrition Balance Tracker\n\n## Overview\n\nUse this skill to help the user track daily meals, hydration, exercise burn, and overall nutrition balance for fat loss, maintenance, or muscle gain. Keep the interaction lightweight, estimate conservatively, and focus on practical next-step guidance instead of pseudo-medical certainty.\n\nThis skill supports:\n- meal, snack, and drink logging\n- hydration tracking\n- daily energy balance analysis\n- macro and key nutrition checks\n- actionable next-step guidance\n\n## Workflow\n\n### 1. Clarify the evaluation frame\nFirst determine the minimum context needed for a useful answer:\n- user goal: `fat_loss`, `maintain`, or `muscle_gain`\n- whether the user wants a partial-day check or full-day review\n- what has been eaten, drunk, and exercised so far\n\nIf core facts are missing, ask only the 1–3 highest-impact questions first. Use `references/intents-and-prompts.md` for trigger examples, follow-up priority, and low-confidence confirmation strategy.\n\n### 2. \n\nArchive v1.2.0: 4 files, 2041 bytes\n\nFiles: references/marketplace-guide.md (170b), references/output-patterns.md (187b), SKILL.md (2317b), _meta.json (134b)\n\nArchive v1.1.2: 1098 files, 2281143 bytes\n\nFiles: _legacy_pre_agents_2026-03-11T12-13-25-653Z/code/MEMORY.md (965b), _legacy_pre_agents_2026-03-11T12-13-25-653Z/design/MEMORY.md (964b), _legacy_pre_agents_2026-03-11T12-13-25-653Z/office/MEMORY.md (970b), _main_root_legacy_2026-03-11T12-15-48-558Z/AGENTS.md (7869b), _main_root_legacy_2026-03-11T12-15-48-558Z/IDENTITY.md (342b), _main_root_legacy_2026-03-11T12-15-48-558Z/MEMORY.md (7327b), _main_root_legacy_2026-03-11T12-15-48-558Z/SOUL.md (2274b), _main_root_legacy_2026-03-11T12-15-48-558Z/USER.md (691b), ~/Library/Mobile Documents/iCloud~md~obsidian/Documents/openclawhaidong/openclaw/agents/design/day1-10skills-design-cn.md (5387b), AGENT_CHANNEL_FIX.md (1804b), agents/code/AGENTS.md (515b), agents/code/ecommerce-skills/PROJECT_SUMMARY.md (5040b), agents/code/ecommerce-skills/README.md (1765b), agents/code/ecommerce-skills/shared/platform-adapters/base-adapter.js (2270b), agents/code/ecommerce-skills/shared/platform-adapters/index.js (1077b), agents/code/ecommerce-skills/shared/platform-adapters/jd-adapter.js (3842b), agents/code/ecommerce-skills/shared/platform-adapters/taobao-adapter.js (2950b), agents/code/ecommerce-skills/shared/storage/local-store.js (2726b), agents/code/ecommerce-skills/skills/cart-optimizer/cli.js (1902b), agents/code/ecommerce-skills/skills/cart-optimizer/index.js (7361b), agents/code/ecommerce-skills/skills/cart-optimizer/SKILL.md (977b), agents/code/ecommerce-skills/skills/content-generator/index.js (7737b), agents/code/ecommerce-skills/skills/content-generator/SKILL.md (720b), agents/code/ecommerce-skills/skills/group-buy-helper/index.js (7747b), agents/code/ecommerce-skills/skills/group-buy-helper/SKILL.md (637b), agents/code/ecommerce-skills/skills/live-shopping-notes/index.js (6990b), agents/code/ecommerce-skills/skills/live-shopping-notes/SKILL.md (682b), agents/code/ecommerce-skills/skills/logistics-watcher/index.js (5669b), agents/code/ecommerce-skills/skills/logistics-watcher/SKILL.md (930b), agents/code/ecommerce-skills/skills/membership-manager/index.js (5900b), agents/code/ecommerce-skills/skills/membership-manager/SKILL.md (672b), agents/code/ecommerce-skills/skills/price-tracker/cli.js (3692b), agents/code/ecommerce-skills/skills/price-tracker/index.js (10236b), agents/code/ecommerce-skills/skills/price-tracker/package.json (794b), agents/code/ecommerce-skills/skills/price-tracker/SKILL.md (2316b), agents/code/ecommerce-skills/skills/refund-assistant/index.js (7807b), agents/code/ecommerce-skills/skills/refund-assistant/SKILL.md (705b), agents/code/ecommerce-skills/skills/review-aggregator/index.js (6834b), agents/code/ecommerce-skills/skills/review-aggregator/SKILL.md (1567b), agents/code/ecommerce-skills/skills/size-recommender/index.js (6533b), agents/code/ecommerce-skills/skills/size-recommender/SKILL.md (1422b), agents/code/HEARTBEAT.md (168b), agents/code/IDENTITY.md (181b), agents/code/MEMORY.md (1862b), agents/code/memory/2026-03-08-clawhub-publish.md (4948b), agents/code/SOUL.md (1322b), agents/code/TOOLS.md (382b), agents/code/USER.md (691b), agents/design/AGENTS.md (513b), agents/design/day1-10skills-design-cn.md (5387b), agents/design/day1-10skills-design-v2.md (5988b), agents/design/day1-10skills-design.md (6300b), agents/design/HEARTBEAT.md (168b), agents/design/how-to-do/SKILL.md (15210b), agents/design/IDENTITY.md (186b), agents/design/knowledge-system-design.md (14027b), agents/design/MEMORY.md (1730b), agents/design/memory/2026-03-08.md (6584b), agents/design/memory/2026-03-09-feishu-check.md (11950b), agents/design/memory/2026-03-09-skill-security-audit.md (10190b), agents/design/memory/2026-03-09.md (5351b), agents/design/memory/2026-03-10.md (10561b), agents/design/memory/2026-03-11.md (6358b), agents/design/memory/2026-03-12-skill-assessment-release.md (9162b), agents/design/memory/2026-03-12.md (3117b), agents/design/openclaw-companion/SKILL.md (19213b), agents/design/orchestrator/architecture.md (19398b), agents/design/orchestrator/clawhub.json (790b), agents/design/orchestrator/config/default.yaml (740b), agents/design/orchestrator/dist/core/ExecutionMonitor.d.ts (2303b), agents/design/orchestrator/dist/core/ExecutionMonitor.js (7652b), agents/design/orchestrator/dist/core/index.d.ts (336b), agents/design/orchestrator/dist/core/index.js (1196b), agents/design/orchestrator/dist/core/ResourcePlanner.d.ts (1347b), agents/design/orchestrator/dist/core/ResourcePlanner.js (5353b), agents/design/orchestrator/dist/core/ResultAggregator.d.ts (1827b), agents/design/orchestrator/dist/core/ResultAggregator.js (7642b), agents/design/orchestrator/dist/core/TaskParser.d.ts (1304b), agents/design/orchestrator/dist/core/TaskParser.js (5827b), agents/design/orchestrator/dist/core/TaskScheduler.d.ts (1925b) (+698 more)","readmeExcerpt":"Skill: Taobao Shopping Owner: harrylabsj Summary: Taobao shopping decision assistant. Input a Taobao product name, listing, screenshot, or link; evaluate store credibility, Tmall/enterprise/personal seller t... Tags: buying-advice:2.1.1, china:2.1.1, ecommerce:2.1.1, latest:2.1.3, listing-risk:2.1.1, seller-comparison:2.1.1, shopping:2.1.2, shopping-decision:2.1.1, taobao:2.1.2 Version history: v2.1.3 | 2026-07-25T12","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"Final Price = 标价 - 店铺券 - 平台券 - 满减 - 淘金币 - 支付优惠"},{"language":"text","snippet":"User: \"帮我买 iPhone 手机壳\"\n  ↓\nStep 1: Confirm Intent\n  \"我来帮你搜索 iPhone 手机壳，对比选项，核对店铺和规格。\n   登录、加购、结算、提交订单和支付需要你手动完成。\"\n  ↓\nStep 2: Discovery Phase (No login required)\n  - Search Taobao for \"iPhone 手机壳\"\n  - Filter: 天猫优先, sort by sales\n  - Compare top 3 options\n  - Read reviews for each\n  - Present comparison table\n  ↓\nStep 3: Selection Phase (No login required)\n  - User picks one option\n  - Agent opens product page\n  - Confirm variant/specs\n  - Show final price\n  ↓\nStep 4: Handoff (User-controlled)\n  \"我已经整理好下单前检查项：\n   [商品/SKU/店铺/价格/风险摘要]\n   \n   👉 请手动完成：\n   1. 打开淘宝 App\n   2. 核对规格、券后价和库存\n   3. 核对地址、运费、退换和发票/保修\n   4. 自行决定是否加入购物车、结算、提交订单并支付\""},{"language":"text","snippet":"Agent provides:\n- Exact search keywords\n- Product links\n- Visible coupon/promo notes\n- Step-by-step manual instructions\nUser executes manually"},{"language":"text","snippet":"发现 → 对比 → 选择 → 风险核对 → 手动加购/结算/支付"},{"language":"text","snippet":"到手价 = 标价 - 店铺券 - 平台券 - 满减 - 淘金币 - 支付优惠"},{"language":"bash","snippet":"clawhub install taobao-shopping"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: taobao-shopping\nslug: taobao-shopping\nversion: 2.0.0\nhomepage: https://clawic.com/skills/taobao-shopping\ndescription: Navigate Taobao (淘宝) with expert shopping strategies, seller verification, public product search, reviews, price comparison, SKU risk checks, and cart-ready guidance. Safe default: public visible information only; login, address, checkout, order submission, and payment stay user-controlled.\nmetadata:\n  clawdbot:\n    emoji: \"🛍️\"\n    requires:\n      bins: []\n    os: [\"linux\", \"darwin\", \"win32\"]\n---\n\n# Taobao Shopping\n\nHelp users shop smarter on Taobao with expert strategies, seller verification, public product search, reviews, price comparison, SKU risk checks, and cart-ready guidance.\n\n## When to Use\n\nUser wants to shop on Taobao (淘宝), China's largest C2C/B2C marketplace. Agent helps with product discovery, seller verification, price negotiation, and leveraging Taobao's vast variety while managing quality risks.\n\n## Quick Reference\n\n| Topic | File |\n|-------|------|\n| Marketplace guide | `references/marketplace-guide.md` |\n| Output patterns | `references/output-patterns.md` |\n| Browser workflow | `references/browser-workflow.md` |\n\n## Capabilities\n\n### Supported Operations (v2.0)\n\n| Operation | Auth Required | Description |\n|-----------|---------------|-------------|\n| **Search** | Optional | Search products, filter by price/rating/brand |\n| **Browse** | Optional | Browse categories, trending items, recommendations |\n| **Product Detail** | Optional | View specs, images, pricing, promotions |\n| **Compare** | Optional | Compare prices across sellers/variants |\n| **Cart Guidance** | User-controlled | Explain how to add the confirmed SKU manually or stop before changing cart state. |\n| **Visible Coupon Notes** | No | Summarize visible coupon/promo terms; account-only coupons are user-only. |\n| **Address / Checkout / Order Preview** | User-only | Do not select address, enter checkout, submit order, or generate private order state. |\n| **Payment** | User-only | User must complete payment manually. |\n\n**Important**: Default operation stops before login, cart changes, checkout, address selection, order submission, and payment. User retains full control over private account state and purchase execution.\n\n## Workflow\n\n### Phase 1: Discovery (Agent-Assisted)\n1. **Search** - Agent searches Taobao for target product\n2. **Filter & Sort** - Apply filters (price range, rating, brand, 天猫优先)\n3. **Compare** - Agent compares top 3-5 options across sellers\n4. **Reviews** - Agent reads user reviews, extracts common pros/cons\n5. **Price Analysis** - Agent checks current price, promotions, coupon availability\n\n### Phase 2: Selection (Agent-Assisted)\n1. **Product Detail** - Agent opens selected product page\n2. **Variant Selection** - Confirm color, size, configuration\n3. **Seller Verification** - Confirm 天猫/企业店/个人店 status\n4. **Final Price Check** - Calculate 到手价 after all discounts\n\n### Phase 3: User Handoff\n1. **Cart-ready guidance** - Agent su"},{"path":"README.md","content":"# Taobao Shopping Skill v2.0\n\n淘宝购物助手 Skill，支持公开信息下的搜索、比价、看评论、店铺/SKU 风险判断和下单前核对清单。登录、加购、结算、提交订单和支付留给用户控制。\n\n## 功能特性\n\n- 🔍 **商品搜索**：关键词搜索，支持筛选和排序\n- 📖 **商品浏览**：浏览分类、推荐商品\n- 📄 **商品详情**：查看规格、图片、价格、促销\n- 💰 **价格对比**：多店铺/多规格比价\n- 🛒 **购物车指导**：整理确认好的 SKU 和手动加购前核对项\n- 🎫 **优惠信息**：仅记录页面可见的优惠条件，不申请或应用优惠券\n- 📋 **下单前清单**：提示用户手动核对最终到手价、地址、优惠、库存、退换和发票/保修\n\n## 安全边界\n\n| 操作 | Agent | 用户 |\n|------|-------|------|\n| 搜索/浏览 | ✅ | - |\n| 比价/看评论 | ✅ | - |\n| 加购/用券 | 手动指导 | ✅ |\n| 地址/结算/提交订单/支付 | ❌ | ✅ |\n\n## 工作流程\n\n```\n发现 → 对比 → 选择 → 风险核对 → 手动加购/结算/支付\n```\n\n## 店铺类型优先级\n\n1. **天猫旗舰店** ⭐⭐⭐⭐⭐ - 品牌直营，最可靠\n2. **天猫** ⭐⭐⭐⭐⭐ - 品牌授权，正品保障\n3. **企业店铺** ⭐⭐⭐⭐☆ - 认证企业，较可靠\n4. **个人皇冠店** ⭐⭐⭐☆☆ - 经验丰富，需谨慎\n5. **普通个人店** ⭐⭐☆☆☆ - 价格优势，风险较高\n\n## 价格计算公式\n\n```\n到手价 = 标价 - 店铺券 - 平台券 - 满减 - 淘金币 - 支付优惠\n```\n\n## 最佳购物时机\n\n- **618** (6月1-18日) - 年中大促\n- **双11** (11月11日) - 全年最大促销\n- **双12** (12月12日) - 年终清仓\n- **38女王节** (3月8日) - 女性品类\n- **99划算节** (9月9日) - 秋季促销\n\n## 版本\n\n- v2.1.3 - 增加安全审计所需的 skill card，并继续统一公开信息只读边界\n- v2.1.2 - 统一公开信息只读边界，移除登录态购物车和自动用券描述\n- v2.0.0 - 新增公开商品页面的浏览辅助；不使用登录态，不操作购物车\n- v1.0.0 - 基础购物指南\n\n## 安装\n\n```bash\nclawhub install taobao-shopping\n```\n\n## 使用\n\n```\n用户：帮我买蓝牙耳机\nAgent：搜索 → 对比 → 核对店铺、规格、评价和价格风险 → 输出手动下单前清单\n用户：核对信息后自行决定是否在淘宝页面加购、结算、提交订单并支付\n```\n\n## 相关 Skill\n\n- `jingdong` - 京东购物\n- `jd-shopping` - 京东购物（替代版）\n- `tianmao` - 天猫购物\n- `pdd` - 拼多多购物\n- `vip` - 唯品会购物\n\n## 反馈\n\n- 觉得好用：`clawhub star taobao-shopping`\n- 获取更新：`clawhub sync`"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn77zzg9p845zanvy6vrf76k7d81mcnm\",\n  \"slug\": \"taobao-shopping\",\n  \"version\": \"2.1.3\",\n  \"publishedAt\": 1784981656824\n}"},{"path":"references/browser-workflow.md","content":"# Public Browser Workflow for Taobao Shopping\n\nThis document describes the read-only browser workflow for public Taobao research.\n\n## Overview\n\nTaobao browsing follows a phased approach that ends before any private account state or purchase action.\n\n**Scope:** Use public pages and user-provided screenshots/details only. Do not log in, use cookies, access account pages, change cart state, apply or claim coupons, select an address, enter checkout, submit an order, or pay.\n\n## Authentication Requirements\n\n| Operation | Login Required | Notes |\n|-----------|----------------|-------|\n| Search | No | Public search results |\n| Browse categories | No | Public category pages |\n| View product details | No | Public product pages |\n| Read reviews | No | Public review data |\n| Compare prices | No | Public price information |\n| Add to cart | User-only by default | Requires active session; provide manual guidance instead |\n| View cart | User-only by default | Private account state |\n| Apply coupons | User-only by default | Private account state |\n| Address / checkout / order preview | User-only | Do not enter checkout or address flows |\n| Payment | User-only | User only |\n\n## Browser Extraction Order\n\nWhen extracting data from Taobao pages, follow this priority:\n\n1. **商品标题** - Product title\n2. **价格信息** - 原价, 券后价, 到手价\n3. **店铺类型** - 天猫/企业店/个人店\n4. **店铺评分** - 描述相符, 服务态度, 物流服务\n5. **销量** - 月销/总销量\n6. **可见优惠信息** - 店铺券/平台券的公开条款；不申请或应用优惠券\n7. **满减活动** - 满X减Y\n8. **规格选项** - 颜色, 尺寸, 版本\n9. **用户评价** - 好评率, 追评, 晒图\n10. **物流信息** - 发货地, 运费, 预计送达\n\n## Workflow Phases\n\n### Phase 1: Discovery\n\n**Actions:**\n- Navigate to taobao.com\n- Enter search query\n- Apply filters (price, rating, brand)\n- Sort results (sales, price, rating)\n- Extract top 3-5 product summaries\n\n**Key Data Points:**\n- Product title\n- Main image\n- Price range\n- Sales volume\n- Store type badge\n- Rating score\n\n### Phase 2: Selection\n\n**Actions:**\n- Open selected product page\n- Extract detailed specifications\n- Read user reviews (first 10-20)\n- Check variant options\n- Verify seller information\n\n**Key Data Points:**\n- Full product description\n- All available variants\n- Detailed visible pricing and promotion terms (without applying coupons)\n- Store rating breakdown\n- Return policy\n- Shipping cost\n\n### Phase 3: Cart-Ready Handoff\n\n**Key Data Points:**\n- Confirmed product and SKU\n- Visible price and promo caveats\n- Seller trust and review risks\n- Manual checks for final payable amount, stock, address-based delivery, coupons, return policy, invoice, warranty, checkout, and payment\n\n**Actions:**\n- Present cart-ready summary from public evidence\n- Stop before login, cart change, checkout, address, order, or payment screen\n- Provide manual next-step instructions\n\n**Never:**\n- Enter payment information\n- Click checkout, settlement, final submit, or order buttons\n- Complete transaction\n\n## Error Handling\n\n### CAPTCHA\nWhen CAPTCHA appears:\n1. Stop automation\n2. Notify user\n3. Provide manual instructions\n\n### Login Required\nWhen log"},{"path":"references/marketplace-guide.md","content":"# Marketplace Guide\n\nTaobao is strong for:\n- variety\n- style breadth\n- price range\n\nWatch for:\n- seller quality variation\n- variant confusion\n- image-vs-reality mismatch"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Taobao shopping decision assistant. Input a Taobao product name, listing, screenshot, or link; evaluate store credibility, Tmall/enterprise/personal seller t... Skill: Taobao Shopping Owner: harrylabsj Summary: Taobao shopping decision assistant. Input a Taobao product name, listing, screenshot, or link; evaluate store credibility, Tmall/enterprise/personal seller t... Tags: buying-advice:2.1.1, china:2.1.1, ecommerce:2.1.1, latest:2.1.3, listing-risk:2.1.1, seller-comparison:2.1.1, shopping:2.1.2, shopping-decision:2.1.1, taobao:2.1.2 Version history: v2.1.3 | 2026-07-25T12","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1295,"uniquenessScore":50,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T10:56:23.974Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T10:56:23.974Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T08:20:16.703Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}