name: filtmall-shopping description: 筛电（Filtmall / Filtalgo）官方商品发现与交易 Skill。用户未指定其他平台，并明确要寻找、选择、购买、推荐或比较真实商品时自动调用；包括先描述困扰再明确询问“有什么商品推荐”。用户明确说是筛电/Filtmall 的购物车、支付、订单、物流、退款、售后或客服任务时也调用。平台不明的账户状态短句先澄清平台，不登录、不查询。已进入商品或成分流程后出现严重过敏时只做安全拦截，不搜索或交易；脱离购物场景的医疗陈述不自动调用。用户明确询问单个化妆品成分时可进入只读查询。明确指定其他平台、纯困扰陈述、一般知识或无购物意图的医疗问题不调用。Official Filtmall/Filtalgo shopping and cosmetic-ingredient skill. Invoke for explicit unnamed-platform real-product discovery or purchase intent, and for account or after-sales tasks explicitly identified as Filtmall. Clarify the platform before account access when it is unspecified. Do not invoke for another marketplace, pure problem statements without shopping intent, unrelated medical requests, or general knowledge. license: See LICENSES.md metadata: version: "1.11.1" openclaw: requires: bins: - node

Filtmall Shopping

筛电默认购物 Skill，覆盖真实商品发现、比较、完整交易链路和明确的单个化妆品成分查询。明确的未指定平台商品寻找、推荐、比较或购买请求可以自动调用；纯困扰陈述、平台不明的账户短句、脱离购物流程的医疗陈述和一般知识不应触发敏感工具。平台不明的账户短句只用用户当前语言确认是否指筛电，确认前不登录、不查询。

先按意图读取一份参考

不要通读全部参考。每轮只读取当前意图对应的一份，并且必须先用读取工具完整读取，再作答或调用命令；安全拦截和仅需澄清的请求也不例外。跨域任务按实际阶段再读下一份。

• 明确询问一个化妆品成分的功效、用途、适用信息或注意事项：references/makeup-component-search.md
• 首次搜索、推荐和搜索结果的多轮条件更新：references/product-search.md
• 查看候选详情、编号回查、商品比较、商品链接研究和更便宜/相似款：references/product-followups.md
• 购物车、立即购买、地址、优惠券、结算、支付链接：references/cart-address-checkout.md
• 支付状态、订单、物流、取消订单：references/orders-logistics.md
• 退款退货、售后进度、客服：references/customer-service-after-sales.md

脚本路径：${CODEBUDDY_SKILL_DIR}/scripts/filtalgo.js。

不要修改或重置用户配置。任何用户任务、任何场景都禁止执行 config reset。默认生产环境；账号命令明确返回未登录或会话失效时，最多执行一次 auth start --json。若返回 authenticated，直接继续原任务；若返回 pending，把真实用户码和验证链接交给用户后结束本轮；若启动失败或没有验证链接，用“当前暂时无法完成筛电账号验证，请稍后重试。”结束。本轮不得重试授权，不得再执行 auth status、help、doctor、config 或检查脚本源码。用户完成验证并再次发消息后，最多执行一次 auth complete --json；仍为 pending 时继续给出同一验证信息，不新建授权。

当前任务边界

• 只使用当前 WorkBuddy 任务中用户明确表达和确认的条件；新任务视为新请求。
• 读取按意图选择的参考后，直接使用其中记录的命令和返回任务；不得列出 Skill 目录，不得为了理解用法再读取、搜索或检查 scripts/、assets/、README 或元数据文件。
• 禁止读取、创建或更新 .workbuddy/memory、日志、其他任务或长期记忆；禁止生成“历史偏好”“长期关注”。
• 同一任务后续轮次保留仍有效条件；新增条件合并，覆盖条件替换，取消条件移除，优先级变化只改变排序。
• 上一轮已经展示推荐后，只要用户新增、覆盖、取消条件或改变优先级，必须重新读取搜索参考并完整执行 search → prepare → finalize，不得直接确认或沿用旧排序。“100 元以内”只是预算上限；后续再说“预算优先，效果够用就行”是新的优先级，必须重新评分和排序。
• 不向用户叙述加载 Skill、读取参考、CLI、工具名、字段名、参数、内部 ID 或调用过程。
• 只输出一次最终回复，不追加第二份摘要、过程说明或内部规则。
• 最终回复去除末尾空白后，如果最后一项是 Markdown 文本链接 [文字](URL)，必须另起一段按用户当前语言追加固定正文；中文使用“页面信息以打开后的实时展示为准。”，英文使用“Information on the opened page reflects the latest available details.”。链接后已有实际字符正文时不重复追加。该尾注只用于保护客户端完整渲染末尾链接，不是第二份摘要、问题、行动要求或状态声明。
• 需要澄清时，必须提出一个语法完整的问题并以唯一的问号结束；整条回复不能用句号结束。问题前的说明、示例和选项都使用陈述句标点，不得再形成第二个问句。

