@cnbcool/cnb-api-generate 1.2.7 → 2.0.0

package/client/lib/summary-extractors.ts

@@ -0,0 +1,189 @@
+/**
+ * 摘要输出
+ * 对返回数据量大的快捷命令，默认只输出核心字段，减少 token 消耗
+ */
+
+type SummaryExtractor = (item: any) => any;
+
+/**
+ * 摘要提取器配置
+ * key: "module/tool"，value: 摘要提取函数
+ * - 对象响应：直接对 data 应用提取函数
+ * - 数组响应：对 data 中每个元素应用提取函数
+ */
+const SUMMARY_EXTRACTORS: Record<string, SummaryExtractor> = {
+  // Issue 详情摘要：保留标题、状态、标签和正文
+  // 过滤: number, state_reason, assignees, author, created_at, updated_at 等
+  'issues/get-issue': (item) => ({
+    title: item.title,
+    state: item.state,
+    labels: item.labels?.map?.((l: any) => l.name).filter(Boolean) || [],
+    body: item.body,
+  }),
+
+  // Issue 更新摘要：只保留状态变更结果
+  // 过滤: title, body, labels, assignees, author, created_at, updated_at 等
+  'issues/update-issue': (item) => ({
+    number: item.number,
+    state: item.state,
+    state_reason: item.state_reason,
+  }),
+
+  // Issue 评论列表摘要：只保留作者用户名、内容和创建时间
+  // 过滤: author 完整对象(avatar/email/freeze/is_npc/nickname), reactions, updated_at
+  'issues/list-issue-comments': (item) => ({
+    id: item.id,
+    author: item.author?.username,
+    body: item.body,
+    created_at: item.created_at,
+  }),
+
+  // Issue 发表评论摘要：只保留评论 ID 和创建时间（body 已在请求中传入，无需重复）
+  // 过滤: body(请求已传入), author 完整对象(avatar/email/freeze/is_npc/nickname/username), reactions, updated_at
+  'issues/post-issue-comment': (item) => ({
+    id: item.id,
+    created_at: item.created_at,
+  }),
+
+  // Issue 标签列表摘要：保留名称、颜色和描述
+  // 过滤: id
+  'issues/list-issue-labels': (item) => ({
+    name: item.name,
+    color: item.color,
+    description: item.description,
+  }),
+
+  // Issue 添加标签摘要：只保留 ID 和颜色（name 已在请求中传入，无需重复）
+  // 过滤: name(请求已传入), description
+  'issues/post-issue-labels': (item) => ({
+    id: item.id,
+    color: item.color,
+  }),
+
+  // Issue 处理人列表摘要：保留用户名和昵称
+  // 过滤: avatar, email, freeze, is_npc
+  'issues/list-issue-assignees': (item) => ({
+    username: item.username,
+    nickname: item.nickname,
+  }),
+
+  // Issue 添加处理人摘要：保留处理人用户名和昵称列表
+  // 过滤: assignees 中每个用户的 avatar/email/freeze/is_npc，以及 issue 其他字段
+  'issues/post-issue-assignees': (item) => ({
+    number: item.number,
+    assignees: item.assignees?.map?.((a: any) => ({ username: a.username, nickname: a.nickname })).filter((a: any) => a.username) || [],
+  }),
+
+  // PR 详情摘要：保留标题、状态、标签、正文和分支信息
+  // 过滤: number, author, assignees, reviewers, created_at, updated_at, base/head 完整对象等
+  'pulls/get-pull': (item) => ({
+    title: item.title,
+    state: item.state,
+    labels: item.labels?.map?.((l: any) => l.name).filter(Boolean) || [],
+    base: item.base?.ref,
+    head: item.head?.ref,
+    body: item.body,
+  }),
+
+  // PR 文件列表摘要：保留文件名、sha、变更状态和增删行数
+  // 过滤: patch, blob_url, raw_url, contents_url, previous_filename
+  'pulls/list-pull-files': (item) => ({
+    filename: item.filename,
+    sha: item.sha,
+    status: item.status,
+    additions: item.additions,
+    deletions: item.deletions,
+  }),
+
+  // PR 提交列表摘要：只保留 sha 前 8 位和 commit message
+  // 过滤: sha 完整值, commit 完整对象(author/committer/tree/verification), parents, url 等
+  'pulls/list-pull-commits': (item) => ({
+    sha: typeof item.sha === 'string' ? item.sha.substring(0, 8) : item.sha,
+    message: item.commit?.message,
+  }),
+
+  // PR 评论列表摘要：保留作者用户名和昵称、内容和创建时间
+  // 过滤: author 完整对象(avatar/email/freeze/is_npc), reactions, updated_at
+  'pulls/list-pull-comments': (item) => ({
+    id: item.id,
+    author: item.author?.username,
+    nickname: item.author?.nickname,
+    body: item.body,
+    created_at: item.created_at,
+  }),
+
+  // PR 发表评论摘要：只保留评论 ID 和创建时间（body 已在请求中传入，无需重复）
+  // 过滤: body(请求已传入), author 完整对象(avatar/email/freeze/is_npc/nickname/username), reactions, updated_at
+  'pulls/post-pull-comment': (item) => ({
+    id: item.id,
+    created_at: item.created_at,
+  }),
+
+  // PR 标签列表摘要：保留 ID、名称、颜色和描述
+  // 过滤: 无
+  'pulls/list-pull-labels': (item) => ({
+    id: item.id,
+    name: item.name,
+    color: item.color,
+    description: item.description,
+  }),
+
+  // PR 添加标签摘要：只保留 ID 和颜色（name 已在请求中传入，无需重复）
+  // 过滤: name(请求已传入), description
+  'pulls/post-pull-labels': (item) => ({
+    id: item.id,
+    color: item.color,
+  }),
+
+  // PR CI 状态摘要：保留整体状态和各检查项的核心信息（sha 截断为前 8 位）
+  // 过滤: sha 完整值, statuses 中每项的 target_url/created_at/updated_at
+  'pulls/list-pull-commit-statuses': (item) => ({
+    sha: typeof item.sha === 'string' ? item.sha.substring(0, 8) : item.sha,
+    state: item.state,
+    statuses: item.statuses?.map?.((s: any) => ({
+      context: s.context,
+      state: s.state,
+      description: s.description,
+    })) || [],
+  }),
+
+  // PR 评审列表摘要：保留作者用户名和昵称、状态和内容
+  // 过滤: author 完整对象(avatar/email/freeze/is_npc), created_at, updated_at
+  'pulls/list-pull-reviews': (item) => ({
+    id: item.id,
+    author: item.author?.username,
+    nickname: item.author?.nickname,
+    state: item.state,
+    body: item.body,
+  }),
+
+  // PR 处理人列表摘要：保留用户名和昵称
+  // 过滤: avatar, email, freeze, is_npc
+  'pulls/list-pull-assignees': (item) => ({
+    username: item.username,
+    nickname: item.nickname,
+  }),
+
+  // PR 添加处理人摘要：保留处理人用户名和昵称列表
+  // 过滤: assignees 中每个用户的 avatar/email/freeze/is_npc，以及 PR 其他字段
+  'pulls/post-pull-assignees': (item) => ({
+    number: item.number,
+    assignees: item.assignees?.map?.((a: any) => ({ username: a.username, nickname: a.nickname })).filter((a: any) => a.username) || [],
+  }),
+};
+
+/**
+ * 对响应数据应用摘要提取（如果当前 tool 配置了摘要提取器）
+ * @param data 原始 data（对象或数组）
+ * @param toolKey 当前 tool 标识，格式为 "module/tool"
+ * @returns 摘要后的 data，如果无匹配提取器则返回 null
+ */
+export function summarizeResponse(data: any, toolKey: string): any | null {
+  const extractor = SUMMARY_EXTRACTORS[toolKey];
+  if (!extractor) return null;
+  if (data == null) return data;
+  if (Array.isArray(data)) {
+    return data.map(extractor);
+  }
+  return extractor(data);
+}

