@cnbcool/cnb-cli 1.0.0

package/skills/cnb-skill/scripts/modules/workspace/workspace-stop.js

@@ -0,0 +1,66 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = _default;
+var _core = _interopRequireDefault(require("../../core/core.js"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// @ts-nocheck
+/* tslint:disable */
+/* eslint-disable */
+/*
+ * -------------------------------------------------------------------------
+ * ## THIS FILE WAS GENERATED VIA CNB-API-GENERATE                        ##
+ * ##                                                                     ##
+ * ## AUTHOR: bapelin                                                     ##
+ * ## SOURCE: https://cnb.woa.com/cnb/frontend-science/cnb-api-generate   ##
+ * -------------------------------------------------------------------------
+ * @Version 1.0.0
+ * @Source /workspace/stop
+ */
+
+/**
+ * @description Other reuqest params
+ */
+
+/**
+ * @description WorkspaceStopRes Success Response Type
+ */
+
+/**
+ * @description WorkspaceStopError Error Response Type
+ */
+
+/**
+* @description 访问令牌调用此接口需包含以下权限。Required permissions for access token. 
+* account-engage:rw
+* @tags Workspace
+* @name workspaceStop
+* @summary 停止/关闭我的云原生开发环境。Stop/close my workspace.
+* @request post:/workspace/stop
+
+----------------------------------
+* @param {DtoWorkspaceStopReq} arg0
+* @param {RequestConfig} arg1 - Other reuqest params
+*/
+async function _default(request, {
+  req,
+  options,
+  ...axiosConfig
+} = {}) {
+  return await _core.default.request({
+    ...axiosConfig,
+    _next_req: req,
+    options: options,
+    url: "/workspace/stop",
+    _apiTag: "/workspace/stop",
+    method: "post",
+    data: request,
+    _originParams: {
+      method: "post",
+      _apiTag: "/workspace/stop",
+      body: request
+    }
+  });
+}

package/skills/code-review/README.md

@@ -0,0 +1,3 @@
+# code-review-skill
+
+PR 代码评审。当用户请求 review、评审、审查代码或 PR 时使用。此技能提供标准化评审流程：获取 diff、按优先级检查安全漏洞/Bug/代码质量、输出结构化 JSON 结果、通过 API 发送行级评论。

package/skills/code-review/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: code-review
+description: PR 代码评审。当用户请求 review、评审、审查代码或 PR 时使用。此技能提供标准化评审流程：获取 diff、按优先级检查安全漏洞/Bug/代码质量、输出结构化 JSON 结果、通过 API 发送行级评论。
+allowed-tools: Bash,Read,Glob,Grep
+---
+
+# PR 代码评审
+
+对 PR 的代码变更进行专业评审，发现安全漏洞、Bug、代码质量和性能问题，并通过 PR Review API 发送行级评论。
+
+## 评审步骤
+
+### 1. 获取 PR 变更
+
+使用 pr-diff Skill 获取 PR 的代码变更。
+
+**需过滤的非代码文件**（不评审）：
+- 依赖锁文件：`package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`, `go.sum`, `Cargo.lock` 等
+- 图片文件：`*.png`, `*.jpg`, `*.gif`, `*.svg`, `*.ico` 等
+- 字体文件：`*.woff`, `*.ttf`, `*.eot` 等
+- 二进制文件：`*.exe`, `*.dll`, `*.so`, `*.jar`, `*.pyc` 等
+- 压缩文件：`*.zip`, `*.tar.gz`, `*.rar` 等
+- 压缩的代码：`*.min.js`, `*.min.css`, `*.map`
+- 构建产物目录：`dist/`, `build/`, `out/`, `target/`, `.next/`
+- 依赖目录：`node_modules/`, `vendor/`, `.venv/`
+
+**文件限制**：
+- 最多评审 30 个文件
+- diff 最大 100000 字符（超出则截断）
+
+### 2. 分析代码
+
+**评审重点**（按优先级）：
+
+1. **安全漏洞**：SQL 注入、XSS、CSRF、硬编码凭证、敏感信息泄露、不安全加密
+2. **潜在 Bug**：空指针、数组越界、并发问题、资源泄漏、异常处理不当
+3. **代码质量**：可读性、命名规范、代码重复
+4. **性能问题**：N+1 查询、低效算法、不必要的 I/O
+
+**评审原则**：
+- 只评审新增代码（diff 中 `+` 开头的行，不含 `+++` 文件头）
+- **禁止评审**：删除的代码（`-` 开头）、上下文代码、未修改的代码
+- **忽略**：EOF 换行符、行尾空格、缩进风格（应由 linter 处理）
+
+**理解上下文**：
+当 diff 上下文不足以理解代码时（如需要看函数定义、类型、依赖关系），使用 Read 工具读取相关源文件理解上下文，并确认准确的行号。
+
+### 3. 输出评审结果
+
+**必须严格输出以下 JSON 格式**：
+
+```json
+{
+  "status": "passed | needs_modification | critical",
+  "issues": [
+    {
+      "severity": "critical | warning | info",
+      "file": "文件路径",
+      "start_line": 起始行号,
+      "end_line": 结束行号,
+      "problem": "问题：描述问题",
+      "suggestion": "建议：修复建议"
+    }
+  ]
+}
+```
+
+**字段说明**：
+- `status`: 评审状态
+  - `passed`: 通过，无问题
+  - `needs_modification`: 需要修改
+  - `critical`: 存在严重问题
+- `severity`: 问题严重程度
+  - `critical`: 严重（安全漏洞、崩溃 Bug）
+  - `warning`: 警告（潜在问题）
+  - `info`: 建议（代码质量改进）
+- `start_line` / `end_line`: 问题代码的行号范围（对应新文件行号）
+- `problem` / `suggestion`: 使用 Markdown 格式，提高可读性
+  - 使用 \`代码\` 标记变量名、函数名
+  - 使用代码块展示修复示例
+
+**无问题时**：`issues` 为空数组 `[]`
+
+### 4. 发送评审评论
+
+**重要**：使用 CNB API 发送评论，API 基础地址从环境变量 `CNB_API_ENDPOINT` 获取（默认 `https://api.cnb.cool`），仓库名从环境变量 `CNB_REPO_SLUG` 获取，PR 编号从环境变量 `CNB_PULL_REQUEST_IID` 获取。
+
+**有问题时**：调用 PostPullReview 接口发送行级评审评论：
+
+```bash
+curl -X POST \
+  "${CNB_API_ENDPOINT:-https://api.cnb.cool}/${CNB_REPO_SLUG}/-/pulls/${CNB_PULL_REQUEST_IID}/reviews" \
+  -H "Accept: application/vnd.cnb.api+json" \
+  -H "Authorization: Bearer $CNB_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+  "body": "**评审结果**: 需要修改",
+  "event": "comment",
+  "comments": [
+    {
+      "body": "问题: ...\n建议: ...",
+      "path": "文件路径",
+      "start_line": 起始行号,
+      "start_side": "right",
+      "end_line": 结束行号,
+      "end_side": "right",
+      "subject_type": "line"
+    }
+  ]
+}'
+```
+
+**无问题时**：调用 PostPullComment 接口发送总结评论：
+
+```bash
+curl -X POST \
+  "${CNB_API_ENDPOINT:-https://api.cnb.cool}/${CNB_REPO_SLUG}/-/pulls/${CNB_PULL_REQUEST_IID}/comments" \
+  -H "Accept: application/vnd.cnb.api+json" \
+  -H "Authorization: Bearer $CNB_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+  "body": "**评审结果**: 通过\n\n代码质量良好，未发现明显问题。"
+}'
+```
+
+## 注意事项
+
+1. **最多发送 10 条评论**，优先发送严重程度高的问题（critical > warning > info）
+2. 行号必须对应 diff 中的**新文件行号**（右侧行号），务必通过读取源文件确认
+3. 每条评论要具体说明问题原因和修复建议
+4. 评审结果必须是有效的 JSON 格式

package/skills/code-review/hooks/hooks.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "(?i)(代码评审|代码审查|code\\s*review|review\\s*(this\\s*)?PR|review\\s*(this\\s*)?MR|评审\\s*(这个)?\\s*(PR|MR|合并请求)|帮我\\s*(做)?\\s*(代码)?\\s*review|帮我\\s*评审)",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "用户请求进行代码评审。请使用 code-review 技能来自动获取 PR 变更并进行逐行评审"
+          }
+        ]
+      }
+    ]
+  }
+}

