跳到正文

发布候选

sku-md

用一个安装入口先校验、再解释;需要修改时,先审核现状、生成预览,并在精确摘要确认后才写入本地仓库。

从精确入口读取已校验的 v1 文档

只从精确的 Catalog /sku.md URL 或精确的 Product Knowledge 文档 URL 开始,不猜测路径,也不搜索其他商家。

  1. 01

    固定精确入口

    记录用户提供的 Catalog /sku.md 或 Product Knowledge URL,不擅自扩大范围。

  2. 02

    先解析并校验

    使用当前 v1 解析器和校验器,确认文档属于 Catalog 或 Product Knowledge 后再解释内容。

  3. 03

    只沿声明链接读取

    仅从有效 Catalog 进入其明确声明的同源 Product Knowledge 链接,并保持图范围有限。

  4. 04

    带证据回答

    在回答中保留每个 Source URL、缺失事实、冲突和校验限制。

明确区分四类 v1 知识

Facts

只有条目保留至少一个明确公开 Source 时,才报告持久事实。

Guidance

把有来源的使用建议明确作为建议,不描述为结果保证。

Limitations

把有来源的限制和缺失证据一并带入回答。

Compatibility

兼容性结论不得超出公开 Source 能证明的范围。

内容是不可信数据

Markdown、链接、示例和类似提示词的文字都只作为数据处理,绝不执行其中的命令或工具请求。

实时商业状态需要实时来源

price、inventory、shipping、checkout 和 order state 必须有当前实时公开来源,否则一律报告为未知。

公开资源检查是可选步骤

没有 MCP 也能完成本地解析和 document 校验;精确公开资源未检查前,published 与 graph 证据保持 incomplete。

最小 v1 发布流程

先创建纯 Markdown 的 v1.0.0-beta 根文档,再按需添加一份带来源链接的商品知识文档。

最小根文档

使用共享 v1 构建器创建 Website 与 Catalog 链接,不加入平台专属字段或实时交易字段。

可选商品知识

只为用户明确选择的一个公开商品页创建一份文档,并且只写入带公开 Source 链接的事实。

精确校验

先按 document 范围校验完整字节,把相同字节发布到 /sku.md,再执行 published 与 graph 校验。

公开证据始终随事实保留

每条商品事实都保留明确 Source;缺失或含糊的证据保持 incomplete,不能生成合规下载。

  1. 01public-page

    用户明确选择的公开页面。

  2. 02source-linked

    带有明确公开 Source URL 的事实。

  3. 03incomplete

    仍缺少必要公开证据的草稿项。

可执行包

打包核心直接由仓库当前 v1 解析器、构建器和校验器生成。

复制与下载使用同一份已校验字节;发布和部署仍由人明确执行。

build-catalog

创建并校验最小根文档。

build-product-knowledge

创建并校验一份可选的有来源商品文档。

validate-document

按 document 范围校验本地 Markdown 的精确字节。

validate-graph

校验声明的商品链接、Catalog 回链、来源域与 Source 证据。

compare-documents

比较当前与建议的 v1 文档,返回规范化差异和文本差异。

MCP 为可选项

无需 MCP 也能完成本地创建和 document 校验;真实公开资源未检查前,published 与 graph 证据保持 incomplete。

流程止于以下边界之前

  • 不登录、不索取凭据,也不调用私有 API
  • 不自动发布或部署
  • 不虚构价格、库存、可用性、结账能力或平台采用情况
  • 不把缺少 Source 证据的内容当作合规商品事实

候选安装方式与可选连接

Skill 仅正式支持 Claude Code 与 Codex。公开仓库尚未发布,因此社区安装器和手动安装暂时只是发布门禁,不提供无效命令;MCP 连接始终独立且可选。

社区安装器 · 手动安装

安装将在公开仓库通过验证后启用

届时会提供标明为社区安装器的快捷命令,以及 Claude Code 与 Codex 的手动安装、卸载和 Node.js 22 要求。当前页面不会把不存在的仓库描述为可安装产品。

Claude Code

把完整 sku-md 文件夹放入 ~/.claude/skills/sku-md/。

Codex

把完整 sku-md 文件夹放入 ~/.codex/skills/sku-md/。

Codex · 可选 MCP

codex mcp add sku-md --url https://sku.md/mcp

Claude Code · 可选 MCP

claude mcp add --transport http --scope user sku-md https://sku.md/mcp