@comate/zulu 1.2.1-beta.2 → 1.3.1

package/comate-engine/assets/skills/icafe-comate/references/smart-update-workflow.md

@@ -0,0 +1,118 @@
+# 智能修改卡片工作流
+
+用户要修改某张卡片时，需要先充分了解卡片当前状态、字段的合法值、状态流转规则，避免盲目修改导致失败。修改后要验证结果，失败时要分析原因。
+
+---
+
+## 适用场景
+
+- 用户说"帮我改一下卡片状态到开发中"
+- 用户说"把负责人改成 zhangsan"
+- 用户说"更新一下优先级为 P1"
+- 用户说"帮我修改卡片的自定义字段"
+
+## 第一步：获取卡片当前信息
+
+```bash
+icafe-cli card get --space <space> --sequence <sequence> --brief
+```
+
+按需添加可选参数：
+- `--show-associations`: 需要查看关联卡片时添加
+- `--show-children`: 需要查看子卡片时添加
+
+记录当前状态，包括：标题、**类型名称 (`type.name`)**、负责人、流程状态、优先级等。后续对比用。
+
+> 如果用户没给完整的 space+sequence，先参考 [智能寻卡工作流](smart-find-workflow.md) 定位卡片。
+
+## 第二步：获取字段定义和状态流转规则
+
+第一步获取到 `type.name` 后，**以下两个查询没有依赖关系，可以并行调用**以节省时间：
+
+```bash
+# 查询 1: 获取字段定义和合法值
+icafe-cli space type-fields --space <space> --type <card_type>
+
+# 查询 2: 如需修改状态，获取可达的目标状态
+icafe-cli card next-statuses --space <space> --sequence <sequence>
+```
+
+**字段定义** (`type-fields`) 重点关注：
+- 要修改的目标字段是否存在
+- 字段的可选值列表（如优先级有哪些值、下拉列表的选项等）
+- **注意**: `type-fields` **不包含流程状态字段**，流程状态用 `next-statuses` 查询
+- 字段的类型（文本、选择、人员、日期等），决定了值的格式
+- 如果用户要修改的值不在选项列表中，提前告知用户，不要盲目调用
+
+**状态流转规则** (`next-statuses`，仅修改状态时需要)：
+- 第一步的 `card get` 已返回卡片当前状态 (`status` 和 `isFinishedStatus`)，无需再单独调用 `card current-status`
+- 返回的 `result[].statusName` 即为从当前状态可直接到达的目标状态列表
+- 如果 `result` 为空数组，说明当前状态没有可达的目标 (可能是终态或工作流未配置出边)，告知用户
+- 检查用户要修改的目标状态是否在返回的列表中
+- 如果目标状态不在列表中 → 提前告知用户"当前状态无法直接流转到目标状态"，确认是否使用 `--no-check-status` 强制跳过
+- 如果目标状态在列表中 → 向用户确认："当前状态为 X，将修改为 Y，是否继续？"
+
+> **提示**: `next-statuses` 比 `space type-statuses` 更精确。`type-statuses` 返回该类型所有合法状态，`next-statuses` 返回从当前状态可达的目标状态。但如果该类型未开启工作流，两者结果相同。
+
+> **提示**: `card current-status` 是一个轻量接口，仅返回状态信息 (statusName, isFinishedStatus)，适合只需查询状态而不需要完整卡片信息的场景。在本流程中，第一步已获取完整卡片信息，无需额外调用。
+
+## 第三步：向用户确认修改内容后执行
+
+汇总所有修改项，向用户展示并确认后执行：
+
+```bash
+icafe-cli card update --space <space> --sequence <sequence> \
+  --status <new_status> \
+  --assignee <new_assignee> \
+  --priority <new_priority> \
+  --fields "自定义字段=新值" \
+  --comment "修改原因说明"
+```
+
+## 第四步：验证更新结果
+
+```bash
+icafe-cli card get --space <space> --sequence <sequence> --brief
+```
+
+对比更新前后的数据，确认修改成功。
+
+**如果更新失败**，分析错误信息:
+
+| 常见错误 | 原因 | 解决方案 |
+|----------|------|----------|
+| HTTP 500 + `"流程状态不存在"` | 状态名不存在 | 用 `space type-statuses` 确认合法状态名 |
+| HTTP 500 + `"无法流转到该流程状态"` | 流转路径不合法 | 使用 `--no-check-status` 重试，或先用 `card next-statuses` 确认可达状态 |
+| HTTP 500 + `"无法到达该流程状态，还有必填字段没有填写: fieldName"` | 缺必填字段 | 在 `--fields` 中补充 |
+| HTTP 500 + `"field value error : 字段名=值"` | 值不合法 | 用 `space type-fields` 查询合法值 |
+| HTTP 500 + `"字段名: field does not exist!"` | 字段不存在 | 用 `space type-fields` 确认该类型有哪些字段 |
+| HTTP 403 | 无权限 | 告知用户联系管理员 |
+| HTTP 404 | space 或 sequence 错误 | 核实参数 |
+
+对于可重试的错误（如缺必填字段、字段值不合法），修正参数后自动重试一次；对于权限类错误，直接告知用户。
+
+## 决策流程图
+
+```
+用户要求修改卡片
+  │
+  ├─ 0. 确定卡片 (如果用户没给完整 space+sequence，参考智能寻卡工作流)
+  │
+  ├─ 1. card get --brief 获取卡片当前信息 (记录 type.name 用于后续查询)
+  │
+  ├─ 2. 并行获取: type-fields 字段定义 + next-statuses 可达状态 (如需改状态)
+  │   ├─ 字段值合法？
+  │   │   ├─ 合法 → 继续
+  │   │   └─ 不合法 → 告知用户正确的可选值 → 用户提供新值 → 重新检查
+  │   └─ 目标状态可达？
+  │       ├─ 可达 → 继续
+  │       └─ 不可达 → 告知用户，确认后使用 --no-check-status
+  │
+  ├─ 3. 汇总修改项，向用户确认 → card update 执行
+  │
+  └─ 4. card get --brief 验证结果
+      ├─ 成功 → 展示修改前后对比
+      └─ 失败 → 分析错误
+          ├─ 可重试（字段值/必填项/字段不存在） → 修正后重试
+          └─ 不可重试（权限等） → 告知用户
+```

