@cnbcool/cnb-cli 1.0.0

package/skills/tapd-resource-fetcher/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: tapd-saas-resource-fetcher-skills
+description: 获取 Tapd SaaS 环境资源。当用户提供 Tapd 链接或提及 Tapd 需求/缺陷/任务/迭代时使用。支持获取需求(story)、缺陷(bug)、任务(task)、迭代(iteration)类型资源，调用接口获取完整资源数据以供分析。
+allowed-tools: Bash,curl
+---
+
+# 获取 Tapd SaaS 资源
+
+当用户提供 Tapd 链接时，识别资源类型和 ID，调用接口获取完整资源数据，供后续分析使用。
+
+## 执行步骤
+
+### 1. 识别 Tapd 资源链接
+
+从用户输入中识别 Tapd 链接，支持以下格式：
+
+`https://www.tapd.cn/tapd_fe/{workspace_id}/{resource_type}/detail/{resource_id}`
+
+- resource_type 为资源类型。 可取值为 story、bug、task、iteration
+- workspace_id 为项目 ID
+- resource_id 为资源 ID
+
+对于给出的链接，提取 workspace_id 和 resource_type，resource_id, 用于之后的请求资源。
+
+
+### 2. 调用接口获取资源数据
+
+**重要**：请求前需替换 `{workspace_id}`, `{resource_type}`, `{resource_id}`
+
+对每个识别到的资源，按照以下方式获取资源数据：
+
+```bash
+curl -X GET "{$CNB_API_ENDPOINT}/tapd/reference/{workspace_id}/{resource_type}/{resource_id}" \
+-H "Accept: application/vnd.cnb.api+json" \
+-H "Authorization: Bearer $CNB_TOKEN" \
+-H "Content-Type: application/json"
+```
+
+**示例** https://www.tapd.cn/tapd_fe/64201929/story/detail/1164201929001000017, 其中 workspace_id 为 64201929，resource_type 为 story，id 为 1164201929001000017。
+请求接口如下：
+```bash
+curl -X GET "{$CNB_API_ENDPOINT}/tapd/reference/64201929/story/1164201929001000017" \
+-H "Accept: application/vnd.cnb.api+json" \
+-H "Authorization: Bearer $CNB_TOKEN" \
+-H "Content-Type: application/json"
+```
+
+### 3. 结果返回
+API 返回标准的 JSON 格式响应。请根据 HTTP 状态码判断请求是否成功：
+
+- 200: 请求成功
+- 400: 请求参数错误
+- 401: 未授权
+- 403: 禁止访问
+- 404: 资源不存在
+- 500: 服务器内部错误
+
+当本地调用返回的 `status` 在 200 ~ 299 之间，需要进一步检查响应体中的 `data` 字段：
+- 如果 `data` 包含有效数据，返回 `data` 内容给用户。
+- 如果 `data` 为空数组 `[]`，说明 TAPD 侧未找到对应资源，按照 3.1 节中的"数据为空"场景提示用户。
+
+只有当 `status >= 300` 时，才将 `status` 和 `trace` 返回给用户。
+#### 3.1 错误处理与用户提示
+
+**情况一：HTTP 状态码 >= 300**
+
+响应体为 JSON 格式：`{"errcode": <错误码>, "errmsg": "<错误信息>"}`。
+
+**请根据 `errcode` 给出对应的用户友好提示**：
+
+| errcode | 含义 | 用户侧友好提示 |
+|---------|------|----------------|
+| `2000076` | TAPD 功能未启用 | 当前项目未启用 TAPD 集成功能，请联系项目管理员在项目设置中开启 TAPD 集成。 |
+| `2000073` | 未找到 TAPD 绑定信息 | 你尚未绑定 TAPD 账号，请先前往个人设置页面绑定 TAPD 账号后再试。 |
+| `2000074` | 获取 TAPD 访问令牌失败 | TAPD 授权信息已过期或无效，请重新绑定 TAPD 账号后再试。 |
+| `2000075` | 获取 TAPD 资源详情失败 | 无法获取该 TAPD 资源，可能是你没有对应项目的访问权限，或者资源 ID 不正确，请检查链接后重试。 |
+| `401` | 未授权 | 请先登录 CNB 平台后再使用此功能。 |
+| `403` | 禁止访问 | 你没有权限访问该资源。 |
+| `404` | 资源不存在 | 未找到对应的资源，请检查链接中的项目 ID 和资源 ID 是否正确。 |
+| 其他 | 未知错误 | 请求失败，请稍后重试。如果问题持续存在，请联系管理员并提供 trace 信息。 |
+
+**情况二：HTTP 200 但 `data` 为空数组**
+
+当 HTTP 状态码为 200，响应体格式为 `{"status": 1, "data": [], "info": "success"}`，`data` 为空数组 `[]` 时，说明 TAPD 接口调用成功但未查询到对应资源。
+
+此时应给出提示：**未找到该 TAPD 资源，请检查链接中的资源 ID 是否正确。**
+
+**注意**：给出用户提示时，不要暴露内部实现细节（如具体的错误堆栈、用户 ID 等），只提供操作引导。
+
+
+### 4. 多资源处理
+
+若用户提供多个 Tapd 链接，**逐个**调用接口获取，每次只请求一个资源：
+
+1. 提取所有链接中的资源 ID 列表
+2. 按顺序逐一调用接口，每次获取一个资源
+3. 汇总所有资源数据后统一展示

