# tea-skills：基于 tea CLI 的 Gitea/Forgejo Agent 技能集

> tea-skills 为 AI Agent 提供了一套完整的 Gitea/Forgejo 代码托管平台操作能力，通过 tea CLI 实现 Issue、PR、里程碑和标签工作流的自动化管理。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-16T04:46:20.000Z
- 最近活动: 2026-05-16T05:20:29.013Z
- 热度: 163.4
- 关键词: tea-skills, Gitea, Forgejo, tea CLI, AI Agent, 代码托管, Issue管理, Pull Request, DevOps自动化, GitHub替代
- 页面链接: https://www.zingnex.cn/forum/thread/tea-skills-tea-cli-gitea-forgejo-agent
- Canonical: https://www.zingnex.cn/forum/thread/tea-skills-tea-cli-gitea-forgejo-agent
- Markdown 来源: ingested_event

---

# tea-skills：基于 tea CLI 的 Gitea/Forgejo Agent 技能集

## 项目概述

随着 AI Agent 在软件开发流程中的应用日益广泛，如何让 Agent 与代码托管平台无缝协作成为一个重要课题。tea-skills 项目应运而生，它为 AI Agent 提供了一套完整的 Gitea 和 Forgejo 平台操作能力，通过封装 tea CLI 命令，实现 Issue、Pull Request、里程碑和标签等核心工作流的自动化管理。

## 背景：Gitea、Forgejo 与 tea CLI

### Gitea 与 Forgejo

Gitea 是一个轻量级的自托管 Git 服务，使用 Go 语言编写，具有资源占用低、部署简单的特点。Forgejo 则是 Gitea 的一个社区驱动分支，在保持兼容性的同时增加了更多企业级功能。两者都提供了与 GitHub 类似的代码托管功能，包括：

- Git 仓库托管与管理
- Issue 跟踪系统
- Pull Request 代码审查
- 里程碑和标签管理
- CI/CD 集成
- 包管理

对于希望保持代码自主可控的组织和个人开发者来说，Gitea 和 Forgejo 是 GitHub 的优秀替代方案。

### tea CLI

tea 是 Gitea 官方提供的命令行工具，类似于 GitHub CLI (gh)。它允许用户从终端直接操作 Gitea/Forgejo 实例，无需打开浏览器。tea 支持的功能包括：

- 仓库克隆、创建和管理
- Issue 的创建、查询、编辑和关闭
- Pull Request 的创建、审查和合并
- 标签和里程碑管理
- 工作流运行监控

## tea-skills 的设计理念

### Agent 原生设计

tea-skills 的核心设计目标是为 AI Agent 提供"原生"的代码托管平台操作能力。这意味着：

**结构化输出**：不同于人类使用的交互式 CLI，tea-skills 确保所有输出都是结构化的（JSON/YAML），便于 Agent 解析和理解。

**错误恢复**：当操作失败时，提供清晰的错误信息和恢复建议，帮助 Agent 自主决策下一步行动。

**幂等性**：关键操作支持幂等执行，Agent 可以安全地重试失败的操作而不会产生副作用。

### 技能模块化架构

项目采用模块化的技能设计，每个功能域对应一个独立的技能模块：

| 技能模块 | 功能范围 |
|---------|---------|
| issue | Issue 的创建、查询、更新、评论、关闭和标签管理 |
| pr | Pull Request 的创建、审查、合并和冲突处理 |
| milestone | 里程碑的创建、进度跟踪和状态管理 |
| label | 标签的创建、应用和仓库标签体系管理 |
| repo | 仓库信息查询、分支管理和基本操作 |

## 核心能力详解

### Issue 工作流自动化

Issue 跟踪是项目管理的核心。tea-skills 的 issue 模块支持 Agent 执行以下操作：

**智能 Issue 创建**：Agent 可以根据对话上下文自动生成 Issue，自动提取标题、描述和标签。支持模板化创建，确保 Issue 格式统一。

**批量查询与筛选**：提供强大的查询 DSL，Agent 可以按状态、标签、里程碑、作者等多维度筛选 Issue。支持将查询结果导出为结构化数据供进一步分析。

**自动标签管理**：Agent 可以根据 Issue 内容自动建议或应用标签。例如，根据关键词识别 bug、feature、documentation 等类型。

**评论与状态同步**：Agent 可以在 Issue 中添加评论、更新进度，并将 Issue 状态与外部系统（如项目管理工具）同步。

### Pull Request 协作

代码审查是质量保证的关键环节。tea-skills 的 pr 模块让 Agent 能够深度参与 PR 流程：

**PR 创建辅助**：Agent 可以帮助开发者创建格式规范的 PR，自动填充描述模板，关联相关 Issue。

**变更摘要生成**：通过分析 diff，Agent 可以生成变更摘要，突出显示关键修改和潜在影响。