package/comate-engine/assets/skills/icode-comate/SKILL.md

@@ -0,0 +1,366 @@
+---
+name: icode
+metadata:
+  author: icode
+  version: "1.0.0"
+  enableWhen:
+    - isInternal
+description: |
+  iCode 研发工具集，提供代码评审全流程自动化能力。支持登录认证、代码库克隆、CR 提交与追加、添加评审人、机器检查修复、AI 代码评审、打分与合入，覆盖从代码提交到合入的完整研发流程。
+---
+
+## 前置检查（必须执行）
+
+在执行任何 iCode 操作之前，先运行前置检查脚本验证环境：
+
+```bash
+./scripts/test-preflight.sh
+```
+
+> 注：`./scripts/` 路径相对于 skill 目录，执行时需使用完整路径（如 `~/.claude/skills/icode/scripts/test-preflight.sh`）。
+
+如果检查失败：
+- **icode-cli 未安装或版本过低**：执行 `curl -sSL http://icode-cli.bj.bcebos.com/install.sh | bash -s -- --no-skills` 强制安装最新版（要求 >= 0.1.8）
+- **未登录**：执行 `icode-cli login` 进行登录
+- **不是 git 仓库**：确保当前目录是有效的 git 仓库，或使用 `icode-cli git clone` 克隆代码库
+
+本 skill 依赖 `icafe-official` skill，如未安装请先执行：
+```bash
+ducc skill install icafe-official   # ducc/dodo 环境
+zulu skill install icafe-official   # comate-iCode 环境
+```
+
+## 功能概览
+
+### 1. 登录认证
+
+管理 iCode 认证状态。详见 [login.md](references/login.md)
+
+**常用命令：**
+
+- `login`: 检查登录状态或进行登录（交互式/非交互式）
+  ```bash
+  # 参考命令
+  icode-cli login
+  icode-cli login --token "eyJ..."
+  icode-cli login --method comate --token "Bearer-xxx"
+  ```
+  详见 [login.md](references/login.md)
+
+- `logout`: 登出并清除认证信息
+  ```bash
+  # 参考命令
+  icode-cli logout
+  ```
+  详见 [login.md](references/login.md)
+
+## 场景
+
+以下场景脚本位于 skill 的 `./scripts/` 目录，**但必须在 git 仓库目录下执行**（即用户的工作目录）。
+
+执行方式：在 git 仓库目录下，使用 skill 脚本的完整路径调用。
+
+### 1. 提交 CR
+
+智能判断新建 CR 或追加到已有 CR（Amend 模式）。
+```bash
+# 参考命令
+./scripts/submit-cr.sh [target-branch]
+```
+详见 [submit-cr.md](references/feature/submit-cr.md)
+
+**功能说明：**
+- 自动检测是否有工作区修改
+- 通过 commit hash 或 iCafe 卡片号匹配已有 CR
+- 匹配到则执行 amend 模式，否则新建 CR
+- 支持指定目标分支（默认 master）
+
+**Agent 执行约束：**
+- 新建 CR 时，脚本会提示输入 commit message
+- **必须先调用 `icafe-official` skill 获取 iCafe 卡片 ID**，然后以 `<卡片ID> <描述>` 格式输入（如 `ComateStack-5353 feat: add new feature`）
+- 这样可以确保 CR 与 iCafe 卡片正确关联，后续修改也能自动 amend 到同一 CR
+
+### 2. 添加评审人
+
+从历史 CR 中自动选择评审人，或使用指定的评审人。
+```bash
+# 参考命令
+./scripts/add-reviewer.sh [cr-number] [reviewer]
+```
+详见 [add-reviewer.md](references/feature/add-reviewer.md)
+
+**功能说明：**
+- 不指定 CR 时自动检测当前 commit 对应的 CR
+- 不指定评审人时从历史已合入的 CR 中随机选择
+- 支持手动指定评审人用户名
+
+### 3. 修复机器检查
+
+检测 CR 的机器检查结果，输出失败项详情供 Agent 分析修复。
+```bash
+# 参考命令
+./scripts/fix-machine-check.sh [cr-number] [max-retries]
+```
+详见 [fix-machine-check.md](references/feature/fix-machine-check.md)
+
+**功能说明：**
+- 获取机器检查结果（代码规范、缺陷检查等）
+- 输出失败项的详细信息（检查项、状态、行内评论）
+- 失败时退出码为 2，等待 Agent 修复后重新运行
+
+### 4. AI 代码评审
+
+**触发条件**: 当用户要求"AI 代码评审"、"AI 评审"、"ACR"时，**优先使用此脚本**
+触发 AI 代码评审并分析结果，发现问题时退出等待 Agent 修复。
+```bash
+# 参考命令
+./scripts/submit-acr.sh [cr-number] [max-loops] [timeout] [severity]
+```
+详见 [submit-acr.md](references/feature/submit-acr.md)
+
+**功能说明：**
+- 触发 AI 代码评审（start_ai_review）
+- 轮询等待评审完成（每 10 秒检查一次）
+- 过滤 severityScore >= 阈值的问题
+- 有问题时输出详情并退出（退出码 2）
+
+**严重度说明：**
+| severityScore | 说明 |
+|---------------|------|
+| 1-4 | 低优先级（忽略） |
+| 5-6 | 中优先级（需修复） |
+| 7-10 | 高优先级（必须修复） |
+
+### 5. 合入 CR
+
+尝试打分 +2 并合入 CR，通过打分结果判断是否有合入权限。
+```bash
+# 参考命令
+./scripts/merge-cr.sh [cr-number]
+```
+详见 [merge-cr.md](references/feature/merge-cr.md)
+
+**功能说明：**
+- 通过尝试打分 +2 检测是否有合入权限
+- 打分成功：尝试合入 CR
+- 打分失败：提示无权限，需联系管理员或找有权限的评审人
+- 合入失败时输出失败原因
+
+### 6. SSH 密钥配置
+
+自动检测并配置 SSH 密钥，用于 iCode Git 操作认证。
+```bash
+# 参考命令
+./scripts/ssh-setup.sh
+```
+详见 [ssh-setup.md](references/feature/ssh-setup.md)
+
+**功能说明：**
+- 检测本地是否存在 SSH 密钥（`~/.ssh/id_ed25519` 或 `~/.ssh/id_rsa`）
+- 若不存在则自动生成新的 ed25519 密钥对
+- 自动复制公钥到剪贴板（支持 macOS/Linux）
+- 引导用户访问 https://console.cloud.baidu-int.com/devops/icode/account/keys 完成密钥绑定
+
+## Git 操作
+
+提供与 iCode 平台集成的 Git 操作命令。详见 [icode-git.md](references/git/icode-git.md)
+
+```bash
+icode-cli git <command> [options]
+```
+
+**常用命令：**
+
+- `clone`: 克隆 iCode 代码库，自动配置认证
+  ```bash
+  # 参考命令
+  icode-cli git clone --repo baidu/icode/test --path ./local-path
+  ```
+  详见 [clone.md](references/git/clone.md)
+
+- `push`: 推送代码到指定分支
+  ```bash
+  # 参考命令
+  icode-cli git push --branch feature-x
+  ```
+  详见 [push.md](references/git/push.md)
+
+- `push_cr`: 提交代码到 Gerrit 进行代码评审
+  ```bash
+  # 参考命令
+  icode-cli git push_cr --branch master
+  ```
+  详见 [push_cr.md](references/git/push_cr.md)
+
+## API 操作
+
+提供对 iCode 平台各种 API 的命令行访问。详见 [icode-api.md](references/icode-api.md)
+
+```bash
+icode-cli api <command> [options] [-o json]
+```
+
+**常用命令：**
+
+- `get_repo_reviews`: 获取仓库CR列表
+  ```bash
+  # 参考命令
+  icode-cli api get_repo_reviews --repo baidu/icode/test
+  ```
+  详见 [get_repo_reviews.md](references/api/get_repo_reviews.md)
+
+- `get_my_reviews`: 获取我的评审列表
+  ```bash
+  # 参考命令
+  icode-cli api get_my_reviews
+  ```
+  详见 [get_my_reviews.md](references/api/get_my_reviews.md)
+
+- `get_repo_members`: 获取仓库成员列表
+  ```bash
+  # 参考命令
+  icode-cli api get_repo_members --repo baidu/icode/test
+  ```
+  详见 [get_repo_members.md](references/api/get_repo_members.md)
+
+- `get_review_info`: 获取CR详细信息
+  ```bash
+  # 参考命令
+  icode-cli api get_review_info -n 12345
+  ```
+  详见 [get_review_info.md](references/api/get_review_info.md)
+
+- `get_diff_file`: 获取commit变更文件
+  ```bash
+  # 参考命令
+  icode-cli api get_diff_file --repo baidu/icode/test --commit abc123
+  ```
+  详见 [get_diff_file.md](references/api/get_diff_file.md)
+
+- `get_diff_content`: 获取文件diff内容
+  ```bash
+  # 参考命令
+  icode-cli api get_diff_content --repo baidu/icode/test --commit abc123 --file src/main.go
+  ```
+  详见 [get_diff_content.md](references/api/get_diff_content.md)
+
+- `add_reviewers`: 添加评审人
+  ```bash
+  # 参考命令
+  icode-cli api add_reviewers -n 12345 --reviewers zhangsan
+  ```
+  详见 [add_reviewers.md](references/api/add_reviewers.md)
+
+- `set_review_score`: 设置评审分数
+  ```bash
+  # 参考命令
+  icode-cli api set_review_score --repo baidu/icode/test -n 12345 --score 2
+  ```
+  详见 [set_review_score.md](references/api/set_review_score.md)
+
+- `submit_review`: 合入CR
+  ```bash
+  # 参考命令
+  icode-cli api submit_review --repo baidu/icode/test -n 12345
+  ```
+  详见 [submit_review.md](references/api/submit_review.md)
+
+- `create_draft_comment`: 创建草稿评论
+  ```bash
+  # 参考命令
+  icode-cli api create_draft_comment --repo baidu/icode/test --change-number 12345 --patch-set-id 1 --path src/main.go --message "评论内容"
+  ```
+  详见 [create_draft_comment.md](references/api/create_draft_comment.md)
+
+- `publish_comments`: 发布草稿评论
+  ```bash
+  # 参考命令
+  icode-cli api publish_comments --repo baidu/icode/test --change-number 12345 --patch-set-id 1
+  ```
+  详见 [publish_comments.md](references/api/publish_comments.md)
+
+- `start_ai_review`: 触发AI代码评审
+  ```bash
+  # 参考命令
+  icode-cli api start_ai_review -n 12345
+  ```
+  详见 [start_ai_review.md](references/api/start_ai_review.md)
+
+- `get_ai_review`: 获取AI评审结果
+  ```bash
+  # 参考命令
+  icode-cli api get_ai_review -i <task_id>
+  ```
+  详见 [get_ai_review.md](references/api/get_ai_review.md)
+
+- `get_machine_check`: 获取机器检查结果
+  ```bash
+  # 参考命令
+  icode-cli api get_machine_check -n 12345
+  ```
+  详见 [get_machine_check.md](references/api/get_machine_check.md)
+
+- `check_repo_permission`: 检查代码库权限
+  ```bash
+  # 参考命令
+  icode-cli api check_repo_permission --repo baidu/icode/test
+  ```
+  详见 [check_repo_permission.md](references/api/check_repo_permission.md)
+
+- `get_repo_config`: 获取代码库配置
+  ```bash
+  # 参考命令
+  icode-cli api get_repo_config --repo-names baidu/icode/test
+  ```
+  详见 [get_repo_config.md](references/api/get_repo_config.md)
+
+- `get_submit_settings`: 获取提交规则配置
+  ```bash
+  # 参考命令
+  icode-cli api get_submit_settings --repo baidu/icode/test
+  ```
+  详见 [get_submit_settings.md](references/api/get_submit_settings.md)
+
+- `create_branch`: 创建新分支
+  ```bash
+  # 参考命令
+  icode-cli api create_branch --repo baidu/icode/test --branch feature-x --from master
+  ```
+  详见 [create_branch.md](references/api/create_branch.md)
+
+- `build_fetch_command`: 生成git fetch命令
+  ```bash
+  # 参考命令
+  icode-cli api build_fetch_command --change-number 12345
+  ```
+  详见 [build_fetch_command.md](references/api/build_fetch_command.md)
+
+## 典型工作流
+
+```bash
+# 1. 检查登录状态
+icode-cli login
+
+# 2. 开发完成后提交 CR
+./scripts/submit-cr.sh
+
+# 3. 修复机器检查问题（如有）
+./scripts/fix-machine-check.sh
+
+# 4. 运行 AI 代码评审
+./scripts/submit-acr.sh
+
+# 5. 添加评审人（如需要）
+./scripts/add-reviewer.sh
+
+# 6. 合入 CR
+./scripts/merge-cr.sh
+```
+
+## 退出码
+
+| 退出码 | 含义 |
+|--------|------|
+| 0 | 成功 |
+| 1 | 失败（无 CR / 超时 / 配置错误） |
+| 2 | 需要 Agent 修复或人工介入 |