package/skills/text-path-converter/README.md

@@ -0,0 +1,3 @@
+# cnb-text-relative-path-converter-skills
+
+用于AI对cnb内的资源使用相对路径的补全

package/skills/text-path-converter/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: CNB-Text-Relative-Path-Converter
+description: 读取 CNB (Cloud Native Build) ISSUE 或合并请求的内容时使用。将描述、评论、Review 中包含的相对路径（如 `./src/foo.ts`）转换为绝对路径，避免因路径歧义导致误读，支持纯文本与 Markdown 格式。
+requires:
+  bins: [node]
+  files: [scripts/convertLink.js]
+---
+
+# CNB 文本相对路径转换器
+
+## 使用方式
+
+获取到 ISSUE 或合并请求的描述、评论、Review 的原始内容后，执行以下脚本进行转换。脚本会将所有相对路径替换为绝对路径，并将转换结果输出到标准输出。
+
+```bash
+# 执行转换，结果输出到标准输出
+node scripts/convertLink.js <在此粘贴原始内容>
+```
+
+## 示例
+
+**转换前：**
+```
+请参考 ./src/utils/helper.ts 中的实现，以及 ../docs/api.md 的说明。
+```
+
+**转换后：**
+```
+请参考 https://cnb.cool/cnb/cool/default-npc-agent/-/git/raw/main/src/utils/helper.ts 中的实现，以及 https://cnb.cool/cnb/cool/default-npc-agent/-/git/raw/main/docs/api.md 的说明。
+```

package/skills/text-path-converter/scripts/convertLink.js