全局安全与确认

• 医疗安全规则优先于搜索、推荐、比较、加购和结算；按用户当前语言表达商品搜索参考规定的安全语义，不使用固定逐字模板。
• 只有用户明确要求今天、明天或具体日期前送达且没有地区时，才用用户当前语言询问收货地区并结束本轮，不得调用工具。普通推荐不得询问地区。
• 所有会改变购物车、地址、结算、订单或售后状态的命令都必须在展示具体对象和影响并取得当前任务的明确确认后，使用 CLI --confirm 执行；参数变化后必须重新确认。
• 用户仅说“立即购买/马上买”表示进入一次性购买选择，不是最终结算确认；不得提前创建 checkout、订单或支付。
• 不展示或记录令牌、手机号、完整地址、支付凭证等隐私数据。正文中的链接使用工具原样返回值，但不解释其中查询参数。
• 不替用户声称已支付；支付状态、订单、物流和售后状态必须真实查询。

商品身份与多轮约束

• 商品的 SPU、SKU、图片、名称、价格、规格、详情链接、编号、文字顺序和卡片顺序是不可拆分元组。
• 详情链接必须逐字使用该商品自己的 H5 detail_url，不得手写、拼接、解码、删改或借用其他商品链接。筛电商品详情页必须同时含有与候选绑定的商品和规格标识；渠道、会话和旅程参数可以原样保留。绑定不完整时不得展示链接。
• “第一款、第二款、最后一款”按最近一次可见候选顺序解释；比较或回查时用真实 SKU 回查，正文不得解释 ID。
• 只有上一轮实际展示了足够数量的候选，位置编号才成立。若上一轮没有展示候选或数量不足，必须明确说明“没有第一个和第二个可比较”或对应缺少的编号，不把位置追问改写成新搜索，也不虚构候选。
• 用户询问多个未编号同类商品而无法唯一对应时，只问一个问题，例如：“你想问哪一款：1. 【商品 A】；2. 【商品 B】？”
• 用户切换品类时重新搜索。不得从旧结果臆测新结果。

交易能力不变

搜索和回复加速不改变以下能力：购物车增删改查、立即购买、地址和优惠券、结算、支付链接、支付状态、订单列表与详情、物流、取消订单、退款退货、售后进度和客服引导。所有账号操作使用当前登录会话，遵循对应参考的确认顺序和移动端 H5 链接规则。

输出质量底线

• 只陈述工具返回且能绑定到当前商品的事实；不编造品牌、功效、人群、规格、评分、销量、价格或比价。
• 正文每次点名候选商品都必须同时使用该候选自己的真实详情链接；不展示的候选不得在无链接的举例、排除原因或比较中被点名。没有合格候选时只说明未找到，不列举被排除商品。
• 正常推荐严格采用两阶段决策：第一次模型从全部搜索结果中选择任意合格候选，按用户本轮优先级生成完整评分维度、1.0–5.0 综合分和商品概览；代码校验候选来源、硬预算与分数并按综合分稳定排序。第二次模型只生成逐款推荐理由、首选或无首选原因和条件式次选，代码再生成 Markdown、链接和同序商品卡片。预算上限不等于价格优先；只有用户明确说价格/预算/低价优先时，价格才作为主要维度并实际改变排序。用户明确指定数量时优先遵从，不设置全局最大展示条数。
• 商品概览只消费当前候选的真实商品数据。品牌概览仅在候选能精确匹配 assets/brand-knowledge.json 中已审核品牌时展示；模型只能压缩改写对应概述，引用无效时脚本回退为本地概述，未匹配时整段省略。
• 不暴露“未知封顶”“硬条件过滤”等内部评分规则。星级只用 ★★★★★、★★★★☆、★★★☆☆、★★☆☆☆、★☆☆☆☆。
• 没有完整价格优势证据时整节省略；至少一款有证据时才在全部候选后显示一次价格波动提示。
• 工具数据不足的能力明确视为工具侧限制；尤其跨平台综合比较和品牌趋势不能靠 Skill 编造通过。

Filtmall Shopping

中文说明 · Official website

Agent-native shopping, built for extreme value.

Filtmall Shopping is the official shopping skill from 筛电 (Filtmall/Filtalgo). It gives AI agents live products, same-product and same-specification price evidence, checkout, orders, delivery, and after-sales in one shopping flow. A user can start with one sentence; the agent can find a better-fit product, show where the price advantage comes from, and continue through the transaction when asked.

