核心用法
Gitee Skill 是一套面向中国开发者的命令行自动化方案，通过 curl + jq 调用 Gitee OpenAPI v5，辅以原生 git 命令完成仓库全生命周期管理。核心能力覆盖四大场景：
1. Pull Request 管理：列出/查看/创建 PR，支持指定 head/base 分支及详情描述
2. Issue 追踪：按仓库筛选议题状态，支持创建带描述的工单
3. 文件内容读取：通过 API 获取仓库内指定路径的文件原始内容或元数据
4. Git 传输层：克隆、推送、多远程管理，兼容 HTTPS 与 SSH 协议
操作模式遵循「API 优先」原则：需要结构化数据或自动化流程时用 curl，涉及分支/提交/推送时用 git，避免混淆二者边界。
显著优点
- 本土化适配：针对 gitee.com 域名与 OpenAPI 路径设计，URL 模式、认证参数、分页逻辑均贴合国内平台特性
- 零依赖 CLI：仅需
curl、git、jq三个系统级工具，无需安装额外 SDK 或语言运行时 - 安全隔离：强制通过
GITEE_ACCESS_TOKEN环境变量注入 OAuth2 Token，禁止硬编码或日志泄露 - 可组合性强：所有示例均为可复制的 Shell 片段，易于嵌入 CI/CD、定时任务或本地脚本
潜在局限
- 功能覆盖有限：未实现 Gitee 企业版、Webhooks、部署密钥、成员权限管理等高级功能
- 无原生交互体验：相比官方
gitee-cli或图形界面，缺少命令补全、进度条、冲突可视化等增强 - API 差异成本：Issue 路由与 GitHub 不同（
/repos/{owner}/issues+repo字段），迁移脚本需改写 - Token 权限颗粒粗：个人令牌按「projects」「pull_requests」「issues」等大类授权，无法细粒度限制到单仓库
适合人群
- 习惯终端工作流、需批量处理 Gitee 仓库的开发者
- 在 GitHub 与 Gitee 双平台同步的维护者（作为 GitHub CLI 的补充）
- 构建内部自动化流水线（如镜像同步、Issue 迁移、发布机器人）的 DevOps 工程师
常规风险
- 令牌泄露：
access_token出现在 URL query 时可能被服务器日志记录，建议优先放 Header（Gitee 文档支持Authorization: token $TOKEN） - 误操作仓库：
git push默认指向origin，多远程场景需显式指定远程名，防止推送到错误仓库 - API 限流：未明确说明限流策略，高频自动化需自行实现退避重试
- Schema 变更：Gitee API 非完全语义化版本，字段增减可能导致
jq解析失败