@cnbcool/cnb-cli 1.0.0 → 1.0.1

package/README.md

@@ -46,7 +46,7 @@ npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill cnb-skill --ski
 ### 使用 cnb-skill 还需安装 cnb-cli
 
 ```bash
-npm install cnb-cli --registry=https://npm.cnb.cool/cnb/skills/cnb-cli/-/packages/ -g
+npm install @cnbcool/cnb-cli -g
 ```
 
 安装完成后运行 `cnb --help` 验证是否安装成功。
@@ -59,7 +59,7 @@ npm install cnb-cli --registry=https://npm.cnb.cool/cnb/skills/cnb-cli/-/package
 请帮我安装 CNB Skills 的运行环境，依次执行以下步骤：
 
 1. 全局安装 cnb-cli：
-   npm install cnb-cli --registry=https://npm.cnb.cool/cnb/skills/cnb-cli/-/packages/ -g
+   npm install @cnbcool/cnb-cli -g
    安装完成后运行 cnb --help 验证是否安装成功。
 
 2. 全局安装 skills 工具：
@@ -71,41 +71,6 @@ npm install cnb-cli --registry=https://npm.cnb.cool/cnb/skills/cnb-cli/-/package
 每一步执行完后告诉我结果，如果有报错请帮我解决。
 ```
 
-## 本地开发
-
-```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 生成配置
-```
-
 ## 环境变量
 
 | 变量名 | 描述 | 是否必需 | 示例值 |

package/package.json

@@ -1,16 +1,36 @@
 {
   "name": "@cnbcool/cnb-cli",
-  "version": "1.0.0",
-  "description": "CNB Skill",
-  "main": "skills/cnb-skill/scripts/index.js",
+  "version": "1.0.1",
+  "description": "CNB OpenAPI 命令行工具，基于 CNB 平台 Swagger 自动生成，支持 Issues、PR、Git、组织管理等全部 API 操作",
+  "main": "skills/cnb-skill/scripts/core/index.js",
+  "bin": {
+    "cnb": "bin/cnb.js"
+  },
+  "files": [
+    "bin/",
+    "skills/cnb-skill/scripts/"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "cnb",
+    "cli",
+    "openapi",
+    "devops",
+    "git",
+    "issues",
+    "pull-request"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://cnb.cool/cnb/cnb-cli"
+  },
   "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": {

package/.cnb.yml

@@ -1,37 +0,0 @@
-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

@@ -1,345 +0,0 @@
-# 本地开发指南
-
-本文档面向参与 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/cag.config.js

@@ -1,57 +0,0 @@
-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/skills/artifact-migrate/README.md

@@ -1,79 +0,0 @@
-
-# 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`