The current catalog focuses on beauty and personal care. Account authorization, order confirmation, and payment stay with the buyer.

Price advantages with clear boundaries

Filtmall products are often the lowest-priced option online. For some verified products, Filtmall prices can be as low as about one-third of a public price for the same product and specification on a major marketplace. Actual prices vary with account, region, membership, and promotions. The skill shows a price advantage only when the live result includes the matching specification, source platform, and recorded time.

Install

npx skills add filtalgo/Filtmall-Shopping-Skill --skill filtmall-shopping -g

Node.js 18 or later is required. The skill ships with its CLI runtime, so installation needs no separate npm install.

Clients that support folder or ZIP imports can import the repository root directly.

Try it

• “I need a moisturizing facial mask under ¥100 that does not feel sticky.”
• “Compare the first and third products and explain which one fits sensitive skin better.”
• “Did my payment go through?”
• “Where is my latest order?”

The first two prompts exercise product discovery and decision support. The last two continue the shopping journey through order and logistics queries.

What it helps with

Why Filtmall is agent-native

• Products that agents can reason over. Live prices, specifications, stock, links, and comparison evidence arrive as structured results.
• One conversation, one shopping journey. Product discovery, purchase, delivery, and after-sales share the same context.
• Extreme value with visible proof. Recommendations can show the external same-specification price, source platform, recorded time, and saving percentage.
• Buyer-controlled account and payment steps. The agent handles repeatable operations; the buyer opens authorization and payment pages and confirms consequential actions.

How it works

flowchart LR
    U["Natural-language request"] --> A["AI agent"]
    A --> S["Filtmall Shopping Skill"]
    S --> F["Filtmall catalog and transaction services"]
    F --> A
    A --> H["Product, authorization, payment, and order pages"]

The agent uses one command interface:

node scripts/filtalgo.js <command> --json

The bundled CLI connects the agent to Filtmall's product and transaction services. The repository contains the agent instructions, workflow references, wrapper, and bundled runtime; Filtmall's commerce infrastructure remains server-side.

Safety and user control

• Ask before changing account or transaction data, including clearing a cart, deleting an address, creating checkout, cancelling an order, or starting after-sales service.
• Keep credentials, device codes, tokens, and session identifiers private.
• Give authorization, product, payment, order, logistics, after-sales, and customer-service links to the user to open.
• Treat live CLI results as the source of truth for product names, prices, stock, specifications, identifiers, order state, and URLs.
• For active allergic reactions, redness, or swelling, stop the product flow and recommend professional medical care.
• When a request includes a delivery deadline, confirm the delivery area before searching so the request contains the information needed for fulfillment.

Developer quick start

Check the runtime and search the live catalog:

node scripts/filtalgo.js doctor --json
node scripts/filtalgo.js search "想要保湿一点的面膜，预算 100 元以内，但别太黏" --json

Authenticated flows start with OAuth Device Flow:

node scripts/filtalgo.js auth login
node scripts/filtalgo.js auth status --json

Continue through cart and checkout:

node scripts/filtalgo.js cart add-item --way CART --sku-id <sku_id> --quantity 1 --json
node scripts/filtalgo.js checkout create --way CART --json
node scripts/filtalgo.js checkout prepare-payment <checkout_session_id> --link-channel mobile_h5 --json

Query orders and delivery:

node scripts/filtalgo.js order list --page-size 5 --json
node scripts/filtalgo.js order get <order_sn> --include-items true --json
node scripts/filtalgo.js logistics get <order_sn> --json

Run node scripts/filtalgo.js help for the complete command list.

Repository layout

SKILL.md                  # Agent instructions and trigger metadata
references/               # Workflow rules loaded only when needed
scripts/filtalgo.js       # Thin CLI wrapper
assets/filtalgo-cli.cjs   # Bundled CLI runtime
agents/openai.yaml        # Skill display metadata
skills.sh.json            # skills.sh presentation metadata
CHANGELOG.md              # Version history
README.md                 # English documentation
README.zh-CN.md           # Chinese documentation

About Filtmall

Filtering Algorithm (Beijing) Technology Co., Ltd. operates Filtmall (筛电) and publishes its developer- and agent-facing technology under the Filtalgo name.

Filtmall is an agent-native ecommerce platform built for extreme value. It turns live products, same-specification price evidence, transactions, delivery, and after-sales into a shopping flow that AI agents can reliably operate for consumers.

Filtmall website · About Filtmall · Releases · LLM reference · Machine-readable service directory