shoplazza-ai-dev-cli 0.1.0

package/README.md

@@ -0,0 +1,113 @@
+# shoplazza-ai-dev-cli
+
+Shoplazza Forge 的 skill CLI——为 Claude Code / Cursor / Codex 安装、发布、管理 AI agent 的 skill 与 rule。
+
+> Based on [vercel-labs/skills](https://github.com/vercel-labs/skills) (MIT). 二开内容详见 `docs/superpowers/specs/2026-04-21-ai-dev-cli-design.md`。Third-party 归属见 `ThirdPartyNoticeText.txt`。
+
+---
+
+## 快速开始
+
+```bash
+# 安装一个公共 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/` |
+
+---
+
+## 开发
+
+```bash
+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 自动）：
+
+```bash
+npm publish --registry https://gitlab.shoplazza.site/api/v4/packages/npm/
+```
+
+---
+
+## License
+
+MIT，见根仓库 LICENSE。Fork 自 `vercel-labs/skills`，遵循其原 MIT 协议；上游版权与第三方依赖归属见 `ThirdPartyNoticeText.txt`。

package/ThirdPartyNoticeText.txt

@@ -0,0 +1,117 @@
+/*!----------------- Skills CLI ThirdPartyNotices -------------------------------------------------------
+
+The Skills CLI incorporates third party material from the projects listed below.
+The original copyright notice and the license under which this material was received
+are set forth below. These licenses and notices are provided for informational purposes only.
+
+---------------------------------------------
+Third Party Code Components
+--------------------------------------------
+
+================================================================================
+Package: @clack/prompts@0.11.0
+License: MIT
+Repository: https://github.com/bombshell-dev/clack
+--------------------------------------------------------------------------------
+
+MIT License
+
+Copyright (c) Nate Moore
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+================================================================================
+Package: picocolors@1.1.1
+License: ISC
+Repository: https://github.com/alexeyraspopov/picocolors
+--------------------------------------------------------------------------------
+
+ISC License
+
+Copyright (c) 2021-2024 Oleksii Raspopov, Kostiantyn Denysov, Anton Verinov
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+
+================================================================================
+Package: simple-git@3.30.0
+License: MIT
+Repository: https://github.com/steveukx/git-js
+--------------------------------------------------------------------------------
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+================================================================================
+Package: xdg-basedir@5.1.0
+License: MIT
+Repository: https://github.com/sindresorhus/xdg-basedir
+--------------------------------------------------------------------------------
+
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+================================================================================
+Package: yaml@2.8.3
+License: ISC
+Repository: https://github.com/eemeli/yaml
+--------------------------------------------------------------------------------
+
+Copyright Eemeli Aro <eemeli@gmail.com>
+
+Permission to use, copy, modify, and/or distribute this software for any purpose
+with or without fee is hereby granted, provided that the above copyright notice
+and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
+THIS SOFTWARE.
+
+
+================================================================================
+*/

package/bin/cli.mjs

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+
+import module from 'node:module';
+
+// https://nodejs.org/api/module.html#module-compile-cache
+if (module.enableCompileCache && !process.env.NODE_DISABLE_COMPILE_CACHE) {
+  try {
+    module.enableCompileCache();
+  } catch {
+    // Ignore errors
+  }
+}
+
+await import('../dist/cli.mjs');