@cnbcool/cnb-cli 1.0.0

package/.cnb.yml

@@ -0,0 +1,37 @@
+include:
+  # pr 评审后自动合并
+  - https://cnb.cool/cnb/cool/pipeline-templates/-/blob/main/.pipeline-for-pr.yml
+
+$:
+  vscode:
+    - docker:
+        # 指定开发环境镜像，可以是任意可访问的镜像。
+        # 如果 image 指定的镜像中已安装 code-server 代码服务，将使用单容器模式启动开发环境
+        # 如果 image 指定的镜像中未安装 code-server 代码服务，将使用双容器模式启动开发环境
+        # 如下镜像为 CNB 默认开发环境镜像，已安装代码服务，将使用单容器模式启动开发环境
+        # 可按需替换为其他镜像
+        image: cnbcool/default-codebuddy-cli-env:latest
+        volumes:
+          - node_modules
+      services:
+        - vscode
+        - docker
+      stages:
+        - name: install
+          script: npm install
+  # tag push 时触发
+  tag_push:
+    - docker:
+        image: node:22
+      stages:
+      - name: Update version
+        # 修改 package.json 中的version为当前tag，但不会提交代码
+        script: npm version $CNB_BRANCH --no-git-tag-version
+      
+      - name: npm publish
+        image: tencentcom/npm
+        imports: https://cnb.cool/cnb-secrets/secrets/-/blob/main/envs/npm_cnbcool.yml
+        settings:
+          token: $NPM_TOKEN
+          folder: ./
+          fail_on_version_conflict: true

package/DEVELOPMENT.md

