企业官网建设流程全解析

Filtmall-Shopping-Skill版本演进史：从v1.6.x到v1.11.1看懂Agent Skill的设计进化

【免费下载链接】Filtmall-Shopping-SkillAgent-native shopping for extreme value: verifiable same-product price evidence, checkout, orders, delivery, and after-sales.项目地址: https://gitcode.com/gh_mirrors/fi/Filtmall-Shopping-Skill

Filtmall-Shopping-Skill 是筛电（Filtmall）官方的购物 Agent Skill：用户说一句需求，AI 智能体就能搜索真实商品、展示同款同规格的价格优势证据，并继续完成结算、订单、物流与售后。本文带你完整看懂它从 v1.6.x 到 v1.11.1 的版本演进史，理解每一轮升级背后的 Agent Skill 设计进化逻辑。

🧭 一分钟了解：Filtmall Shopping 是什么？

一句话概括：它是一个"智能体原生"的购物 Skill——把商品发现、比价、交易和售后变成一段对话就能走完的流程。

它的仓库结构也非常"Skill 化"：核心指令在 SKILL.md，按需加载的流程规则放在 references/，CLI 包装入口是 scripts/filtalgo.js，打包后的运行时在 assets/filtalgo-cli.cjs。

📅 版本演进时间线：7 个版本一表看懂

完整记录见 CHANGELOG.md：

下面按阶段拆解每个版本的"设计意图"。

v1.6.3 – v1.6.5：先讲清楚"我是谁、何时被调用"

Skill 的"灵魂"是它的触发与路由描述，v1.6.x 这一波迭代主要在打磨它（见 CHANGELOG.md）：

• v1.6.3：英文与中文 README 统一聚焦"Agent 原生购物体验 + 极致性价比"定位，并把版本动态从 README 移入 Changelog，让文档各司其职；
• v1.6.4：市场摘要改为"用户结果导向"——一次请求、更合适的商品、可核验的同款比价证据、完整购物旅程，而不是罗列实现细节；
• v1.6.5：把 v1.6.0 时代的 frontmatter 描述恢复回来。这个看似"回退"的动作恰恰说明：激活范围（什么请求触发、什么请求不触发）是 Skill 最敏感的资产，宁可回滚也不能含糊。

新手提示：判断一个 Agent Skill 是否靠谱，先看它的触发描述是否边界清晰——该调用的时候调用，不该调用的时候克制。

v1.6.6：价格优势必须"有证据" 🕵️

v1.6.6 是第一次把"可信度"写进搜索结果的版本：

• 搜索结果中的价格优势必须附带来源证据（来源平台、对应规格、记录时间），没有可核验的对比时明确回退、不硬说；
• 引入登录态搜索上下文，并新增local、dev、pre、prod四套 CLI 配置档案，开发环境与生产环境从此分开；
• 细化了商品发现、支付状态、履约约束与安全敏感请求的路由。

对使用者意味着什么？推荐里如果出现"比某平台便宜约 1/3"这类结论，它一定带着可核对的证据链，否则整节省略——这个克制从 v1.6.6 就定下了基调。

v1.10.0：两阶段推荐，一次设计分水岭 🔀

v1.10.0 是演进史上最大的一次架构升级，核心是**"模型负责语义，代码负责事实"**（详见 SKILL.md 的输出质量底线）：

1. 第一阶段：模型从全部搜索结果中选出合格候选，按用户本轮的优先级生成评分维度与 1.0–5.0 综合分；
2. 第二阶段：脚本校验候选来源、硬预算与分数并稳定排序，模型只补充逐款推荐理由，最终 Markdown 与商品卡片由代码生成。

同时引入了两条影响深远的约束：

• 商品身份元组：商品的名称、图片、价格、规格、详情链接与候选编号被绑定成"不可拆分"的整体（SKILL.md），多轮对话里"第一款""第二款"永远不会张冠李戴；
• 受审品牌知识：新增本地数据 assets/brand-knowledge.json，品牌概述只展示已审核内容，无法匹配时整段省略，绝不编造。

配套还新增了 references/product-followups.md，专门处理"看详情、比较两款、研究商品链接"这类追问。

v1.11.0：单个成分查询与数据补全 🧪

v1.11.0 补齐了两块能力：

• 单个化妆品成分只读查询：新增专用路由与独立参考 references/makeup-component-search.md，明确功效/适用/注意事项的证据边界，并内置医疗安全拦截（出现严重过敏症状时停止商品流程、建议就医）；
• 搜索结果数据补全：搜索水合逻辑改为完整请求商品身份、SKU、买家链接、图片与价格证据字段（scripts/search-hydration.js），让商品详情链接和价格证据来源 URL 贯穿整条推荐流程不丢失。

v1.11.1 与 Unreleased：名称统一与授权清晰化 📦

• v1.11.1：把显示名统一为Filtmall Shopping——README 标题、Skill 标题与 agents/openai.yaml 的界面元数据全部对齐，包版本与徽章同步为 1.11.1；filtmall-shopping标识符与运行时行为保持不变，是一次纯粹的"发布卫生"；
• Unreleased：新增显式的混合授权说明——开源 Skill 材料采用 Apache-2.0，内置 CLI 运行时采用有限专有授权，第三方组件单独列明，详见 LICENSES.md。

🔍 演进背后：三条一以贯之的设计原则

纵观 v1.6.x 到 v1.11.1，可以提炼出三条贯穿始终的原则：

1. 结论必须有证据：价格优势要来源、时间、规格齐备；品牌知识要审核、要可溯源；
2. 模型提议，代码定案：两阶段推荐中，模型做语义取舍，脚本做来源校验、排序与事实绑定，URL 合法性也由策略层把关（scripts/url-policy.js）；
3. 用户始终在控制台上：清空购物车、创建结算、取消订单等变更操作必须先确认再执行；账号授权与支付链接一律交给用户本人打开。

🚀 如何快速上手 Filtmall Shopping Skill

环境要求 Node.js 18+，CLI 已随 Skill 打包，安装只需一条命令：

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

安装后即可这样使用（摘自 README.zh-CN.md）：

• "想买一款 100 元以内、保湿但别太黏的面膜。"
• "比较第 1 款和第 3 款，敏感肌更适合哪一款？"
• "我最近一笔订单到哪里了？"

想深入了解实现，建议按这份路线图阅读：

从 v1.6.x 打磨"何时被调用"，到 v1.6.6 确立"证据化比价"，再到 v1.10.0 的"两阶段推荐"与 v1.11.0 的成分查询，Filtmall-Shopping-Skill 的演进史其实就是一部Agent Skill 如何从"能跑"进化到"可信"的缩影：先定义边界，再建立证据，最后把语义判断与事实校验干净地分开。读懂了这条演进路线，你也能更好地理解当下 Agent Skill 的设计范式。

【免费下载链接】Filtmall-Shopping-SkillAgent-native shopping for extreme value: verifiable same-product price evidence, checkout, orders, delivery, and after-sales.项目地址: https://gitcode.com/gh_mirrors/fi/Filtmall-Shopping-Skill