package/comate-engine/assets/skills/icode-comate/references/api/add_reviewers.md

@@ -0,0 +1,44 @@
+# add_reviewers - 添加评审人
+
+为代码评审添加一个或多个评审人。
+
+## 命令格式
+
+```bash
+icode-cli api add_reviewers --change-number <评审编号> --reviewers <评审人列表>
+```
+
+## 参数说明
+
+| 参数 | 短参数 | 必填 | 默认值 | 说明 |
+|------|--------|------|--------|------|
+| `--change-number` | `-n` | 是 | - | 评审编号（数字） |
+| `--reviewers` | `-r` | 是 | - | 评审人用户名，多个用逗号分隔 |
+
+## 使用示例
+
+```bash
+# 添加单个评审人
+icode-cli api add_reviewers -n 12345 --reviewers zhangsan
+
+# 添加多个评审人
+icode-cli api add_reviewers --change-number 12345 --reviewers zhangsan,lisi,wangwu
+
+# 简写形式
+icode-cli api add_reviewers -n 12345 -r zhangsan,lisi
+```
+
+## 返回数据
+
+```
+Status: OK
+Message: 操作成功
+Added reviewers: zhangsan, lisi, wangwu
+```
+
+## 注意事项
+
+- 需要有该评审的编辑权限
+- 评审人用户名必须是有效的 iCode 用户
+- 多个评审人使用逗号分隔，不要有空格
+- 已经是评审人的用户会被忽略