@@ -0,0 +1,345 @@
+# 本地开发指南
+
+本文档面向参与 CNB Skills 仓库开发的贡献者，介绍如何搭建本地开发环境、理解项目结构和进行日常开发调试。
+
+## 环境准备
+
+### 系统要求
+
+| 依赖 | 版本要求 | 说明 |
+|------|----------|------|
+| Node.js | >= 20.x | 推荐使用 LTS 版本 |
+| npm | >= 10.x | 随 Node.js 自带 |
+| Git | >= 2.x | 代码版本管理 |
+| Docker | 可选 | 部分 skill（如 cnb-code-import、artifact-migrate）需要 Docker 环境 |
+
+### 初始化
+
+```bash
+# 克隆仓库
+git clone https://cnb.cool/cnb/skills/cnb-skill.git
+cd cnb-skill
+
+# 安装依赖
+npm install
+```
+
+### 环境变量
+
+在项目根目录创建 `.env` 文件（或者在 shell 中 export），配置以下变量：
+
+| 变量名 | 描述 | 是否必需 | 示例值 |
+|--------|------|----------|--------|
+| `CNB_TOKEN` | CNB 平台访问凭证 | **必须** | 在 CNB 平台的个人设置中生成 |
+| `CNB_API_ENDPOINT` | API 端点地址 | **必须** | `https://api.cnb.cool` |
+| `CNB_BRANCH` | 默认分支名 | 选填 | `main` |
+
+```bash
+export CNB_TOKEN="your-token-here"
+export CNB_API_ENDPOINT="https://api.cnb.cool"
+```
+
+## 项目结构
+
+```
+.
+├── skills/                         # 所有 skill 的根目录
+│   ├── cnb-skill/                  # CNB OpenAPI 交互（核心 skill）
+│   │   ├── SKILL.md                #   Skill 描述文件
+│   │   └── scripts/                #   脚本目录
+│   │       ├── core/               #     核心模块
+│   │       │   ├── index.js        #       CLI 入口 & 主逻辑
+│   │       │   ├── core.js         #       核心工具函数
+│   │       │   ├── shortcuts.js    #       快捷命令定义
+│   │       │   ├── help.json       #       OpenAPI 生成的帮助数据（~1.3MB）
+│   │       │   ├── config/         #       配置（内含 cag.config.js）
+│   │       │   └── utils/          #       工具函数
+│   │       └── modules/            #     API 模块（按资源类型分目录）
+│   │           ├── issues/         #       Issue 相关操作
+│   │           ├── pulls/          #       PR 相关操作
+│   │           ├── git/            #       Git 操作
+│   │           ├── build/          #       流水线构建
+│   │           ├── organizations/  #       组织管理
+│   │           ├── repositories/   #       仓库管理
+│   │           ├── members/        #       成员管理
+│   │           ├── registries/     #       制品库
+│   │           ├── releases/       #       发版管理
+│   │           └── ...             #       其他模块
+│   ├── cnb-code-import/            # 代码仓库批量迁移
+│   │   ├── SKILL.md
+│   │   └── scripts/migrate.sh
+│   ├── artifact-migrate/           # 制品批量迁移
+│   │   └── SKILL.md
+│   ├── code-review/                # PR 代码评审
+│   │   ├── SKILL.md
+│   │   └── hooks/hooks.json        #   PreToolUse 钩子
+│   ├── pr-diff/                    # PR diff 获取
+│   │   └── SKILL.md
+│   ├── pr-summary/                 # PR 变更总结
+│   │   └── SKILL.md
+│   ├── auto-code/                  # 自动编码并创建 PR
+│   │   ├── SKILL.md
+│   │   └── hooks/hooks.json        #   PreToolUse 钩子
+│   ├── dialog-ci-log/              # CI 流水线日志查询
+│   │   ├── SKILL.md
+│   │   └── scrips/get-failed-stage-logs.js
+│   ├── diagnose-pr-pipeline/       # PR 流水线故障诊断
+│   │   └── SKILL.md
+│   ├── tapd-resource-fetcher/      # Tapd 资源获取
+│   │   └── SKILL.md
+│   └── text-path-converter/        # 相对路径转绝对路径
+│       ├── SKILL.md
+│       └── scripts/convertLink.js
+├── bin/
+│   └── cnb.js                      # cnb-cli 可执行入口
+├── cag.config.js                   # OpenAPI 代码生成配置（根目录）
+├── package.json
+├── package-lock.json
+├── test.js
+├── .cnb.yml                        # CNB CI/CD 配置
+└── README.md
+```
+
+## NPM Scripts
+
+| 命令 | 说明 |
+|------|------|
+| `npm run link:all` | 将 `skills/` 下所有 skill 安装到本地 CodeBuddy（`--copy` 模式） |
+| `npm run link:skill` | 交互式选择 skill 安装到本地 CodeBuddy |
+| `npm run gen:skill` | 基于 OpenAPI Swagger 重新生成 cnb-skill 的 scripts 代码 |
+
+## 开发流程
+
+### 1. 安装 Skill 到本地 CodeBuddy
+
+开发过程中，需要将 skill 安装到本地 CodeBuddy 才能测试效果：
+
+```bash
+# 安装所有 skill
+npm run link:all
+
+# 或只安装指定 skill（交互式选择）
+npm run link:skill
+
+# 或直接用 npx 命令安装指定 skill
+npx skills add ./skills --agent codebuddy --copy -y --skill cnb-skill
+```
+
+> **说明**：`--copy` 参数会将文件拷贝到 `~/.codebuddy/skills/` 目录下，修改源代码后需要重新执行安装命令来更新。
+
+### 2. 修改 SKILL.md
+
+每个 skill 的核心是 `SKILL.md` 文件，它包含两部分：
+
+**YAML Frontmatter**（必须）：
+
+```yaml
+---
+name: my-skill                    # Skill 唯一标识（必须）
+description: 这个 skill 做什么    # Skill 描述（必须，用于 AI 触发匹配）
+allowed-tools: Bash,Read,Write    # 允许使用的工具列表（可选）
+requires:                         # 运行依赖（可选）
+  bins: [node]
+  files: [scripts/xxx.js]
+---
+```
+
+**Markdown 正文**：Skill 的详细行为指令，AI 会完整阅读并按照其中的步骤执行。
+
+### 3. 开发带脚本的 Skill
+
+如果 skill 需要调用自定义脚本（如 `cnb-skill`、`text-path-converter`、`dialog-ci-log`），脚本放在对应 skill 的 `scripts/` 目录中。
+
+在 SKILL.md 中通过以下方式引用脚本：
+
+```markdown
+## 执行步骤
+
+调用以下脚本进行处理：
+
+\```bash
+node ~/.codebuddy/skills/<skill-name>/scripts/your-script.js "$arg1" "$arg2"
+\```
+```
+
+> **注意**：安装后脚本路径为 `~/.codebuddy/skills/<skill-name>/scripts/`，编写 SKILL.md 时需使用安装后的路径。
+
+### 4. 开发带 Hooks 的 Skill
+
+Hooks 用于在 AI 对话中自动触发 skill。当前支持的 hook 类型是 `PreToolUse`。
+
+在 skill 目录下创建 `hooks/hooks.json`：
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "(?i)(关键词1|关键词2).*操作描述",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "检测到用户意图，请使用 xxx 技能来完成任务。"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+**`matcher`** 是正则表达式，匹配用户输入。当匹配成功时，`prompt` 中的内容会被注入到 AI 的上下文中。
+
+### 5. 重新生成 cnb-skill（OpenAPI 代码生成）
+
+`cnb-skill` 的 `scripts/modules/` 下的代码是基于 CNB OpenAPI Swagger 自动生成的。
+
+生成配置分为两个层级：
+
+- **根目录** `cag.config.js`：开发时使用的配置，`skillsOutputDir` 指向 `./skills/cnb-skill`
+- **skill 内** `scripts/core/config/cag.config.js`：安装到用户机器后使用的配置，`skillsOutputDir` 指向 `./skills`
+
+当 OpenAPI 有更新时，执行重新生成：
+
+```bash
+# 使用根目录的 cag.config.js 重新生成
+npm run gen:skill
+```
+
+生成后检查 `skills/cnb-skill/scripts/modules/` 下的变更是否正确，然后重新安装到本地测试：
+
+```bash
+npm run link:all
+```
+
+### 6. 添加新的 Skill
+
+在 `skills/` 目录下创建新的子目录：
+
+```bash
+mkdir -p skills/my-new-skill
+```
+
+创建 `SKILL.md`（必须）：
+
+```markdown
+---
+name: my-new-skill
+description: 描述你的 skill 功能，要足够准确以便 AI 触发匹配
+---
+
+# My New Skill
+
+## 使用场景
+
+描述何时应该使用这个 skill。
+
+## 执行步骤
+
+### 1. 第一步
+...
+
+### 2. 第二步
+...
+```
+
+如果需要脚本，创建 `scripts/` 目录并放入脚本文件。如果需要 hooks，创建 `hooks/hooks.json`。
+
+完成后安装并测试：
+
+```bash
+npx skills add ./skills --agent codebuddy --copy -y --skill my-new-skill
+```
+
+最后记得更新 `README.md` 中的 skill 列表。
+
+## Skill 间依赖关系
+
+部分 skill 之间存在依赖调用关系：
+
+```
+code-review ──依赖──▶ pr-diff ──依赖──▶ cnb-skill
+pr-summary  ──依赖──▶ pr-diff ──依赖──▶ cnb-skill
+auto-code   ──依赖──▶ cnb-skill
+diagnose-pr-pipeline ──依赖──▶ cnb-skill
+dialog-ci-log ──依赖──▶ cnb-skill
+text-path-converter  ──被──▶ cnb-skill 使用（响应转换器）
+```
+
+> **提示**：开发涉及上下游依赖的 skill 时，确保相关 skill 都已安装到本地。
+
+## cnb-cli 调试
+
+`bin/cnb.js` 是 cnb-cli 的入口文件，全局安装后可通过 `cnb` 命令使用。本地调试方式：
+
+```bash
+# 直接运行
+node bin/cnb.js --help
+
+# 或者通过 npm link 使 cnb 命令可用
+npm link
+cnb --help
+```
+
+## CI/CD 发布
+
+项目通过 `.cnb.yml` 配置了自动发布流程：
+
+- **Tag Push 触发**：当推送新的 Git tag 时，会自动将 cnb-cli 发布到 CNB NPM Registry
+- 发布流程：自动更新 `package.json` 版本号 → 发布到 `https://npm.cnb.cool/cnb/skills/cnb-cli/-/packages/`
+
+发版步骤：
+
+```bash
+# 创建并推送 tag
+git tag v1.2.3
+git push origin v1.2.3
+```
+
+## 常见问题
+
+### Q: 修改了 SKILL.md 但 CodeBuddy 没有生效？
+
+Skill 安装使用 `--copy` 模式，修改源文件后需要重新执行安装命令：
+
+```bash
+npm run link:all
+```
+
+### Q: `npm run gen:skill` 报错？
+
+检查 `cag.config.js` 中的 `target` URL 是否可访问。该 URL 指向 CNB OpenAPI 的 Swagger JSON：
+
+```
+https://api.cnb.cool/swagger.json
+```
+
+如果在外网环境开发，可能需要配置代理或使用本地缓存的 swagger.json。
+
+### Q: 如何只测试单个 skill？
+
+```bash
+npx skills add ./skills --agent codebuddy --copy -y --skill <skill-name>
+```
+
+### Q: Hooks 不触发怎么办？
+
+1. 检查 `hooks/hooks.json` 的 JSON 格式是否正确
+2. 检查 `matcher` 正则表达式是否能匹配用户输入
+3. 确保 skill 已安装到本地（`npm run link:all`）
+4. 在 CodeBuddy 中重新加载 skill（可能需要重启）
+
+### Q: 如何查看已安装的 skill 列表？
+
+```bash
+ls ~/.codebuddy/skills/
+```
+
+### Q: Docker 相关的 skill 本地怎么测试？
+
+`cnb-code-import` 和 `artifact-migrate` 需要 Docker 环境。确保本地安装了 Docker 并可正常运行：
+
+```bash
+docker --version
+docker run --rm hello-world
+```