package/skills/diagnose-pr-pipeline/README.md

@@ -0,0 +1,3 @@
+# diagnose-pr-pipeline
+
+用于获取合并请求（Pull Request）报错的详细信息。当合并请求触发的 CI 流水线出现失败、报错、构建异常等情况时，可使用本 Skill 逐步定位具体报错原因。执行流程包括：查询 PR 状态检查获取构建编号、查询流水线构建状态获取失败 Stage ID、查询 Stage 详情获取具体报错信息。

package/skills/diagnose-pr-pipeline/SKILL.md

@@ -0,0 +1,88 @@
+---
+name: diagnose-pr-pipeline
+description: 用于获取 CNB 平台合并请求（Pull Request）报错的详细信息。当合并请求触发的 CI 流水线出现失败、报错、构建异常等情况时，可使用本 Skill 逐步定位具体报错原因。执行流程包括：查询 PR 状态检查获取构建编号、查询流水线构建状态获取失败 Stage ID、查询 Stage 详情获取具体报错信息。
+---
+
+# 获取合并请求报错详情
+
+## 描述
+
+当 CNB 平台合并请求（Pull Request）触发的 CI 流水线出现报错时，通过本 Skill 可以逐步定位并获取具体的报错详情信息。
+
+> ⚠️ **注意：以下步骤必须严格按顺序执行，每一步的输出结果是下一步的输入依据。**
+
+## 依赖
+
+- [cnb-skill]: 提供与CNB（Cloud Native Build）OpenAPI的完整交互能力，支持项目、组织、代码仓库、Issue、PR、合并请求、流水线，制品库等核心功能的增删改查操作。适用于开发协作、代码管理和CI/CD流程管理场景。关键词：CNB、云原生构建、组织、代码仓库、Issue、PR、合并请求、流水线、制品库，查询、新增、修改、删除、评论、合并、审批。
+
+---
+
+## 使用步骤
+
+### Step 1：查询 Pull Request 的状态检查
+
+查询指定 Pull Request 的状态检查信息，从返回结果中找到**状态检查的详细信息链接地址**。
+
+链接地址格式如下：
+
+```
+{CNB_WEB_ENDPOINT}/{CNB_REPO_SLUG}/-/build/logs/{sn}
+```
+
+| 参数                | 说明                     |
+| ------------------- | ------------------------ |
+| `CNB_WEB_ENDPOINT`  | CNB 平台的 Web 访问地址  |
+| `CNB_REPO_SLUG`     | 仓库的唯一标识（slug）   |
+| `sn`                | 流水线构建编号           |
+
+**目标：** 从链接地址中提取 `{sn}`，即流水线构建编号，供下一步使用。
+
+---
+
+### Step 2：查询流水线构建状态
+
+使用上一步获取到的流水线构建编号 `{sn}`，查询该流水线的构建状态。
+
+从返回结果中找到**失败的 Stage ID**。
+
+**目标：** 获取失败 Stage 的 `id`，供下一步使用。
+
+---
+
+### Step 3：查询流水线 Stage 详情
+
+使用上一步获取到失败 Stage 的 `id`，查询该 Stage 的详细信息。
+
+从返回结果中找到**具体的报错信息**。
+
+**目标：** 获取完整的报错详情，定位问题根因。
+
+---
+
+## 执行流程图
+
+```
+查询 PR 状态检查
+      │
+      ▼
+提取详情链接中的构建编号 {sn}
+      │
+      ▼
+查询流水线构建状态（入参：{sn}）
+      │
+      ▼
+提取失败的 Stage ID
+      │
+      ▼
+查询 Stage 详情（入参：stage_id）
+      │
+      ▼
+获取具体报错信息 ✅
+```
+
+---
+
+## 注意事项
+
+- 每一步必须在上一步**成功获取到所需参数**后再执行，不可跳步。
+- 若 Step 2 返回的构建中存在多个失败 Stage，可逐一查询每个失败 Stage 的详情，以获取完整的报错信息。

