---
name: gitea-api
description: |
  Gitea API 调用工具。用于与 Gitea 代码托管平台进行交互，包括仓库管理、用户管理、组织操作、Issue/PR 管理等。

  当用户提到以下场景时使用此 Skill：
  (1) 需要调用 Gitea API (如 /api/v1/ 开头的接口)
  (2) 需要在 Gitea 上创建/查询/管理仓库
  (3) 需要管理用户、组织、团队
  (4) 需要操作 Issue、Pull Request
  (5) 需要查看/管理 Git 提交、分支
  (6) 用户提到 "Gitea"、"代码托管"、"仓库管理"
version: 1.0.0
license: Apache-2.0
metadata:
  author: lirh
  category: development
  tags:
    - gitea
    - api
    - git
    - repository
---

# Gitea API Skill

## 快速开始

此 Skill 提供调用 Gitea API 的能力。API 基础 URL: `http://47.107.61.133:3000/api/v1`

认证方式：使用环境变量 `GITEA_TOKEN47` 作为 Bearer Token。

## 使用方法

### 方式一：使用封装好的工具函数

直接调用以下工具函数（见 scripts/gitea.js）：

- `gitea_get(endpoint, params)` - GET 请求
- `gitea_post(endpoint, data)` - POST 请求
- `gitea_patch(endpoint, data)` - PATCH 请求
- `gitea_delete(endpoint)` - DELETE 请求

示例：
```
调用 gitea_get 获取当前用户信息
调用 gitea_get 获取仓库列表
调用 gitea_post 创建新仓库
```

### 方式二：直接使用 curl

```bash
TOKEN=$GITEA_TOKEN47
curl -H "Authorization: token $TOKEN" http://47.107.61.133:3000/api/v1/user
```

## 常用 API 示例

### 用户相关
- `GET /user` - 获取当前用户信息
- `GET /users/{username}` - 获取指定用户信息
- `GET /users/{username}/repos` - 获取用户仓库列表

### 仓库相关
- `GET /repos/{owner}/{repo}` - 获取仓库信息
- `POST /user/repos` - 创建仓库（当前用户）
- `POST /orgs/{org}/repos` - 在组织中创建仓库
- `GET /repos/{owner}/{repo}/branches` - 获取分支列表
- `GET /repos/{owner}/{repo}/commits` - 获取提交历史

### Issue 相关
- `GET /repos/{owner}/{repo}/issues` - 获取 Issue 列表
- `POST /repos/{owner}/{repo}/issues` - 创建 Issue
- `GET /repos/{owner}/{repo}/issues/{index}` - 获取 Issue 详情
- `PATCH /repos/{owner}/{repo}/issues/{index}` - 更新 Issue

### 组织相关
- `GET /orgs` - 获取组织列表
- `GET /orgs/{org}` - 获取组织详情
- `POST /orgs` - 创建组织
- `GET /orgs/{org}/members` - 获取组织成员

### 管理相关 (需要管理员权限)
- `GET /admin/users` - 列出所有用户
- `POST /admin/users` - 创建用户
- `DELETE /admin/users/{username}` - 删除用户

## 错误处理

API 返回状态码说明：
- 200/201: 成功
- 204: 成功（无返回内容）
- 400: 请求参数错误
- 401: 未认证
- 403: 权限不足
- 404: 资源不存在
- 422: 验证错误
- 500: 服务器错误