shoplazza-ai-dev-cli

Shoplazza Forge 的 skill CLI——为 Claude Code / Cursor / Codex 安装、发布、管理 AI agent 的 skill 与 rule。

Based on vercel-labs/skills (MIT). 二开内容详见 docs/superpowers/specs/2026-04-21-ai-dev-cli-design.md。Third-party 归属见 ThirdPartyNoticeText.txt。

快速开始

# 安装一个公共 skill 到当前项目（自动检测 agent）
npx shoplazza-ai-dev-cli add @public/skills --skill systematic-debugging

# 安装到全局
npx shoplazza-ai-dev-cli add @public/skills --skill <name> -g

# 安装到指定 agent
npx shoplazza-ai-dev-cli add @public/skills --skill <name> --agent claude-code cursor

# 装 team 名下指定 skill
npx shoplazza-ai-dev-cli add @teams/<scope>/skills --skill <name>

# 一次装该 team 所有 skill + rule
npx shoplazza-ai-dev-cli add @teams/<scope>

# 浏览器 SSO 登录（publish 前需要）
npx shoplazza-ai-dev-cli login

# 发布本地 skill 到 Forge 门户
npx shoplazza-ai-dev-cli publish ./my-skill --scope @teams/infra

命令一览

| 命令 | 说明 | |---|---| | add <source> | 安装 skill / rule。<source> 可以是 @public/...、@teams/<scope>/...、git URL 或本地路径 | | remove [skills] | 移除已安装 skill | | list / ls | 列出已安装 skill | | find [query] | 交互式搜索 | | update [skills...] | 升级到最新版本 | | init [name] | 初始化一个 skill 模板 | | login | 浏览器 SSO 换 CLI token | | publish <path> | 上传本地 skill 到门户审核 |

完整 flag 看 shoplazza-ai-dev-cli --help。

引用语法

| 写法 | 解析后 | |---|---| | @public/skills --skill <name> | Portal /api/cli/skills/archive 接口下载 tar.gz；CLI 不直连 GitLab。推荐写法，与 fork（vercel-labs/skills）一致 | | @public/rules --skill <name> | 同上，rule 类型 | | @teams/<scope>/skills --skill <name> | Portal 代理下载；需要 shoplazza-ai-dev-cli login 后取得 portal token | | @teams/<scope> | Portal 代理批量下载 team 名下所有 skill + rule；需要 shoplazza-ai-dev-cli login 后取得 portal token | | @public/skills/<name> | 旧写法，兼容保留；等价于 @public/skills --skill <name> | | @teams/<scope>/skills/<name> | 旧写法，兼容保留 | | <git-url> | 任意 git 仓库（如外部 vercel-labs/skills） | | ./local/path | 本地目录 |

@public/... 走匿名下载（portal 代理 GitLab），@teams/<scope>/... 需要先 shoplazza-ai-dev-cli login 拿 portal token；token 由 portal 用自己的 GitLab service token 代换文件，CLI 与终端用户都不直接持有 GitLab 凭证。

SSOT 仓的实际地址仍由门户接口 GET /api/cli/bootstrap 提供（用于 legacy / fallback 路径），对用户屏蔽。

配置

| 项 | 默认 | 覆盖方式 | |---|---|---| | 门户地址 | https://forge.shoplazza.site | SHOPLAZZA_FORGE_PORTAL 环境变量 / --portal flag | | token 存储 | ~/.ai-dev-cli/config.json（mode 0600） | login 命令写入 | | 埋点开关 | 默认开启 | shoplazza-ai-dev-cli config set telemetry_enabled false |

安装路径

| Agent | 项目级 | 全局级 | |---|---|---| | Claude Code | .claude/skills/ | ~/.claude/skills/ | | Cursor | .agents/skills/ | ~/.cursor/skills/ | | Codex | .agents/skills/ | ~/.codex/skills/ |

开发

cd cli
npm install        # 或 pnpm install
npm run dev -- add @public/skills/<name>   # 直接跑 src/cli.ts
npm test           # vitest
npm run type-check # tsc --noEmit
npm run build      # obuild → dist/

发布到内部 npm registry（CI 自动）：

npm publish --registry https://gitlab.shoplazza.site/api/v4/packages/npm/

License

MIT，见根仓库 LICENSE。Fork 自 vercel-labs/skills，遵循其原 MIT 协议；上游版权与第三方依赖归属见 ThirdPartyNoticeText.txt。