package/skills/dialog-ci-log/README.md

@@ -0,0 +1,16 @@
+# dialog-ci-log
+
+一个 Skill，用于查询 CNB CI 流水线的失败日志，快速定位构建失败原因。
+
+## 能力说明
+
+当你提供以下任一信息时，Skill 会自动查询并分析流水线的报错日志：
+
+- **构建编号（sn）**，如 `cnb-lf3-1jk2v2sl2`
+- **构建日志链接**，如 `https://cnb.woa.com/{repo}/-/build/logs/{sn}`
+
+Skill 会自动完成以下工作：
+
+1. 从输入中解析仓库标识和构建编号
+2. 查询流水线中所有失败 Stage 的详细日志
+3. 汇总失败原因，并给出修复建议

package/skills/dialog-ci-log/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: dialog-ci-log
+description: 传入流水线的 sn ，查询 CI 流水线的错误日志。当用户提供 CI 构建链接或 sn 编号，想查看流水线报错、构建失败原因时使用。
+allowed-tools: Bash,Read,Write,Edit,Glob,Grep
+---
+
+# 查询 CI 流水线错误日志
+
+## 使用场景
+
+用户提供以下任一信息时触发：
+- 流水线构建编号（sn），如 `cnb-lf3-1jk2v2sl2`
+- 构建日志链接，如 `${CNB_WEB_ENDPOINT}/{repo}/-/build/logs/{sn}`
+
+## 执行步骤
+
+### Step 1：解析参数
+
+从用户输入中提取必要信息：
+
+- **如果用户给了链接**：从 URL 中解析出 `CNB_REPO_SLUG` 和 `sn`
+  - URL 格式：`${CNB_WEB_ENDPOINT}/{CNB_REPO_SLUG}/-/build/logs/{sn}`
+  - `CNB_WEB_ENDPOINT` 从环境变量获取，默认为 `https://cnb.cool`
+  - 例：`https://cnb.cool/group/repo/-/build/logs/cnb-lf3-1jk2v2sl2` → `CNB_REPO_SLUG=group/repo`, `sn=cnb-lf3-1jk2v2sl2`
+
+`CNB_TOKEN` 从环境变量获取，若不存在则向用户询问。
+
+### Step 2：运行脚本获取日志
+
+```bash
+node ~/.codebuddy/skills/dialog-ci-log/scripts/get-failed-stage-logs.js {sn}
+```
+
+脚本路径：项目根目录下的 `scripts/get-failed-stage-logs.js`
+
+### Step 3：分析并汇报结果
+
+根据脚本输出：
+1. 列出所有失败的 Stage 名称
+2. 提取关键报错信息，给出简明的失败原因总结
+3. 如有可能，给出修复建议

