@cnbcool/cnb-api-generate 2.16.3 → 2.16.5

package/built/skills-tools/generate-skill-md.js

@@ -27,7 +27,7 @@ _requestMap, quickCommandsByModule) {
     const config = (0, get_config_1.getConfig)();
     const cliCmd = config.skillsDev ? skills_1.CNB_CLI_DEV_CMD : skills_1.CNB_CLI_PROD_CMD;
     // 仅替换两类占位符：
-    // - <$QUICK_COMMANDS$>：配置驱动的快捷命令清单（标题/注意事项写在模板里即可）
+    // - <$QUICK_COMMANDS$>：配置驱动的快捷命令清单（标题/使用约定写在模板里即可）
     // - <$CNB_CLI_CMD$>   ：CLI 命令前缀
     const quickCommandsMd = (0, render_quick_commands_md_1.renderQuickCommandsMarkdown)(quickCommandsByModule, cliCmd);
     const total = Object.values(quickCommandsByModule).reduce((n, arr) => n + arr.length, 0);

package/built/skills-tools/render-quick-commands-md.js

@@ -4,7 +4,7 @@ exports.renderQuickCommandsMarkdown = renderQuickCommandsMarkdown;
 /**
  * 把解析后的快捷命令渲染为 markdown 文本，对应模板里的 <$QUICK_COMMANDS$> 占位符。
  *
- * 仅渲染命令列表本身——"## 快捷命令" 标题、"## 注意事项" 等静态文案直接
+ * 仅渲染命令列表本身——"## 快捷命令" 标题、"## 使用约定" 等静态文案直接
  * 写在 skills-template/SKILL.md 模板里，没必要再加占位符。
  *
  * 渲染规则：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cnbcool/cnb-api-generate",
-  "version": "2.16.3",
+  "version": "2.16.5",
   "main": "./built/index.js",
   "module": "./src/index.ts",
   "types": "./src/index.ts",

package/skills-template/SKILL.md

@@ -9,13 +9,25 @@ description: CNB 平台交互命令，支持代码仓库、Issue、PR、CI、制
 
 <$QUICK_COMMANDS$>
 
-注意事项：
+## 使用约定
 
-- **参数自动识别**：Issue/PR 编号自动从环境变量识别，无需额外传递。
-- **默认仅需摘要**：默认精简输出，加 `--verbose` 输出完整数据。
-- **多行文本传参**：bash 参数为多行文本时用单引号，降低命令注入风险。
-- **适用范围**：快捷命令仅限当前仓库的当前 Issue/PR，跨仓库或跨编号请参考 `更多 API`。
-- **提及与召唤**：评论中直接 @npc 会召唤 npc；仅提及不召唤时，用反引号包裹 `@npc`。
+- **编号自识别**：Issue/PR 编号自动从环境变量识别，无需额外传递。
+- **默认摘要省流**：默认精简输出，加 `--verbose` 输出完整数据。
+- **多行用单引号**：bash 参数为多行文本时用单引号，降低命令注入风险。
+- **范围限本仓**：快捷命令仅限当前仓库的当前 Issue/PR，跨仓库或跨编号请参考「更多 API」。
+- **提及不召唤**：评论中直接 @npc 会召唤 npc；仅提及不召唤时，用反引号包裹 `@npc`。
+
+## 取正文里的图片与附件
+
+评论正文里的图片、附件 URL，一律用 `get-imgs` / `get-files` 取回。
+
+- **不要裸 `curl`**：CLI 内置鉴权；
+  手写 `Authorization: Bearer` 或 `token` 都不被识别，只会拿到 400。
+- **参数取 URL 的尾段**：
+  - 图片取 `/imgs/<issues|pulls>/` 之后的部分
+  - 附件取 `/files/<issues|pulls>/` 之后的部分
+- **URL 从 `list-comments` 原文取**：
+  不要去 `find` 本地文件，也不要猜域名。
 
 ## 常用链接