package/comate-engine/assets/skills/icode-comate/references/api/build_fetch_command.md

@@ -0,0 +1,89 @@
+# build_fetch_command
+
+根据评审编号生成下载评审代码的 git fetch 命令。内部调用 `get_review_info` 获取评审详情，自动完成取模运算和路径拼接。
+
+## 命令格式
+
+```bash
+icode-cli api build_fetch_command --change-number <n> [-o json|yaml]
+```
+
+## 参数说明
+
+| 参数 | 短参数 | 必填 | 默认值 | 说明 |
+|------|--------|------|--------|------|
+| `--change-number` | `-n` | 是 | - | 评审编号 |
+| `--output` | `-o` | 否 | json | 输出格式：json、yaml |
+
+## 使用示例
+
+```bash
+# 生成 git fetch 命令
+icode-cli api build_fetch_command --change-number 12345
+```
+
+## 输出格式
+
+### JSON 格式（默认）
+
+```json
+{
+  "status": "OK",
+  "message": "git fetch command generated",
+  "data": {
+    "fetch_command": "git fetch ssh://zhangsan@icode.baidu.com:8235/baidu/icode/test refs/changes/45/12345/1 && git checkout FETCH_HEAD",
+    "project": "baidu/icode/test",
+    "change_number": 12345,
+    "current_revision": "1",
+    "ref_path": "refs/changes/45/12345/1"
+  }
+}
+```
+
+## 返回字段说明
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `fetch_command` | string | 完整的 git fetch 命令 |
+| `project` | string | 代码库名称 |
+| `change_number` | int | 评审编号 |
+| `current_revision` | string | 当前 PatchSet 版本 |
+| `ref_path` | string | Git ref 路径 |
+
+## ref_path 计算规则
+
+Git ref 路径格式为：`refs/changes/{last_two}/{change_number}/{revision}`
+
+- `last_two`: 评审编号对 100 取模，补零到两位（如 12345 -> 45）
+- `change_number`: 评审编号
+- `revision`: 当前 PatchSet 版本号
+
+## 使用场景
+
+1. **下载评审代码**：快速获取评审代码到本地
+2. **代码对比**：checkout 到评审代码版本进行对比
+3. **本地测试**：在本地测试评审中的代码
+4. **自动化脚本**：在脚本中自动获取评审代码
+
+## 典型用法
+
+```bash
+# 获取命令并执行
+eval $(icode-cli api build_fetch_command -n 12345 -o json | jq -r '.data.fetch_command')
+
+# 或者分步执行
+result=$(icode-cli api build_fetch_command -n 12345)
+fetch_cmd=$(echo "$result" | jq -r '.data.fetch_command')
+eval "$fetch_cmd"
+```
+
+## 注意事项
+
+- 需要先配置 SSH 密钥才能执行生成的 fetch 命令
+- 生成的命令会 checkout 到 FETCH_HEAD，这是一个临时引用
+- 如果需要在此基础上开发，建议创建新分支
+
+## 相关命令
+
+- `icode-cli api get_review_info`: 获取评审详情
+- `icode-cli git clone`: 克隆代码库