package/skills/dialog-ci-log/scrips/get-failed-stage-logs.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+
+/**
+ * 查询流水线失败 Stage 日志
+ *
+ * 用法: node scripts/get-failed-stage-logs.js <sn>
+ *
+ * 环境变量:
+ *   CNB_API_ENDPOINT - API 地址，默认 https://api.cnb.cool
+ *   CNB_REPO_SLUG    - 仓库标识，如 owner/repo（必填）
+ *   PLUGIN_CNB_ACCESS_TOKEN        - 访问令牌（必填）
+ */
+
+const sn = process.argv[2];
+if (!sn) {
+  console.error('用法: node scripts/get-failed-stage-logs.js <sn>');
+  process.exit(1);
+}
+
+const API_ENDPOINT = process.env.CNB_API_ENDPOINT;
+const REPO_SLUG = process.env.CNB_REPO_SLUG;
+const TOKEN = process.env.PLUGIN_CNB_ACCESS_TOKEN;
+
+if (!REPO_SLUG) {
+  console.error('缺少环境变量 CNB_REPO_SLUG');
+  process.exit(1);
+}
+if (!TOKEN) {
+  console.error('缺少环境变量 PLUGIN_CNB_ACCESS_TOKEN');
+  process.exit(1);
+}
+
+const HEADERS = {
+  Accept: 'application/vnd.cnb.api+json',
+  Authorization: TOKEN,
+};
+
+async function request(path) {
+  const url = `${API_ENDPOINT}/${REPO_SLUG}${path}`;
+  const res = await fetch(url, { headers: HEADERS });
+  if (!res.ok) {
+    throw new Error(`请求失败: ${res.status} ${res.statusText} — ${url}`);
+  }
+  return res.json();
+}
+
+async function getBuildStatus(sn) {
+  return request(`/-/build/status/${sn}`);
+}
+
+async function getStageDetail(sn, pipelineId, stageId) {
+  return request(`/-/build/logs/stage/${sn}/${pipelineId}/${stageId}`);
+}
+
+async function main() {
+  console.log(`查询构建 sn=${sn} 的流水线状态...\n`);
+
+  const buildStatus = await getBuildStatus(sn);
+
+  if (!buildStatus.pipelinesStatus || typeof buildStatus.pipelinesStatus !== 'object') {
+    console.log('未找到流水线状态信息');
+    console.log('返回数据:', JSON.stringify(buildStatus, null, 2));
+    return;
+  }
+
+  const pipelines = Object.entries(buildStatus.pipelinesStatus);
+  if (pipelines.length === 0) {
+    console.log('该构建没有流水线');
+    return;
+  }
+
+  let hasFailure = false;
+
+  for (const [pipelineName, pipeline] of pipelines) {
+    const { id: pipelineId, status, stages } = pipeline;
+
+    if (!Array.isArray(stages)) continue;
+
+    const failedStages = stages.filter((s) => s.status === 'error');
+    if (failedStages.length === 0) continue;
+
+    hasFailure = true;
+    console.log(`━━━ 流水线: ${pipelineName} (status: ${status}) ━━━\n`);
+
+    for (const stage of failedStages) {
+      console.log(`▸ 失败 Stage: ${stage.name || stage.id} (status: ${stage.status})`);
+
+      try {
+        const detail = await getStageDetail(sn, pipelineId, stage.id);
+
+        if (detail.error) {
+          console.log(`  错误信息: ${detail.error}`);
+        }
+        if (detail.duration != null) {
+          console.log(`  耗时: ${detail.duration}ms`);
+        }
+
+        if (Array.isArray(detail.content) && detail.content.length > 0) {
+          console.log('  ─── 日志 ───');
+          for (const line of detail.content) {
+            console.log(`  ${line}`);
+          }
+          console.log('  ─── 日志结束 ───');
+        } else {
+          console.log('  （无日志内容）');
+        }
+      } catch (e) {
+        console.error(`  查询 Stage 详情失败: ${e.message}`);
+      }
+
+      console.log();
+    }
+  }
+
+  if (!hasFailure) {
+    console.log('所有流水线均无失败的 Stage');
+    console.log(`整体构建状态: ${buildStatus.status}`);
+  }
+}
+
+main().catch((e) => {
+  console.error(`执行失败: ${e.message}`);
+  process.exit(1);
+});

