Skills

shopline-ai-toolkit-dsh

lunw/shopline-ai-toolkit-dsh · ★ 5

lunwCurated

SHOPLINE AI Toolkit: bridges the official SHOPLINE Developer MCP server and ships seven SHOPLINE agent skills (Admin REST, GraphQL, OAuth, webhooks, Sline) — the SHOPLINE counterpart of the Shopify AI Toolkit.

README body is shown in Chinese.

License
MIT
Added
2026-08-16
Maintenance
active
Install kind
github
Manifest details
Manifest status
Declared
Manifest path
package.json#dsh
Manifest checked
2026-08-19
Lifecycle scripts
None found

Static manifest checks report declarations only; they are not compatibility or security review.

安装

dsh plugin --profile web add github:lunw/shopline-ai-toolkit-dsh

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: zh · Read Chinese README

Table of contents
  1. English
  2. What is this?
  3. Install
  4. Example
  5. Repo layout
  6. License
  7. 简体中文
  8. 这是什么?
  9. 安装
  10. 示例
  11. 仓库结构
  12. 许可证

🛍️ SHOPLINE AI Toolkit — a DeepSeek Harness (dsh) plugin that brings SHOPLINE 开发者 MCP 官方工具与 SHOPLINE 平台知识技能 到你的 AI 编程助手。 架构参照 Shopify AI Toolkit:Skills + Dev MCP Server + Agent Plugin。

dsh-plugin · SHOPLINE · MCP · AI Toolkit · DeepSeek Harness

English · 简体中文


English

What is this?

The Shopify AI Toolkit gives AI coding agents Shopify-aware context through three layers: agent skills, a Dev MCP server, and per-tool plugins. This project brings the same architecture to SHOPLINE developers working inside DeepSeek Harness (dsh):

Layer What you get
🧠 Agent skills (skills/) 8 SKILL.md bundles: shopline-onboarding-dev, shopline-admin-rest, shopline-graphql, shopline-oauth, shopline-webhook, shopline-sline, shopline-dev-mcp (documented behavior) + shopline-app-dev-doc-gaps (app-dev doc-gap supplement, withdrawable once official docs cover it) — endpoint URLs, signing rules, error codes, retry policies, all grounded in developer.shopline.com docs and community experience
🔌 Dev MCP bridge The official SHOPLINE Developer MCP (@shoplineos/shopline-developer-mcp, local stdio, no auth) is wired through dsh's native MCP client — tools appear as mcp__shopline__search_shopline_docs, mcp__shopline__get_admin_rest_endpoint_detail, mcp__shopline__get_graphql_schema, mcp__shopline__validate_graphql_codes, …
🎛️ Optional community MCP sline.dev server (@shopline/dev-mcp) adds mcp__sline__introspect_admin_schema, mcp__sline__validate_theme, … (commented out by default)
📦 dsh bundle cordis.patch.yml + lib/index.js, installable with dsh plugin --profile <name> add shopline-ai-toolkit-dsh

Install

See docs/install.md. Quick start (full bundle):

dsh plugin --profile web add shopline-ai-toolkit-dsh
# add "shopline-ai-toolkit-dsh" to dsh.profile.bundles in ~/.dsh/profiles/web/package.json
dsh web

