Immutable. This exact content is served forever at /api/v1/blob/e673f51153d589c8.
--- name: kelly-ecommerce-intel description: "Kelly Ecommerce Intel: App-in-Skill daily industry intelligence cockpit for e-commerce and cross-border sellers (Busabase App-in-Skill). Use when the user asks about e-commerce, cross-border selling, product trends, competitor prices, listing optimization, ads,电商, or跨境 scenes. Prepares news/source signals, buyer-intent interpretation, approved sales actions, and channel drafts for review before any external handoff." --- # Kelly Ecommerce Intel ## Overview Use this skill as Kelly's daily industry-intelligence operator for **e-commerce and cross-border sellers**. It turns current news sources, trend signals, competitor movement, customer questions, and buyer-intent clues into a small reviewable batch, held in Busabase: - source-backed signals; - why each signal matters to the buyer; - sales or operating actions for today; - draft messages/content for listing copy, ad angle, customer reply; - blocked claims that need human, legal, compliance, or domain review. Signal/action/draft collection is a genuine external operation a browser cannot perform (web browsing, source reading, buyer-intent judgment). The AirApp itself only reads and writes Busabase — it never browses, posts anywhere, or performs an external handoff; Kelly writes today's batch directly into Busabase through `busabase-sdk` as part of the normal workflow below, then reviews and decides inside the app. Default interaction mode: App UI. Unless the user explicitly asks for chat-only handling, check onboarding, collect/refresh today's batch, and give the user the clickable AirApp URL (or the local preview URL when local preview is explicitly requested). Use chat-only mode only when the user says "纯聊天", "chat only", "不要打开 UI", or similar. ## Mandatory Dependencies 1. Read and follow `$kelly-app-skill-creator` for product behavior, visual quality, responsive layout, and the complete canonical `app/` artifact. 2. Read and follow `$busabase` for connection, target Space, node discovery, ChangeRequests, review, and merge behavior. 3. Read and follow `$busabase-app-creator` for resource modeling, AirApp runtime limits, security, validation, and deployment. If a dependency is unavailable, preserve this skill's product contracts, stop before the unavailable Busabase operation, and report the exact missing dependency. Do not invent a second data backend. ## Product Package - **Buyer**: e-commerce founders, marketplace operators, DTC marketers, and cross-border sellers. - **Pain**: sellers need to react quickly to product demand, competitor pricing, platform rules, and ad angles. - **Offer**: daily e-commerce intelligence that becomes listing edits, ad angles, and product-push recommendations. - **Demo source mix**: marketplace pages, competitor pricing, platform policy notices, search trends, ads libraries, and reviews. Sales framing: > Every morning, AI watches the sources that affect your business, turns them into today's sales actions, and puts the drafts in a review queue before anything becomes official. Do not lead with "AI platform", "agent workspace", "database", or model names. Lead with the daily business scene. ## Scene Logic Use this skill to convert marketplace, ads, and competitor changes into ecommerce decisions. A signal is valuable when it affects search rank, conversion rate, margin, policy risk, creative testing, or customer objection handling. Prioritize signals in this order: 1. platform policy, fee, logistics, ranking, or account-health changes that require action before sales are affected; 2. competitor price, bundle, title, image, review, or ad movement that changes the offer comparison; 3. search/trend and review-language changes that reveal new buyer intent or a listing-copy gap; 4. fulfillment, seasonality, and campaign-calendar signals that affect which SKU gets pushed today. Actions should become listing edits, ad angles, bundle tests, review-response drafts, campaign briefs, or Busabase approval batches. Block platform-policy workarounds, fake review behavior, unsupported product claims, IP infringement, and price changes without explicit approval. ## Boundary - The skill may browse public/current sources, reason over buyer intent, draft actions/content, and write signal/action/draft/source records to Busabase. - The AirApp reads and writes its own Busabase Bases only. It must never post content, send WhatsApp/email, mutate CRMs, scrape private systems, spend money, or perform any other external side effect. - Customer-visible drafts, regulated claims, pricing promises, medical/financial/legal advice, and outbound messages are approval-required. - Store only the minimal source excerpts needed for review. Never store crawl credentials or API keys in Busabase. ## Busabase Resources Five Bases under one application Folder (`kelly-ecommerce-intel`), declared in `app/app/js/config.js` and `app/resource-map.json`: - `signals`: source-backed marketplace, competitor, and buyer-intent signals — evidence link, why-it-matters, buyer-intent interpretation, confidence, risk badges, a suggested action, and the human decision verdict. - `actions`: approved/blocked/reviewable listing, ad, or operating actions linked to signals, with owner, priority, reason, next step, and the human decision verdict. - `drafts`: editable channel drafts (listing copy / ad angle / customer reply) tied to an approved action; a human edit is stored as `edited-body` on the same row, never a separate file. - `sources`: configured marketplace/competitor/trend source categories, freshness, and coverage gaps. - `settings`: one row (`record-id: "batch"`) holding the current batch's metadata (`batch_id`, `generated_at`, `source`, `vertical`, `buyer`, `offer`) as a JSON payload. Resources provision lazily through an idempotent Busabase ChangeRequest the first time the app runs in a Space; see `references/ui-schema.md` for exact field shapes. ## First Run And Onboarding On invocation, check the `signals`, `actions`, and `drafts` Bases. If all are empty, guide setup before collecting a real batch: ask for company/brand name, geography, language, and customer segment; 3-10 public source URLs or source categories to monitor; competitor names/URLs; approved offer, CTA, and forbidden claims; preferred channels among listing copy, ad angle, customer reply. Never ask for API keys or platform tokens in chat — Busabase connection happens through the app's own Connect Busabase gate. ## Local App Default behavior is AirApp-first — give the user the clickable AirApp URL. Start `pnpm --dir app dev` only when local preview/debugging is explicitly requested. Required app views (hash routes): - `#/overview`: human-attention panel — today's needs-review/approved/blocked counts, top signals, and ready (approved) actions. - `#/signals` and `#/signals/<id>`: source-backed signals with evidence links, buyer-intent interpretation, confidence, risk badges, and a decision panel (Approve / Request changes / Block) with a review note. - `#/actions` and `#/actions/<id>`: approved/blocked/reviewable operating or sales actions with owner, priority, reason, next step, linked signals, and the same decision panel. - `#/drafts` and `#/drafts/<id>`: editable listing copy, ad angle, customer reply drafts with the decision panel plus a `Save revision` action that writes an edited body directly onto the draft record. - `#/sources`: configured source categories, freshness, and gaps. - `#/settings`: sanitized batch metadata, data provider, onboarding state. Demo mode: - `?demo=1`, `?demo=overview`, `?demo=signals`, `?demo=actions`, `?demo=drafts`, and `?demo=detail` load deterministic demo data. - `lang=en` or `lang=zh` forces UI chrome language. - Demo mode never reads or writes Busabase; decisions only mutate the in-memory demo batch. ## Batch Workflow 1. Detect mode. Default to App UI. 2. Browse or otherwise collect current public evidence. For news/trends, use exact dates and source URLs. 3. Build one narrow buyer scene, not a generic AI report. 4. Write the batch directly into Busabase through `busabase-sdk` (`bases.createChangeRequest` for each new signal/action/draft/source row, matching the field slugs in `references/ui-schema.md`; refresh the `settings` "batch" row's JSON payload with `batch_id`/`generated_at`/`source`/`vertical`/`buyer`/`offer`). Keep every item tied to evidence or mark it `blocked`. 5. Open the AirApp for review. 6. Poll for `request_changes` decisions (`decision-verdict` = `request_changes` on a signal/action/draft row) and revise only those items — write the revision back onto the same record. 7. On "execute/export approved", run `node scripts/execute_decisions.mjs` first as a dry run. After performing any real handoff, run `node scripts/execute_decisions.mjs --apply` to mark the approved items done. ## Decisions Workflow 1. Kelly's verdicts write directly onto the item record (`status`, `decision-verdict`, `decision-comment`, `decided-at`) through `busabase-sdk`. From a standalone local preview the write merges immediately (trusted operator); from the deployed AirApp it creates a pending ChangeRequest for the trusted process to merge. 2. Before executing anything, run `node scripts/execute_decisions.mjs` (dry-run). It prints the concrete operation for every decided signal/action/draft: `mark_signal_approved`, `export_action_plan`, or `handoff_content_pack` for an `approve` verdict; `queue_agent_revision` for `request_changes`; `mark_blocked` for `block`; `save_human_revision` for a draft's `revise`. 3. After Kelly confirms the dry-run and performs the handoff somewhere outside this script, run `node scripts/execute_decisions.mjs --apply` to mark the approved items `done`. `request_changes`/`block` verdicts are left exactly as decided — there is nothing further for the script to do. ## Safety Defaults - Treat outbound messages, regulated claims, medical/financial/legal advice, pricing promises, and publishing as approval-required. - If source evidence is weak, mark the item `blocked` or lower confidence instead of pretending. - Preserve source language unless the workflow asks for translation. - Keep every write idempotent by upserting on the item's own id field so re-running a collection pass never duplicates rows. - Block platform-policy workarounds, fake review behavior, unsupported product claims, IP infringement, and price changes without explicit approval. ## Useful Commands ```bash node skills/kelly-ecommerce-intel/scripts/execute_decisions.mjs node skills/kelly-ecommerce-intel/scripts/execute_decisions.mjs --apply pnpm --dir skills/kelly-ecommerce-intel/app dev ```