package/skills/pr-diff/README.md

@@ -0,0 +1,3 @@
+# pr-diff-skill
+
+获取 PR 的 diff 变更信息。当需要查看 PR 代码变更、获取文件差异时使用此技能。

package/skills/pr-diff/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: pr-diff
+description: 获取 PR 的 diff 变更信息。当需要查看 PR 代码变更、获取文件差异时使用此技能。
+allowed-tools: Bash
+---
+
+# 获取 PR Diff
+
+获取 PR 的代码变更差异信息，用于代码评审、变更总结等场景。
+
+## 1. 判断场景并获取 SHA
+
+### 场景 A：PR 评论触发（`CNB_PULL_REQUEST_IID` 存在）
+
+直接从环境变量获取：
+- head SHA：`CNB_PULL_REQUEST_SHA`
+- target SHA：`CNB_PULL_REQUEST_TARGET_SHA`
+
+若环境变量不存在，通过 API 查询当前 PR 详情。
+
+### 场景 B：Issue 或其他场景引用 PR
+
+用户输入中提及了 PR 编号（如 `!45`），需要：
+1. 从用户输入中解析 PR 编号
+2. 通过 API 查询该 PR 详情获取 SHA
+3. fetch 对应的 commit（本地可能没有）
+
+### API 查询 PR 详情
+
+```bash
+# 将 ${pr_iid} 替换为实际 PR 编号
+pr_info=$(curl -s \
+  "${CNB_API_ENDPOINT:-https://api.cnb.cool}/${CNB_REPO_SLUG}/-/pulls/${pr_iid}" \
+  -H "Accept: application/vnd.cnb.api+json" \
+  -H "Authorization: Bearer $CNB_TOKEN")
+
+head_sha=$(echo "$pr_info" | jq -r '.head.sha')
+target_sha=$(echo "$pr_info" | jq -r '.base.sha')
+
+# 场景 B 需要确保本地有这些 commit
+git fetch origin "$head_sha" "$target_sha" 2>/dev/null || git fetch origin
+```
+
+## 2. 获取 Diff
+
+### 获取变更文件列表
+
+```bash
+git diff --name-only "${target_sha}...${head_sha}"
+```
+
+### 获取变更统计
+
+```bash
+git diff --stat "${target_sha}...${head_sha}"
+```
+
+### 获取完整 Diff
+
+```bash
+git diff -U5 "${target_sha}...${head_sha}"
+```
+
+### 获取特定文件的 Diff
+
+```bash
+git diff -U5 "${target_sha}...${head_sha}" -- path/to/file.ts
+```
+
+## 3. 过滤文件
+
+根据使用场景，可排除无需关注的文件：
+
+```bash
+# 常见排除模式
+git diff -U5 "${target_sha}...${head_sha}" -- . \
+  ':!package-lock.json' ':!yarn.lock' ':!pnpm-lock.yaml' ':!go.sum' ':!*.lock' \
+  ':!*.png' ':!*.jpg' ':!*.gif' ':!*.svg' ':!*.ico' \
+  ':!*.min.js' ':!*.min.css' ':!*.map' \
+  ':!dist/*' ':!build/*' ':!node_modules/*'
+```
+
+**可排除的文件类型**：
+- 锁文件：`package-lock.json`、`yarn.lock`、`pnpm-lock.yaml`、`go.sum`、`Cargo.lock`
+- 图片/字体：`*.png`、`*.jpg`、`*.gif`、`*.svg`、`*.woff`、`*.ttf`
+- 二进制：`*.exe`、`*.dll`、`*.so`、`*.jar`、`*.pyc`
+- 压缩包：`*.zip`、`*.tar.gz`、`*.rar`
+- 构建产物：`dist/`、`build/`、`out/`、`target/`、`.next/`
+- 依赖目录：`node_modules/`、`vendor/`、`.venv/`
+- 压缩文件：`*.min.js`、`*.min.css`、`*.map`
+
+## 4. 使用建议
+
+1. **diff 过大时**：先用 `--name-only` 查看文件列表，再按需获取具体文件
+2. **代码评审**：建议排除锁文件、图片、构建产物
+3. **变更总结**：可保留更多文件，但排除二进制和依赖目录
+4. **上下文行数**：`-U5` 提供 5 行上下文，可按需调整