Skills-only: cp -R skills/* ~/.dsh/skills/

Compatibility: works with dsh 0.1.x (rc.6+) and 0.2.x (rc.2+) runtimes — peer range ^0.1.0-rc.6 || ^0.2.0-rc.2. The MCP bridge uses the runtime-provided @deepseek-ai/dsh-mcp-client. Updating an existing install (git spec / npm / local path) is covered in docs/install.md.

Example

"Search the SHOPLINE Admin REST endpoints for products, then give me the full endpoint detail for updating a product variant, including request parameters and a curl example."

The agent loads shopline-admin-rest + shopline-dev-mcp skills and calls mcp__shopline__search_admin_rest_endpoints → mcp__shopline__get_admin_rest_endpoint_detail.

More prompts: examples/prompts.md · Design: docs/architecture.md

Repo layout

├── package.json          # dsh bundle manifest (dsh.bundle.patch)
├── cordis.patch.yml      # bundle patch: mcp-shopline bridge + shopline-toolkit plugin
├── lib/index.js          # Cordis plugin: registers skills/* on ctx.skills
├── skills/               # 8 SHOPLINE agent skills (SKILL.md bundles; app-dev-doc-gaps is withdrawable)
├── mcp/mcp.shopline.json # ready-to-use MCP client configs (Cursor/Claude/DSH)
├── docs/                 # architecture.md · install.md
└── examples/prompts.md   # copy-paste prompts (EN/中文)

License

MIT. Not affiliated with SHOPLINE; official docs and npm packages remain the source of truth.


简体中文

这是什么?

Shopify AI Toolkit 通过三层结构让 AI 编程助手获得 Shopify 平台上下文:agent 技能 (skills)、 Dev MCP 服务器、以及各 AI 工具的插件。本项目把同样的架构带给在 DeepSeek Harness (dsh) 中开发的 SHOPLINE 开发者:

层 内容
🧠 Agent 技能(skills/) 8 个 SKILL.md 技能:shopline-onboarding-dev(入门)、shopline-admin-rest(REST API)、shopline-graphql(GraphQL)、shopline-oauth(授权与签名)、shopline-webhook、shopline-sline(模板引擎)、shopline-dev-mcp(MCP 工具用法,均为官方已文档化行为)+ shopline-app-dev-doc-gaps(应用开发文档盲区补充,官方文档补齐后逐条撤回)。端点、签名规则、错误码、重试策略均来自 developer.shopline.com 官方文档与 community.shoplineapp.cn 社区实践
🔌 Dev MCP 桥接 通过 dsh 原生 MCP 客户端接入官方 SHOPLINE 开发者 MCP(@shoplineos/shopline-developer-mcp,本地 stdio、免鉴权)。工具以 mcp__shopline__search_shopline_docs、mcp__shopline__get_admin_rest_endpoint_detail、mcp__shopline__get_graphql_schema、mcp__shopline__validate_graphql_codes 等形式直接可用
🎛️ 可选社区 MCP sline.dev 服务器(@shopline/dev-mcp)提供 mcp__sline__introspect_admin_schema(Admin GraphQL Schema 内省)、mcp__sline__validate_theme(Sline 模板校验)等,默认注释、按需开启
📦 dsh 插件包 cordis.patch.yml + lib/index.js,一条命令安装:dsh plugin --profile <name> add shopline-ai-toolkit-dsh

安装

详见 docs/install.md。快速开始(完整插件):

dsh plugin --profile web add shopline-ai-toolkit-dsh
# 在 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 中加入 "shopline-ai-toolkit-dsh"
dsh web

只想用技能:cp -R skills/* ~/.dsh/skills/

兼容性:支持 dsh 0.1.x(rc.6+)与 0.2.x(rc.2+)运行时,peer 范围 ^0.1.0-rc.6 || ^0.2.0-rc.2;MCP 桥接使用运行时自带的 @deepseek-ai/dsh-mcp-client。 已安装插件的更新方式(GitHub / npm / 本地路径)见 docs/install.md。

示例

「搜索 SHOPLINE Admin REST 端点中商品相关接口,然后给出更新商品变体的完整端点详情, 包括请求参数和 curl 示例。」

助手会加载 shopline-admin-rest 与 shopline-dev-mcp 技能,并依次调用 mcp__shopline__search_admin_rest_endpoints → mcp__shopline__get_admin_rest_endpoint_detail。

更多示例: examples/prompts.md · 设计文档:docs/architecture.md

仓库结构

├── package.json          # dsh bundle 清单(dsh.bundle.patch)
├── cordis.patch.yml      # bundle patch:mcp-shopline 桥接 + shopline-toolkit 插件
├── lib/index.js          # Cordis 插件:把 skills/* 注册到 ctx.skills
├── skills/               # 8 个 SHOPLINE 技能(SKILL.md 包;app-dev-doc-gaps 可撤回)
├── mcp/mcp.shopline.json # 开箱即用的 MCP 客户端配置(Cursor/Claude/DSH)
├── docs/                 # architecture.md · install.md
└── examples/prompts.md   # 可直接复制的提示词(中/英)

许可证

MIT。本项目与 SHOPLINE 无隶属关系;官方文档与 npm 包始终是权威依据。