package/LICENSE.md

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright (c) 2024-present, cnb.cool
+
+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/README.md

@@ -0,0 +1,119 @@
+# CNB Skills
+
+CNB 平台技能集合，在一个仓库中维护多个 CodeBuddy Skill，可通过 `npx skills` 便捷安装。
+
+## 包含的 Skills
+
+| Skill | 描述 |
+|-------|------|
+| **cnb-skill** | 提供与 CNB OpenAPI 的完整交互能力，支持项目、组织、代码仓库、Issue、PR、流水线、制品库等操作 |
+| **cnb-code-import** | 批量迁移代码仓库到 CNB 平台，支持 GitHub、GitLab、CODING、Gitee 等主流平台 |
+| **artifact-migrate** | CNB 制品批量迁移工具，支持 Maven、NPM、Docker 等多种制品类型迁移 |
+| **code-review** | PR 代码评审，提供标准化评审流程和行级评论 |
+| **pr-diff** | 获取 PR 的 diff 变更信息 |
+| **pr-summary** | PR 变更总结，生成结构化的变更说明 |
+| **auto-code** | 自动编码并创建/更新 PR |
+| **dialog-ci-log** | 查询 CI 流水线的错误日志 |
+| **diagnose-pr-pipeline** | 获取 PR 触发的 CI 报错详细信息 |
+| **tapd-saas-resource-fetcher-skills** | 获取 Tapd SaaS 资源（需求、缺陷、任务、迭代） |
+| **CNB-Text-Relative-Path-Converter** | 将 ISSUE/PR 内容中的相对路径转换为绝对路径 |
+
+## 运行环境要求
+
+- Node.js 20.x 及以上版本
+
+## 安装方式
+
+### 一键安装所有 Skill
+
+```bash
+npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill '*' --agent codebuddy -y
+```
+
+### 只安装指定的 Skill
+
+```bash
+# 列出所有可用的 Skill
+npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --list
+
+# 安装单个 Skill
+npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill cnb-skill --agent codebuddy -y
+
+# 安装多个指定 Skill
+npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill cnb-skill --skill code-review --skill pr-diff --agent codebuddy -y
+```
+
+### 使用 cnb-skill 还需安装 cnb-cli
+
+```bash
+npm install cnb-cli --registry=https://npm.cnb.cool/cnb/skills/cnb-cli/-/packages/ -g
+```
+
+安装完成后运行 `cnb --help` 验证是否安装成功。
+
+## AI 安装提示词
+
+将以下提示词复制后发送给 AI 智能体（如 CodeBuddy），即可自动完成所有安装：
+
+```
+请帮我安装 CNB Skills 的运行环境，依次执行以下步骤：
+
+1. 全局安装 cnb-cli：
+   npm install cnb-cli --registry=https://npm.cnb.cool/cnb/skills/cnb-cli/-/packages/ -g
+   安装完成后运行 cnb --help 验证是否安装成功。
+
+2. 全局安装 skills 工具：
+   npm install skills -g
+
+3. 通过 skills 工具安装所有 skill 到当前工作目录：
+   npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill '*' --agent codebuddy -y --copy
+
+每一步执行完后告诉我结果，如果有报错请帮我解决。
+```
+
+## 本地开发
+
+```bash
+# 安装依赖
+npm install
+
+# 本地链接所有 Skill（开发调试用）
+npm run link:all
+
+# 重新生成 cnb-skill（基于 OpenAPI Swagger）
+npm run gen:skill
+```
+
+## 目录结构
+
+```
+.
+├── skills/
+│   ├── cnb-skill/              # CNB OpenAPI 交互
+│   ├── cnb-code-import/        # 代码仓库批量迁移
+│   ├── artifact-migrate/       # 制品批量迁移
+│   ├── code-review/            # PR 代码评审
+│   ├── pr-diff/                # PR diff 获取
+│   ├── pr-summary/             # PR 变更总结
+│   ├── auto-code/              # 自动编码
+│   ├── dialog-ci-log/          # CI 日志查询
+│   ├── diagnose-pr-pipeline/   # PR 流水线诊断
+│   ├── tapd-resource-fetcher/  # Tapd 资源获取
+│   └── text-path-converter/    # 路径转换器
+├── bin/
+│   └── cnb.js                  # cnb-cli 入口
+├── package.json
+└── cag.config.js               # OpenAPI 生成配置
+```
+
+## 环境变量
+
+| 变量名 | 描述 | 是否必需 | 示例值 |
+|--------|------|----------|--------|
+| CNB_TOKEN | 访问凭证 | 必须 | - |
+| CNB_API_ENDPOINT | API端点地址 | 必须 | https://api.cnb.cool |
+| CNB_BRANCH | 默认分支 | 选填 | main |
+
+## 关键词
+
+CNB、云原生构建、组织、代码仓库、Issue、PR、合并请求、流水线、制品库、代码迁移、制品迁移、代码评审、CI/CD