package/skills/pr-summary/README.md

@@ -0,0 +1,3 @@
+# pr-summary-skills
+
+PR 变更总结工具。仅用于合并请求（PR）场景。当用户请求总结 PR 变更、概述改动内容、生成变更说明时使用此技能。

package/skills/pr-summary/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: pr-summary
+description: PR 变更总结工具。仅用于合并请求（PR）场景。当用户请求总结 PR 变更、概述改动内容、生成变更说明时使用此技能。
+allowed-tools: Bash,Read,Glob,Grep
+---
+
+# PR 变更总结
+
+对 PR 的代码变更进行分析，生成结构化的变更总结。
+
+## 执行步骤
+
+### 1. 获取变更信息
+
+使用 **pr-diff** Skill 获取 PR 变更：
+- 先获取变更统计（`--stat`）和文件列表（`--name-only`）
+- 再按需获取关键文件的具体 diff
+
+### 2. 过滤文件
+
+**优先分析**（核心代码）：
+- 业务逻辑：`src/`、`lib/`、`app/`、`packages/`
+- API/接口：`api/`、`routes/`、`controllers/`
+- 配置文件：`*.config.*`、`*.yml`、`*.yaml`
+- 数据库/模型：`models/`、`schema/`、`migrations/`
+
+**跳过**（非核心文件）：
+- 依赖锁文件：`package-lock.json`、`yarn.lock`、`go.sum`
+- 构建产物：`dist/`、`build/`、`.next/`
+- 生成文件：`*.min.js`、`*.map`
+- 纯测试文件（除非测试是本次变更重点）
+
+### 3. 分析变更
+
+按以下维度分析：
+
+| 维度 | 关注点 |
+|------|--------|
+| **变更类型** | feat（新功能）、fix（修复）、refactor（重构）、perf（性能）、docs（文档）、chore（配置/依赖） |
+| **影响范围** | 涉及哪些模块、影响哪些功能点 |
+| **关键改动** | 核心逻辑变更、API 变化、数据结构变更 |
+| **破坏性变更** | 不兼容改动、需要迁移的内容 |
+
+若上下文不足以理解代码意图，使用 Read 工具读取完整源文件。
+
+## 输出格式
+
+```markdown
+**{type}**: {一句话描述}
+
+**主要改动**
+- {模块}: {变更说明}
+- {模块}: {变更说明}
+
+**注意**: {破坏性变更或风险点；如无则省略}
+```
+
+## 总结原则
+
+1. **简洁明了**：突出重点，避免逐行复述 diff
+2. **按功能分组**：按模块/功能组织，而非逐文件罗列
+3. **突出意图**：说明"为什么改"而非仅描述"改了什么"
+4. **识别风险**：主动指出破坏性变更和需要关注的点
+
+## 大型 PR 处理
+
+当文件数超过 20 个时：
+1. 先用 `--stat` 分析变更分布，按模块归类
+2. 重点分析核心模块变更（变更量大或涉及关键逻辑）
+3. 在末尾概括未详细分析的文件/模块

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

@@ -0,0 +1,3 @@
+# tapd-saas-resource-fetcher
+
+获取 Tapd SaaS 环境资源。当用户提供 Tapd 链接或提及 Tapd 需求/缺陷/任务/迭代时使用。支持获取需求(story)、缺陷(bug)、任务(task)、迭代(iteration)类型资源，调用接口获取完整资源数据以供分析。