package/client/lib/trim-summary.ts

@@ -0,0 +1,11 @@
+/**
+ * 去除 summary 中的英文部分（保留中文句号前的内容）
+ */
+export function trimSummary(summary: string): string {
+  if (!summary) return '';
+  // 匹配中文句号"。"后面跟英文的模式，只保留中文部分
+  const match = summary.match(/^(.*?[\u4e00-\u9fff].*?)[。.]\s*[A-Z]/);
+  if (match) return match[1];
+  // 没有匹配到则返回原文
+  return summary;
+}

package/client/shortcuts.ts

@@ -70,15 +70,15 @@ function getPRNumber(): string {
 const ISSUE_SHORTCUTS: ShortcutDefinition[] = [
   { shortName: 'get',            realTool: 'get-issue',            description: '获取详情' },
   { shortName: 'list-comments',  realTool: 'list-issue-comments',  description: '获取评论列表' },
-  { shortName: 'comment',        realTool: 'post-issue-comment',   description: '评论',           dataTip: "--data '{\"body\":\"内容\"}'" },
+  { shortName: 'comment',        realTool: 'post-issue-comment',   description: '评论',           dataTip: "--body 内容" },
   { shortName: 'close',          realTool: 'update-issue',         description: '关闭',           autoData: { state: 'closed', state_reason: 'completed' } },
   { shortName: 'open',           realTool: 'update-issue',         description: '打开',           autoData: { state: 'open', state_reason: 'reopened' } },
   { shortName: 'list-labels',    realTool: 'list-issue-labels',    description: '查看标签' },
-  { shortName: 'add-labels',     realTool: 'post-issue-labels',    description: '添加标签',        dataTip: "--data '{\"labels\":[\"bug\",\"feature\"]}'" },
+  { shortName: 'add-labels',     realTool: 'post-issue-labels',    description: '添加标签',        dataTip: "--labels bug --labels feature" },
   { shortName: 'list-assignees', realTool: 'list-issue-assignees', description: '查看处理人' },
-  { shortName: 'add-assignees',  realTool: 'post-issue-assignees', description: '添加处理人',      dataTip: "--data '{\"assignees\":[\"username\"]}'" },
-  { shortName: 'upload-file',    realTool: 'post-issue-file-asset-upload-url',  description: '上传文件', upload: true, dataTip: "--data '{\"file\":\"文件路径\"}'" },
-  { shortName: 'upload-image',   realTool: 'post-issue-image-asset-upload-url', description: '上传图片', upload: true, dataTip: "--data '{\"file\":\"图片路径\"}'" },
+  { shortName: 'add-assignees',  realTool: 'post-issue-assignees', description: '添加处理人',      dataTip: "--assignees username" },
+  { shortName: 'upload-file',    realTool: 'post-issue-file-asset-upload-url',  description: '上传文件', upload: true, dataTip: "--file 文件路径" },
+  { shortName: 'upload-image',   realTool: 'post-issue-image-asset-upload-url', description: '上传图片', upload: true, dataTip: "--file 图片路径" },
 ];
 
 const PR_SHORTCUTS: ShortcutDefinition[] = [
@@ -86,14 +86,14 @@ const PR_SHORTCUTS: ShortcutDefinition[] = [
   { shortName: 'list-files',     realTool: 'list-pull-files',         description: '获取文件变更' },
   { shortName: 'list-commits',   realTool: 'list-pull-commits',       description: '获取提交记录' },
   { shortName: 'list-comments',  realTool: 'list-pull-comments',      description: '获取评论列表' },
-  { shortName: 'comment',        realTool: 'post-pull-comment',       description: '评论',           dataTip: "--data '{\"body\":\"内容\"}'" },
+  { shortName: 'comment',        realTool: 'post-pull-comment',       description: '评论',           dataTip: "--body 内容" },
   { shortName: 'list-labels',    realTool: 'list-pull-labels',        description: '查看标签' },
-  { shortName: 'add-labels',     realTool: 'post-pull-labels',        description: '添加标签',        dataTip: "--data '{\"labels\":[\"ready\",\"approved\"]}'" },
+  { shortName: 'add-labels',     realTool: 'post-pull-labels',        description: '添加标签',        dataTip: "--labels ready --labels approved" },
   { shortName: 'check-status',   realTool: 'list-pull-commit-statuses', description: '查看 CI 状态' },
   { shortName: 'list-reviews',   realTool: 'list-pull-reviews',       description: '查看评审列表' },
   { shortName: 'list-assignees', realTool: 'list-pull-assignees',     description: '查看处理人' },
-  { shortName: 'upload-file',    realTool: 'upload-files',  description: '上传文件', repoOnly: true, upload: true, dataTip: "--data '{\"file\":\"文件路径\"}'" },
-  { shortName: 'upload-image',   realTool: 'upload-imgs',  description: '上传图片', repoOnly: true, upload: true, dataTip: "--data '{\"file\":\"图片路径\"}'" },
+  { shortName: 'upload-file',    realTool: 'upload-files',  description: '上传文件', repoOnly: true, upload: true, dataTip: "--file 文件路径" },
+  { shortName: 'upload-image',   realTool: 'upload-imgs',  description: '上传图片', repoOnly: true, upload: true, dataTip: "--file 图片路径" },
 ];
 
 // ============================================================
@@ -199,7 +199,7 @@ ${prList}
   CNB_ISSUE_IID          - Issue 编号（Issue 相关快捷命令）
   CNB_PULL_REQUEST_IID   - PR 编号（PR 相关快捷命令）
 
-  默认只输出摘要信息，添加 --verbose 可输出全部信息
+  默认只输出摘要信息，添加 --v 可输出全部信息
 `);
   }
 }
@@ -247,191 +247,3 @@ export function resolveShortcut(
   };
 }
 
-// ============================================================
-// 摘要输出
-// 对返回数据量大的快捷命令，默认只输出核心字段，减少 token 消耗
-// ============================================================
-
-type SummaryExtractor = (item: any) => any;
-
-/**
- * 摘要提取器配置
- * key: "module/tool"，value: 摘要提取函数
- * - 对象响应：直接对 data 应用提取函数
- * - 数组响应：对 data 中每个元素应用提取函数
- */
-const SUMMARY_EXTRACTORS: Record<string, SummaryExtractor> = {
-  // Issue 详情摘要：保留标题、状态、标签和正文
-  // 过滤: number, state_reason, assignees, author, created_at, updated_at 等
-  'issues/get-issue': (item) => ({
-    title: item.title,
-    state: item.state,
-    labels: item.labels?.map?.((l: any) => l.name).filter(Boolean) || [],
-    body: item.body,
-  }),
-
-  // Issue 更新摘要：只保留状态变更结果
-  // 过滤: title, body, labels, assignees, author, created_at, updated_at 等
-  'issues/update-issue': (item) => ({
-    number: item.number,
-    state: item.state,
-    state_reason: item.state_reason,
-  }),
-
-  // Issue 评论列表摘要：只保留作者用户名、内容和创建时间
-  // 过滤: author 完整对象(avatar/email/freeze/is_npc/nickname), reactions, updated_at
-  'issues/list-issue-comments': (item) => ({
-    id: item.id,
-    author: item.author?.username,
-    body: item.body,
-    created_at: item.created_at,
-  }),
-
-  // Issue 发表评论摘要：只保留评论 ID 和创建时间（body 已在请求中传入，无需重复）
-  // 过滤: body(请求已传入), author 完整对象(avatar/email/freeze/is_npc/nickname/username), reactions, updated_at
-  'issues/post-issue-comment': (item) => ({
-    id: item.id,
-    created_at: item.created_at,
-  }),
-
-  // Issue 标签列表摘要：保留名称、颜色和描述
-  // 过滤: id
-  'issues/list-issue-labels': (item) => ({
-    name: item.name,
-    color: item.color,
-    description: item.description,
-  }),
-
-  // Issue 添加标签摘要：只保留 ID 和颜色（name 已在请求中传入，无需重复）
-  // 过滤: name(请求已传入), description
-  'issues/post-issue-labels': (item) => ({
-    id: item.id,
-    color: item.color,
-  }),
-
-  // Issue 处理人列表摘要：保留用户名和昵称
-  // 过滤: avatar, email, freeze, is_npc
-  'issues/list-issue-assignees': (item) => ({
-    username: item.username,
-    nickname: item.nickname,
-  }),
-
-  // Issue 添加处理人摘要：保留处理人用户名和昵称列表
-  // 过滤: assignees 中每个用户的 avatar/email/freeze/is_npc，以及 issue 其他字段
-  'issues/post-issue-assignees': (item) => ({
-    number: item.number,
-    assignees: item.assignees?.map?.((a: any) => ({ username: a.username, nickname: a.nickname })).filter((a: any) => a.username) || [],
-  }),
-
-  // PR 详情摘要：保留标题、状态、标签、正文和分支信息
-  // 过滤: number, author, assignees, reviewers, created_at, updated_at, base/head 完整对象等
-  'pulls/get-pull': (item) => ({
-    title: item.title,
-    state: item.state,
-    labels: item.labels?.map?.((l: any) => l.name).filter(Boolean) || [],
-    base: item.base?.ref,
-    head: item.head?.ref,
-    body: item.body,
-  }),
-
-  // PR 文件列表摘要：保留文件名、sha、变更状态和增删行数
-  // 过滤: patch, blob_url, raw_url, contents_url, previous_filename
-  'pulls/list-pull-files': (item) => ({
-    filename: item.filename,
-    sha: item.sha,
-    status: item.status,
-    additions: item.additions,
-    deletions: item.deletions,
-  }),
-
-  // PR 提交列表摘要：只保留 sha 前 8 位和 commit message
-  // 过滤: sha 完整值, commit 完整对象(author/committer/tree/verification), parents, url 等
-  'pulls/list-pull-commits': (item) => ({
-    sha: typeof item.sha === 'string' ? item.sha.substring(0, 8) : item.sha,
-    message: item.commit?.message,
-  }),
-
-  // PR 评论列表摘要：保留作者用户名和昵称、内容和创建时间
-  // 过滤: author 完整对象(avatar/email/freeze/is_npc), reactions, updated_at
-  'pulls/list-pull-comments': (item) => ({
-    id: item.id,
-    author: item.author?.username,
-    nickname: item.author?.nickname,
-    body: item.body,
-    created_at: item.created_at,
-  }),
-
-  // PR 发表评论摘要：只保留评论 ID 和创建时间（body 已在请求中传入，无需重复）
-  // 过滤: body(请求已传入), author 完整对象(avatar/email/freeze/is_npc/nickname/username), reactions, updated_at
-  'pulls/post-pull-comment': (item) => ({
-    id: item.id,
-    created_at: item.created_at,
-  }),
-
-  // PR 标签列表摘要：保留 ID、名称、颜色和描述
-  // 过滤: 无
-  'pulls/list-pull-labels': (item) => ({
-    id: item.id,
-    name: item.name,
-    color: item.color,
-    description: item.description,
-  }),
-
-  // PR 添加标签摘要：只保留 ID 和颜色（name 已在请求中传入，无需重复）
-  // 过滤: name(请求已传入), description
-  'pulls/post-pull-labels': (item) => ({
-    id: item.id,
-    color: item.color,
-  }),
-
-  // PR CI 状态摘要：保留整体状态和各检查项的核心信息（sha 截断为前 8 位）
-  // 过滤: sha 完整值, statuses 中每项的 target_url/created_at/updated_at
-  'pulls/list-pull-commit-statuses': (item) => ({
-    sha: typeof item.sha === 'string' ? item.sha.substring(0, 8) : item.sha,
-    state: item.state,
-    statuses: item.statuses?.map?.((s: any) => ({
-      context: s.context,
-      state: s.state,
-      description: s.description,
-    })) || [],
-  }),
-
-  // PR 评审列表摘要：保留作者用户名和昵称、状态和内容
-  // 过滤: author 完整对象(avatar/email/freeze/is_npc), created_at, updated_at
-  'pulls/list-pull-reviews': (item) => ({
-    id: item.id,
-    author: item.author?.username,
-    nickname: item.author?.nickname,
-    state: item.state,
-    body: item.body,
-  }),
-
-  // PR 处理人列表摘要：保留用户名和昵称
-  // 过滤: avatar, email, freeze, is_npc
-  'pulls/list-pull-assignees': (item) => ({
-    username: item.username,
-    nickname: item.nickname,
-  }),
-
-  // PR 添加处理人摘要：保留处理人用户名和昵称列表
-  // 过滤: assignees 中每个用户的 avatar/email/freeze/is_npc，以及 PR 其他字段
-  'pulls/post-pull-assignees': (item) => ({
-    number: item.number,
-    assignees: item.assignees?.map?.((a: any) => ({ username: a.username, nickname: a.nickname })).filter((a: any) => a.username) || [],
-  }),
-};
-
-/**
- * 对响应数据应用摘要提取（如果当前 tool 配置了摘要提取器）
- * @param data 原始 data（对象或数组）
- * @param toolKey 当前 tool 标识，格式为 "module/tool"
- * @returns 摘要后的 data，如果无匹配提取器则返回 null
- */
-export function summarizeResponse(data: any, toolKey: string): any | null {
-  const extractor = SUMMARY_EXTRACTORS[toolKey];
-  if (!extractor) return null;
-  if (Array.isArray(data)) {
-    return data.map(extractor);
-  }
-  return extractor(data);
-}

package/client/utils/build-nested-field-map.ts

@@ -0,0 +1,38 @@
+export interface NestedFieldMapping {
+  pathKeys: string[];       // schema 路径，如 ["testBody", "critical_count", "id"]
+  leafSchema: any;          // 叶子节点的 schema 定义
+}
+
+/**
+ * 递归遍历嵌套对象的 schema，生成所有叶子节点的 flat key 映射
+ * @param props  当前层级的 properties
+ * @param prefix 当前层级的 CLI flat key 前缀（用 @ 连接），如 "testBody"
+ * @param pathKeys 当前层级的 schema 路径数组，如 ["testBody"]
+ * @returns Map<flatKey, NestedFieldMapping>
+ */
+export function buildNestedFieldMap(
+  props: Record<string, any>,
+  prefix: string,
+  pathKeys: string[],
+): Map<string, NestedFieldMapping> {
+  const map = new Map<string, NestedFieldMapping>();
+
+  for (const [subKey, subProp] of Object.entries(props) as [string, any][]) {
+    const flatKey = `${prefix}@${subKey}`;
+    const currentPath = [...pathKeys, subKey];
+
+    if (subProp.type === 'object' && subProp.properties && Object.keys(subProp.properties).length > 0) {
+      // 嵌套对象：继续递归
+      const subMap = buildNestedFieldMap(subProp.properties, flatKey, currentPath);
+      for (const [k, v] of subMap) {
+        map.set(k, v);
+      }
+    } else {
+      // 叶子节点：注册 flat key
+      const camelKey = flatKey;
+      map.set(camelKey, { pathKeys: currentPath, leafSchema: subProp });
+    }
+  }
+
+  return map;
+}

package/client/utils/flat-key-from-segments.ts

@@ -0,0 +1,8 @@
+/**
+ * 生成 CLI flat key：按 '@' 连接层级
+ * 例如 "testBody@critical_count@id"
+ * Commander 不会对 '@' 做 camelCase 转换，所以 key 保持原样
+ */
+export function flatKeyFromSegments(str: string): string {
+  return str;
+}

package/client/utils/match-array-object-field.ts

@@ -0,0 +1,19 @@
+/**
+ * 检测是否为 array<object> 展开字段（格式：bodyArrayKey@subPropName）
+ * Commander 不会对 '@' 做 camelCase，所以直接匹配原始 key
+ */
+export function matchArrayObjectField(
+  camelKey: string,
+  bodyProps: Record<string, any>,
+): { arrayKey: string; subKey: string } | null {
+  for (const [rootKey, rootProp] of Object.entries(bodyProps) as [string, any][]) {
+    if (rootProp.type !== 'array' || !rootProp.items?.properties) continue;
+    for (const subKey of Object.keys(rootProp.items.properties)) {
+      const flatKey = `${rootKey}@${subKey}`;
+      if (flatKey === camelKey) {
+        return { arrayKey: rootKey, subKey };
+      }
+    }
+  }
+  return null;
+}

package/client/utils/restore-original-keys.ts

@@ -0,0 +1,23 @@
+import { keyMappingData } from '../lib/key-mapping-data';
+
+/**
+ * 将 CLI 传入的带 '-' 的参数名还原为原始的 '_' 或 '@' 参数名
+ * 通过 key-mapping.json 中的映射表进行查找还原
+ */
+export function restoreOriginalKeys(
+  params: Record<string, string | string[] | boolean | undefined>,
+): Record<string, string | string[] | boolean | undefined> {
+  const moduleName = params.module as string;
+  const toolName = params.tool as string;
+  if (!moduleName || !toolName) return params;
+
+  const toolMapping = keyMappingData[moduleName]?.[toolName];
+  if (!toolMapping) return params;
+
+  const restored: Record<string, string | string[] | boolean | undefined> = {};
+  for (const [key, value] of Object.entries(params)) {
+    const originalKey = toolMapping[key];
+    restored[originalKey || key] = value;
+  }
+  return restored;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cnbcool/cnb-api-generate",
-  "version": "1.2.7",
+  "version": "2.0.0",
   "main": "./built/index.js",
   "module": "./src/index.ts",
   "types": "./src/index.ts",
@@ -37,6 +37,7 @@
     "@types/lodash": "4.17.20",
     "babel-plugin-transform-define": "^2.1.4",
     "cli-progress": "^3.12.0",
+    "commander": "^14.0.3",
     "debug": "4.4.1",
     "glob": "^13.0.1",
     "lodash": "^4.17.23",
@@ -47,7 +48,6 @@
   },
   "devDependencies": {
     "@reduxjs/toolkit": "^1.9.5",
-    "eslint-config-tencent": "^1.1.3",
     "@types/debug": "4.1.12",
     "@types/jest": "^29.5.3",
     "@types/node": "24.0.12",
@@ -56,6 +56,7 @@
     "axios": "^1.13.6",
     "eslint": "8.57.0",
     "eslint-config-prettier": "9.1.0",
+    "eslint-config-tencent": "^1.1.3",
     "eslint-config-turbo": "2.2.3",
     "eslint-plugin-prettier": "5.2.1",
     "jest": "^29.6.1",

package/skills-template/SKILL.md

@@ -9,26 +9,39 @@ description: CNB OpenAPI 交互能力，支持仓库、Issue、PR、流水线、
 
 ## 快捷命令（优先使用）
 
-可用快捷命令：
-- `issues`: `get`, `list-comments`, `comment`, `close`, `open`, `list-labels`, `add-labels`, `list-assignees`, `add-assignees`, `upload-file`, `upload-image`
-- `pulls`: `get`, `list-files`, `list-commits`, `list-comments`, `comment`, `list-labels`, `add-labels`, `check-status`, `list-reviews`, `list-assignees`, `upload-file`, `upload-image`
+issues 快捷命令：
+- `<$CNB_CLI_CMD$> issues get` — 获取 Issue 详情
+- `<$CNB_CLI_CMD$> issues list-comments` — 列出 Issue 评论
+- `<$CNB_CLI_CMD$> issues comment --data '{"body":"内容"}'` — 发表 Issue 评论
+- `<$CNB_CLI_CMD$> issues close` — 关闭 Issue
+- `<$CNB_CLI_CMD$> issues open` — 打开 Issue
+- `<$CNB_CLI_CMD$> issues list-labels` — 列出 Issue 标签
+- `<$CNB_CLI_CMD$> issues add-labels --data '{"labels":["标签"]}'` — 添加 Issue 标签
+- `<$CNB_CLI_CMD$> issues list-assignees` — 查看 Issue 处理人
+- `<$CNB_CLI_CMD$> issues add-assignees --data '{"assignees":["用户名"]}'` — 添加 Issue 处理人
+- `<$CNB_CLI_CMD$> issues upload-file --data '{"file":"本地文件路径"}'` — 上传文件到 Issue
+- `<$CNB_CLI_CMD$> issues upload-image --data '{"file":"本地图片路径"}'` — 上传图片到 Issue
+
+pulls 快捷命令：
+- `<$CNB_CLI_CMD$> pulls get` — 获取 PR 详情
+- `<$CNB_CLI_CMD$> pulls list-files` — 列出 PR 变更文件
+- `<$CNB_CLI_CMD$> pulls list-commits` — 列出 PR 提交记录
+- `<$CNB_CLI_CMD$> pulls list-comments` — 列出 PR 评论
+- `<$CNB_CLI_CMD$> pulls comment --data '{"body":"内容"}'` — 发表 PR 评论
+- `<$CNB_CLI_CMD$> pulls list-labels` — 列出 PR 标签
+- `<$CNB_CLI_CMD$> pulls add-labels --data '{"labels":["标签"]}'` — 添加 PR 标签
+- `<$CNB_CLI_CMD$> pulls check-status` — 查看 CI 状态
+- `<$CNB_CLI_CMD$> pulls list-reviews` — 查看评审列表
+- `<$CNB_CLI_CMD$> pulls list-assignees` — 查看 PR 处理人
+- `<$CNB_CLI_CMD$> pulls add-assignees --data '{"assignees":["用户名"]}'` — 添加 PR 处理人
+- `<$CNB_CLI_CMD$> pulls upload-file --data '{"file":"本地文件路径"}'` — 上传文件到 PR
+- `<$CNB_CLI_CMD$> pulls upload-image --data '{"file":"本地图片路径"}'` — 上传图片到 PR
 
 注意：
-- **路径参数自动注入**：仓库 slug、Issue/PR 编号优先从环境变量自动获取，无需额外传入
+- **路径参数自动注入**：仓库 slug、Issue/PR 编号优先从环境变量自动获取，无需额外传入任何其他参数
 - **默认只输出摘要**：会精简响应输出结果，只返回核心字段。加 `--verbose` 输出完整数据。
 - 快捷命令只能操作当前仓库的当前Issue或PR。跨仓库或跨编号操作请使用其他 API 命令。
 
-用法: `<$CNB_CLI_CMD$> <module> <command>`
-- ✅ `<$CNB_CLI_CMD$> issues get`
-- ✅ `<$CNB_CLI_CMD$> pulls comment --data '{"body":"内容"}'`
-
-需要 `--data` 的快捷命令: 
-- `comment`: `--data '{"body":"内容"}'`
-- `add-labels`: `--data '{"labels":["标签"]}'`
-- `add-assignees`: `--data '{"assignees":["用户名"]}'`
-- `upload-file`: `--data '{"file":"本地文件路径"}'`（自动完成上传全流程）
-- `upload-image`: `--data '{"file":"本地图片路径"}'`（自动完成上传全流程）
-
 ## 其他 API（快捷命令不满足时使用）
 
 1. `<$CNB_CLI_CMD$> --help` 查看所有模块