github.com/qiniu/go-sdk/v7@v7.27.0/.agents/skills/gen/SKILL.md (about)

     1  ---
     2  name: gen
     3  description: 运行代码生成并检查变更。在修改 API 规范（api-specs/ YAML）或 sandbox OpenAPI/protobuf 后使用。
     4  argument-hint: "[sandbox]"
     5  allowed-tools:
     6    - Bash(make generate)
     7    - Bash(make generate-sandbox)
     8    - Bash(go build *)
     9    - Bash(git diff *)
    10    - Bash(git status)
    11  ---
    12  
    13  # 代码生成
    14  
    15  开始时声明："我正在使用 gen skill 运行代码生成。"
    16  
    17  ## 执行步骤
    18  
    19  ### 步骤 1：记录当前状态
    20  
    21  ```bash
    22  git diff --stat
    23  ```
    24  
    25  ### 步骤 2：运行代码生成
    26  
    27  默认运行 API 代码生成（storagev2、iam、media、audit）：
    28  
    29  ```bash
    30  make generate
    31  ```
    32  
    33  如果用户提到 sandbox，则运行：
    34  
    35  ```bash
    36  make generate-sandbox
    37  ```
    38  
    39  ### 步骤 3：检查变更
    40  
    41  ```bash
    42  git diff --stat
    43  ```
    44  
    45  对比生成前后的变更，列出生成产生的文件差异。
    46  
    47  ### 步骤 4：验证编译
    48  
    49  ```bash
    50  go build ./...
    51  ```
    52  
    53  确认编译通过。
    54  
    55  ## 输出格式
    56  
    57  列出生成的文件变更清单和编译结果。如果没有变更，说明"代码生成未产生新变更"。
    58  
    59  ## 系统规范（AGENTS.md）
    60  
    61  执行本 skill 时同时遵守 `AGENTS.md` 中的系统规范；与本 skill 冲突时以本 skill 为准。