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

tea-skills是为AI Agent提供Gitea/Forgejo代码托管平台操作能力的技能集，通过封装tea CLI实现Issue、PR、里程碑和标签等核心工作流的自动化管理。它解决了AI Agent与自托管代码平台无缝协作的问题，让Agent能直接参与软件开发流程，适用于需要代码自主可控的组织和个人开发者。

Gitea与Forgejo

Gitea是轻量级自托管Git服务，资源占用低、部署简单；Forgejo是其社区驱动分支，增加企业级功能。两者均提供Git仓库托管、Issue跟踪、PR审查等GitHub类似功能，是GitHub的优秀替代方案。

tea CLI

tea是Gitea官方命令行工具，支持仓库管理、Issue/PR操作、标签/里程碑管理等终端操作，无需浏览器即可交互Gitea/Forgejo实例。

Agent原生设计

• 结构化输出：确保所有输出为JSON/YAML格式，便于Agent解析
• 错误恢复：提供清晰错误信息与恢复建议
• 幂等性：关键操作支持安全重试

技能模块化架构

技能模块	功能范围
issue	Issue创建、查询、更新、评论、标签管理
pr	PR创建、审查、合并、冲突处理
milestone	里程碑创建、进度跟踪、状态管理
label	标签创建、应用、体系管理
repo	仓库查询、分支管理

Issue工作流自动化

• 智能创建：根据上下文生成Issue，自动提取标题/描述/标签
• 批量查询：多维度筛选Issue并导出结构化数据
• 自动标签：根据内容建议或应用标签
• 评论同步：添加评论、更新状态并同步外部系统

PR协作

• 创建辅助：填充描述模板、关联Issue
• 变更摘要：分析diff生成关键修改说明
• 审查跟踪：监控状态、提醒 reviewer、自动合并
• 冲突协助：分析冲突原因并提供解决建议

里程碑管理

• 规划：创建里程碑、设置截止日期、关联Issue/PR
• 进度跟踪：监控完成度、识别阻塞项
• 报告生成：自动生成进展报告

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

用户报告bug时，Agent可分析描述提取信息，自动创建格式化Issue，应用标签，关联相似Issue并返回链接。

场景二：PR审查助手

新PR提交时，Agent分析diff检查规范，生成审查评论或LGTM，满足条件时自动合并并更新Issue状态。

场景三：发布管理

准备发布时，Agent检查里程碑完成状态，识别阻塞PR，生成发布说明，创建标签并关闭里程碑。

tea CLI封装层

不直接调用API，通过tea CLI封装：

• 认证复用：继承tea配置与认证信息
• 命令复用：利用tea成熟命令减少开发
• 输出标准化：依赖tea的JSON输出接口

配置管理

• 环境变量：配置实例地址与认证
• 配置文件：兼容现有tea用户环境
• 运行时配置：动态切换目标实例

错误处理

• 分类错误码：区分可重试/认证/权限错误
• 指数退避：可重试错误自动重试
• 详细日志：记录操作日志便于调试

适用场景

• 自托管Git服务用户：直接操作Gitea/Forgejo
• 隐私敏感项目：私有实例实现自动化
• CI/CD集成：作为Agent与代码平台的桥梁
• 企业内部工具：构建DevOps Agent基础组件

工具对比

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

未来发展

• 扩展支持GitLab、Bitbucket等平台
• 集成代码分析工具提供智能审查建议
• 支持跨仓库/里程碑的工作流编排
• 与可视化工具集成

结语

tea-skills填补了AI Agent与自托管代码平台的集成空白，是Gitea/Forgejo用户让AI参与开发流程的重要工具，将随AI在开发中的应用发挥更大作用。