package/bin/cnb.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require("../skills/cnb-skill/scripts/core/index.js");

package/cag.config.js

@@ -0,0 +1,57 @@
+module.exports = {
+  target: 'https://api.cnb.cool/swagger.json',
+  skillsOutputDir: `./skills/cnb-skill`,
+  // skillsDev: true,
+  skillConfig: {
+    fetchConfig: {
+      responseConverter: {
+        'get@/{repo}/-/issues/{number}': {
+          converter: 'convert-link',
+          handler: (handler, fetchOriginParams, data) => {
+            data.body = handler(data.body, fetchOriginParams.path.repo);
+            return data
+          }
+        },
+        'get@/{repo}/-/issues/{number}/comments/{comment_id}': {
+          converter: 'convert-link',
+          handler: (handler, fetchOriginParams, data) => {
+            data.body = handler(data.body, fetchOriginParams.path.repo);
+            return data
+          }
+        },
+        'get@/{repo}/-/issues/{number}/comments': {
+          converter: 'convert-link',
+          handler: (handler, fetchOriginParams, data) => {
+            for (let i = 0; i < data.length; i++) {
+              data[i].body = handler(data[i].body, fetchOriginParams.path.repo);
+            }
+            return data
+          }
+        },
+        'get@/{repo}/-/pulls/{number}': {
+          converter: 'convert-link',
+          handler: (handler, fetchOriginParams, data) => {
+            data.body = handler(data.body, fetchOriginParams.path.repo);
+            return data
+          }
+        },
+        'get@/{repo}/-/pulls/{number}/comments/{comment_id}': {
+          converter: 'convert-link',
+          handler: (handler, fetchOriginParams, data) => {
+            data.body = handler(data.body, fetchOriginParams.path.repo);
+            return data
+          }
+        },
+        'get@/{repo}/-/pulls/{number}/comments': {
+          converter: 'convert-link',
+          handler: (handler, fetchOriginParams, data) => {
+            for (let i = 0; i < data.length; i++) {
+              data[i].body = handler(data[i].body, fetchOriginParams.path.repo);
+            }
+            return data
+          }
+        },
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@cnbcool/cnb-cli",
+  "version": "1.0.0",
+  "description": "CNB Skill",
+  "main": "skills/cnb-skill/scripts/index.js",
+  "scripts": {
+    "link:all": "npx skills add ./skills --agent codebuddy --copy -y --skill '*'",
+    "link:skill": "npx skills add ./skills --agent codebuddy --copy -y",
+    "gen:skill": "npx csg"
+  },
+  "bin": {
+    "cnb": "bin/cnb.js"
+  },
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@cnbcool/cnb-api-generate": "^1.0.0",
+    "skills": "^1.4.4"
+  }
+}

package/skills/artifact-migrate/README.md

@@ -0,0 +1,79 @@
+
+# Skill：CNB 制品批量迁移工具
+
+## 📌 基本信息
+
+| 字段 | 值 |
+|------|------|
+| **名称** | artifact-migrate |
+| **版本** | 1.0.0 |
+| **作者** | CNB Team |
+| **适用平台** | OpenClaw / CoeBuddy 及其他兼容智能体平台 |
+| **许可证** | MIT |
+
+## 🎯 Skill 目标
+
+该 Skill 提供一个 Docker 化的制品批量迁移工具，帮助用户将 **Maven、NPM、Docker、NuGet、Composer、PyPI、Conan、Cargo** 等多种类型的制品，从 **CODING / CNB / CodeUp / Nexus / Jfrog / TCR / 标准协议仓库**一键迁移至 **CNB 制品仓库**。
+
+工具内置以下高级特性：
+- ✅ **断点续传**：中断后再次运行可自动从断点继续，优先重试失败制品
+- ✅ **正则过滤**：通过包含/排除正则灵活控制迁移范围
+- ✅ **并发迁移**：生产者-消费者模式，支持配置并发数（最大 256）
+- ✅ **增量迁移**：自动跳过目标仓库已存在的版本
+- ✅ **统计报告**：迁移结束自动输出总数 / 成功数 / 存在数 / 忽略数 / 错误数
+
+## 📋 支持矩阵
+
+### 制品类型 × 源仓库平台
+
+| 制品类型 | CODING | CNB | CodeUp | Nexus | Jfrog | TCR | Other |
+|----------|:------:|:---:|:------:|:-----:|:-----:|:---:|:-----:|
+| Maven | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ | ✓ |
+| NPM | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ | ✓ |
+| Docker | ✓ | ✓ | ✗ | ✓ | ✓ | ✓ | ✓ |
+| NuGet | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ | ✓ |
+| Composer | ✓ | ✓ | ✗ | ✗ | ✓ | ✗ | ✓ |
+| PyPI | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ | ✓ |
+| Conan | ✓ | ✓ | ✗ | ✓ | ✓ | ✗ | ✗ |
+| Cargo | ✗ | ✓ | ✗ | ✓ | ✓ | ✗ | ✓ |
+
+## 🔧 前置条件
+
+| 条件 | 说明 |
+|------|------|
+| Docker ≥ 19.03 | 或 Podman ≥ 3.0，用于运行迁移工具容器 |
+| 源仓库读取权限 | 用户名 + 密码/Token（公开仓库可不填） |
+| 目标仓库写入权限 | CNB 制品仓库的访问 Token |
+
+## 🚀 快速开始
+
+```bash
+docker run --rm \
+  -e ARTIFACT_TYPE=npm \
+  -e SRC_REGISTRY_TYPE=coding \
+  -e SRC_REGISTRY_URL="https://example-npm.pkg.coding.net/my-project/my-repo/" \
+  -e SRC_REGISTRY_USERNAME="my-username" \
+  -e SRC_REGISTRY_PASSWORD=xxx \
+  -e SRC_CODING_DISABLE_THIRD_PACKAGE=true \
+  -e TAR_REGISTRY_URL="https://npm.cnb.cool/my-project2/my-repo2/-/packages/" \
+  -e TAR_REGISTRY_PASSWORD=xxx \
+  -u root \
+  -v $(pwd)/log:/app/log \
+  docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest
+```
+
+## 📖 详细文档
+
+完整的 Skill 文档请查看 [skill.md](skill/skill.md)，包含：
+
+- ⚙️ 完整参数说明（25+ 个配置参数）
+- 🚀 详细使用步骤
+- 📝 5 个完整示例（全量迁移 / 正则过滤 / Docker 迁移 / 断点续传 / 云原生构建）
+- 🔄 迁移流程图
+- 🧩 核心架构与逻辑说明
+- ⚠️ 注意事项与常见错误排查
+- 📊 输出结果说明与智能体总结模板
+
+## 🏷️ 标签
+
+`artifact` `migration` `devops` `cicd` `docker` `maven` `npm` `nuget` `pypi` `composer` `conan` `cargo`