**审查状态跟踪**：Agent 可以监控 PR 的审查状态，提醒相关 reviewer，并在满足条件时自动合并。

**冲突检测与协助**：当 PR 出现合并冲突时，Agent 可以分析冲突原因并提供解决建议。

### 里程碑与项目管理

对于需要版本规划的项目，tea-skills 提供了里程碑管理能力：

**里程碑规划**：Agent 可以根据发布计划创建里程碑，设置截止日期，并关联相关 Issue 和 PR。

**进度跟踪**：实时监控里程碑完成度，识别阻塞 Issue，预测发布风险。

**报告生成**：自动生成里程碑进展报告，包括已完成工作、待办事项和延期风险分析。

## 使用场景示例

### 场景一：自动化 Bug 报告处理

当用户通过聊天机器人报告一个 bug 时，Agent 可以：

1. 分析用户描述，提取关键信息（问题现象、复现步骤、环境信息）
2. 自动在 Gitea 上创建格式化的 Issue
3. 根据关键词自动应用 "bug" 标签和适当的优先级
4. 如果检测到相似 Issue，添加关联引用
5. 向用户返回 Issue 链接和跟踪编号

### 场景二：PR 审查助手

当有新 PR 提交时，Agent 可以：

1. 获取 PR 的 diff 和描述
2. 分析代码变更，检查是否符合项目规范
3. 自动生成审查评论（如发现问题）或 LGTM 评论
4. 如果所有检查通过且获得足够审查批准，自动合并
5. 更新相关 Issue 的状态

### 场景三：发布管理

在准备新版本发布时，Agent 可以：

1. 检查里程碑中所有 Issue 的完成状态
2. 识别尚未合并的阻塞 PR
3. 生成发布说明草稿，汇总本次变更
4. 创建发布标签和 Git 标签
5. 关闭里程碑并通知团队

## 技术实现要点

### tea CLI 封装层

tea-skills 不直接调用 Gitea API，而是通过 tea CLI 进行封装。这种设计带来几个好处：

- **认证复用**：自动继承 tea 的配置和认证信息
- **命令复用**：利用 tea 成熟的命令实现，减少重复开发
- **输出标准化**：tea 的 JSON 输出模式提供了稳定的解析接口

### 配置管理

项目支持灵活的配置方式：

- **环境变量**：支持通过环境变量配置 Gitea 实例地址和认证信息
- **配置文件**：支持读取 tea 的配置文件，与现有 tea 用户环境兼容
- **运行时配置**：Agent 可以在运行时动态切换目标实例

### 错误处理与重试

网络操作难免失败，tea-skills 实现了健壮的错误处理：

- **分类错误码**：将 tea CLI 的错误输出分类为可重试错误、认证错误、权限错误等
- **指数退避**：对可重试错误实现指数退避重试
- **详细日志**：记录完整的操作日志，便于调试和审计

## 与其他工具的对比

| 特性 | GitHub CLI (gh) | tea CLI | tea-skills |
|------|----------------|---------|------------|
| 目标平台 | GitHub | Gitea/Forgejo | Gitea/Forgejo |
| 用户类型 | 人类开发者 | 人类开发者 | AI Agent |
| 输出格式 | 人类可读 | 人类/机器可读 | 机器优先 |
| Agent 集成 | 需适配 | 需适配 | 原生支持 |
| 错误恢复 | 手动 | 手动 | 自动 |
| 批量操作 | 有限 | 有限 | 优化支持 |

## 适用场景与价值

tea-skills 特别适合以下场景：

**自托管 Git 服务用户**：对于使用 Gitea 或 Forgejo 托管代码的团队，tea-skills 让 AI Agent 能够直接操作自己的代码平台，无需依赖 GitHub。

**隐私敏感项目**：对于代码不能托管在公有云平台的项目，可以在私有 Gitea 实例上使用 tea-skills 实现类似的自动化能力。

**CI/CD 集成**：在自托管的 CI/CD 流程中，tea-skills 可以作为 Agent 与代码平台的桥梁，实现更智能的流水线控制。

**企业内部工具**：对于已经部署了 Gitea/Forgejo 的企业，tea-skills 是构建内部 DevOps Agent 的基础组件。

## 未来发展方向

随着项目的发展，可以期待以下增强：

- **更多平台支持**：扩展到 GitLab、Bitbucket 等其他代码托管平台
- **高级分析能力**：集成代码分析工具，提供更智能的 PR 审查建议
- **工作流编排**：支持跨多个仓库、多个里程碑的复杂工作流编排
- **可视化集成**：与看板、甘特图等可视化工具集成

## 结语

tea-skills 填补了 AI Agent 与自托管代码托管平台之间的集成空白。对于使用 Gitea 或 Forgejo 的开发者来说，这是让 AI Agent 参与软件开发流程的重要工具。随着 AI 在软件开发中的应用越来越深入，这类基础设施组件将发挥越来越重要的作用。