package/comate-engine/assets/skills/icode-comate/references/api/check_repo_permission.md

@@ -0,0 +1,89 @@
+# check_repo_permission
+
+检查当前用户是否有指定代码库的操作权限。
+
+## 命令格式
+
+```bash
+icode-cli api check_repo_permission --repo <repo-name> [--operation <operation>] [-o json|table|yaml]
+```
+
+## 参数说明
+
+| 参数 | 短参数 | 必填 | 默认值 | 说明 |
+|------|--------|------|--------|------|
+| `--repo` | `-r` | 是 | - | 代码库全名，格式如 `baidu/project/repo` |
+| `--operation` | `-p` | 否 | read | 操作类型 |
+| `--output` | `-o` | 否 | json | 输出格式：json、table、yaml |
+
+## 操作类型
+
+| 值 | 说明 |
+|------|------|
+| `read` | 读取权限（默认） |
+| `write` | 写入权限 |
+
+## 使用示例
+
+```bash
+# 检查是否有代码库的读权限
+icode-cli api check_repo_permission --repo baidu/icode/test
+
+# 检查指定操作权限
+icode-cli api check_repo_permission --repo baidu/icode/test --operation write
+
+# 以表格形式输出
+icode-cli api check_repo_permission --repo baidu/icode/test --output table
+```
+
+## 输出格式
+
+### JSON 格式（默认）
+
+```json
+{
+  "status": "OK",
+  "message": "",
+  "data": true
+}
+```
+
+### Table 格式
+
+```
+Repository: baidu/icode/test
+Operation: read
+Has Permission: Yes
+```
+
+## 返回字段说明
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `status` | string | 状态码，OK 表示成功 |
+| `message` | string | 状态消息 |
+| `data` | bool | 是否有权限，true 表示有权限 |
+
+## 使用场景
+
+1. **权限检查**：操作前检查是否有相应权限
+2. **条件执行**：根据权限决定后续操作
+3. **错误预防**：避免因权限不足导致的操作失败
+
+## 典型用法
+
+```bash
+# 在脚本中检查权限后再执行操作
+if icode-cli api check_repo_permission --repo baidu/icode/test -o json | jq -e '.data == true' > /dev/null; then
+  echo "有权限，继续执行..."
+  icode-cli api get_repo_config --repo-names baidu/icode/test
+else
+  echo "无权限，请申请访问"
+fi
+```
+
+## 相关命令
+
+- `icode-cli api get_repo_config`: 获取代码库配置
+- `icode-cli api get_submit_settings`: 获取提交规则配置
+- `icode-cli api get_repo_members`: 获取代码库成员