@@ -0,0 +1,148 @@
+/**
+ * 把文本里的相对路径转换为绝对路径
+ * 与 src/helpers/convertLink.ts 逻辑一致
+ *
+ * @param {String} text 待转换的文本
+ * @param {String} repoSlug 仓库路径
+ * @param {String} branchOrSha 可选，分支或SHA
+ * @returns {String}
+ */
+function convertLink(text, repoSlug, branchOrSha) {
+  // 查询所有代码块的位置
+  let codeBlockPositions = [];
+  let index = 0;
+  while (index !== -1) {
+    const nextIndex = text.indexOf('```', index);
+    if (nextIndex === -1) break;
+    codeBlockPositions.push(nextIndex);
+    index = nextIndex + 3; // 跳过已匹配的三个反引号
+  }
+  if (codeBlockPositions.length % 2 !== 0) {
+    codeBlockPositions = codeBlockPositions.slice(0, codeBlockPositions.length - 1);
+  }
+
+  // 查询所有行内代码块的位置
+  let inlineCodeBlockPositions = [];
+  index = 0;
+  while (index < text.length) {
+    const nextIndex = text.indexOf('`', index);
+    if (nextIndex === -1) break;
+    // 检查是否是单独的反引号（不是代码块的一部分）
+    if (
+      (nextIndex === 0 || text.charAt(nextIndex - 1) !== '`') &&
+      (nextIndex === text.length - 1 || text.charAt(nextIndex + 1) !== '`')
+    ) {
+      inlineCodeBlockPositions.push(nextIndex);
+    }
+    index = nextIndex + 1;
+  }
+  if (inlineCodeBlockPositions.length % 2 !== 0) {
+    inlineCodeBlockPositions = inlineCodeBlockPositions.slice(0, inlineCodeBlockPositions.length - 1);
+  }
+
+  // 整理起始和结束位置
+  const excludedRanges = [...codeBlockPositions, ...inlineCodeBlockPositions].reduce((result, item, index) => {
+    if (index % 2 === 0) {
+      return result.concat([[item]]);
+    } else {
+      result[result.length - 1].push(item);
+      return result;
+    }
+  }, []);
+
+  // Helper function to check if an index is within excluded ranges
+  const isInExcludedRange = (index) => {
+    return excludedRanges.some(([start, end]) => index >= start && index < end);
+  };
+
+  let match;
+
+  // Collect all replacements with their positions
+  const replacements = [];
+
+  // Match markdown links and images: [alt](url), [](url), ![alt](url) and ![](url)
+  const markdownLinkRegex = /!?\[([^\]]*)\]\(([^)]+)\)/g;
+  while ((match = markdownLinkRegex.exec(text)) !== null) {
+    if (!isInExcludedRange(match.index)) {
+      // Calculate URL position: match.index + length of "![" + match[1] + "]("
+      const prefixLength = (match[0].startsWith('!') ? 1 : 0) + 1 + match[1].length + 2;
+      const urlStart = match.index + prefixLength;
+      const urlEnd = urlStart + match[2].length;
+      const newUrl = normaliseLink(match[2], repoSlug, branchOrSha);
+      if (newUrl !== match[2]) {
+        replacements.push({ start: urlStart, end: urlEnd, newUrl });
+      }
+    }
+  }
+
+  // Match HTML tags: <img src="..."> and <a href="...">
+  const htmlTagRegex = /\s(src|href)=["']([^"']+)["']/gi;
+  while ((match = htmlTagRegex.exec(text)) !== null) {
+    if (!isInExcludedRange(match.index)) {
+      const urlStart = match.index + match[0].indexOf(match[2]);
+      const urlEnd = urlStart + match[2].length;
+      const newUrl = normaliseLink(match[2], repoSlug, branchOrSha);
+      if (newUrl !== match[2]) {
+        replacements.push({ start: urlStart, end: urlEnd, newUrl });
+      }
+    }
+  }
+
+  // Sort replacements by start position in descending order
+  replacements.sort((a, b) => b.start - a.start);
+
+  // Apply replacements from end to start to maintain correct indices
+  let result = text;
+  for (const { start, end, newUrl } of replacements) {
+    result = result.substring(0, start) + newUrl + result.substring(end);
+  }
+
+  return result;
+}
+
+/**
+ * 相对路径转换为绝对路径
+ * 与 src/helpers/convertLink.ts 逻辑一致
+ *
+ * @param {String} link 待转换的链接
+ * @param {String} repoSlug 仓库路径
+ * @param {String} branchOrSha 分支或SHA，默认为 HEAD
+ * @returns {String}
+ */
+function normaliseLink(link, repoSlug, branchOrSha = 'HEAD') {
+  const { CNB_WEB_ENDPOINT } = process.env;
+  const baseURL = `${CNB_WEB_ENDPOINT}/${repoSlug}`;
+
+  if (link.startsWith('/-/')) {
+    return `${baseURL}${link}`;
+  }
+
+  if (
+    link.indexOf('/-/') === -1 &&
+    (
+      link.startsWith('../') ||
+      link.startsWith('./') ||
+      (link.startsWith('/') && !link.startsWith('//'))
+    )
+  ) {
+    let chunks = link.split('/');
+    // 过滤掉空字符串和 . .. 这些无效路径
+    chunks = chunks.filter((chunk) => !!chunk && chunk !== '.' && chunk !== '..');
+    if (chunks.length === 0) {
+      return link;
+    }
+    chunks.unshift(branchOrSha);
+    return `${baseURL}/-/git/raw/${chunks.join('/')}`;
+  }
+
+  return link;
+}
+
+// =======
+// 开始执行
+// =======
+
+const args = process.argv.slice(2);
+const text = args[0] ?? '';
+const content = convertLink(args[0], process.env.CNB_REPO_SLUG, process.env.CNB_BRANCH);
+console.log(content);

package/test.js

@@ -0,0 +1 @@
+console.log(123)