SuperAPI AI 工具集

shopify-yourskill

通用与其它

查看项目

更新于 10-15 23:45

技能介绍

用途:这是一份用于撰写 Shopify 电商类 AI 技能的模板与规范文档,帮助作者产出结构统一、可被智能体按需加载的 SKILL.md。它本身不是可执行程序,而是编写指南。

主要能力与规范:技能名采用 shopify-<area> 或 ecom-<area> 形式,仅小写与连字符,目录名必须与 frontmatter 的 name 一致;description 以“Use when…”开头,列出具体触发词与关键词,并以“not for X, use Y”结尾,不写工作流摘要;正文建议 100–200 行,重细节放入 references/*.md;本集合仅含 Markdown,不含 scripts/ 目录;每个 SKILL.md 结尾需有 Provenance and maintenance 段落。

使用方式:涉及 Admin API 的技能需先配置访问。Lane A 使用自定义应用令牌,通过环境变量导出,不写入提交文件: export SHOPIFY_STORE="your-store.myshopify.com" export SHOPIFY_ACCESS_TOKEN="<your Admin API access token>" 随后调用 GraphQL 端点,示例最小权限为 read_products、write_products。Lane B 使用 Shopify CLI OAuth:shopify store auth --store $SHOPIFY_STORE --scopes read_products,write_products,再用 shopify store execute 执行操作。可选搭配官方 AI 工具包插件:claude plugin marketplace add Shopify/Shopify-AI-Toolkit 与 claude plugin install shopify-plugin@shopify-ai-toolkit。

安全与限制:遵循“先读后写”,变更前先做只读计数或预览;默认安全模式为只补缺失、不覆盖,MERGE 而非 REPLACE,先隐藏或归档再删除;大批量写入前先备份;通过 Admin API 而非店铺前台校验写入结果;绝不打印或提交访问令牌。文档中 GraphQL 固定为 Admin API 2025-07,Shopify 按季度滚动弃用版本,使用前应核对 shopify.dev。该技能的具体业务内容、适用店铺规模与效果暂未提供。