forgejo

🔨 Forgejo 代码托管命令行助手

基于 tea CLI 的 Forgejo 平台交互工具,支持 PR/Issue/Actions 管理,助力开发者高效操作自托管代码仓库。

收藏
11.3k
安装
2.3k
版本
v0.1.0
CLS 安全性认证2026-05-10
点击查看完整报告 >

使用说明

Forgejo Skill 是一套基于 tea CLI 的文档型工具集,专为与 Forgejo(及 Gitea)代码托管平台交互而设计。该 Skill 通过封装 tea 命令行工具的标准用法,为用户提供了一套完整的仓库管理查询方案,涵盖 Pull Requests、Issues、CI/CD Actions 以及底层 API 访问等核心功能。

核心用法方面,用户首先需要使用 tea login add 配置 Forgejo 实例的访问令牌,建立身份认证后即可通过各类子命令操作仓库。支持的功能包括:tea pulls 列出和查看 PR 详情,tea issues 管理议题,tea actions 查询 CI/CD 密钥与变量配置,以及 tea api 结合 jq 进行高级数据筛选。所有命令均遵循标准 CLI 设计模式,支持通过 --repo--login 参数指定目标仓库和认证身份。

显著优点体现在多个维度。首先,作为纯 Markdown 文档型 Skill,其安全性极高,不包含任何可执行脚本或动态代码加载,彻底杜绝了代码注入风险。其次,tea CLI 本身是与 Gitea/Forgejo 官方兼容的成熟工具,命令语法直观且文档完善。此外,Skill 支持多实例登录管理,方便用户同时操作多个 Forgejo 服务器,特别适合企业内网部署或分布式团队协作场景。

潜在缺点与局限性同样值得关注。该 Skill 目前主要提供查询类功能示例,缺乏直接的写操作封装(如创建 PR、合并代码等),对于需要自动化修改仓库的进阶工作流支持有限。同时,Skill 依赖外部 tea CLI 工具,用户需自行处理安装和版本兼容问题。更重要的是,其来源为 T3 级社区项目(openclaw/skills),缺乏大型开源组织或企业的长期维护背书,在生产环境中的可信度需谨慎评估。

适合的目标群体主要包括:使用 Forgejo 作为自托管 Git 平台的开发团队、需要频繁查询仓库状态的 DevOps 工程师、以及偏好命令行工作流的后端开发者。对于已经部署 Forgejo 实例的企业用户,该 Skill 可作为日常运维和代码审查的辅助工具。

使用风险主要围绕凭证管理和环境安全展开。虽然 Skill 本身不收集数据,但 tea login add 需要用户输入访问令牌,若在不安全环境中操作可能导致凭证泄露。此外,tea actions secrets list 等命令可暴露 CI/CD 敏感配置,建议在受控环境中使用。由于依赖 tea CLI,用户还需关注该工具的更新维护状态,避免因上游变更导致功能失效。

安全解读

核心用法

Forgejo Skill 是一套基于 tea CLI 的纯文档型工具指引,专为 Forgejo 代码托管平台用户设计。该 Skill 不涉及任何可执行代码,仅提供标准化的命令行操作示例,涵盖四大核心场景:

1. Pull Requests 管理:通过 tea pullstea pr 命令列出、查看 PR 详情
2. Issues 追踪:使用 tea issuestea issue 管理项目 Issue

3. Actions CI/CD:调用 tea actions 子命令管理仓库密钥与变量

4. 高级 API 查询:借助 tea api 配合 jq 进行灵活的数据过滤与提取

使用前需通过 tea login add 配置 Forgejo 实例登录凭据,支持多实例切换。

显著优点

  • 零代码风险:T-MD 纯 Markdown 分类,无可执行代码块,彻底杜绝代码注入隐患
  • 来源可信:由 razzeee 维护,隶属 openclaw skills 项目,GitHub 提交历史完整可追溯
  • 广泛兼容:tea CLI 原生支持 Forgejo/Gitea 双平台,命令语法一致
  • 权限最小化:示例命令均为只读操作,不涉及写权限敏感操作
  • 配置灵活:支持多登录实例管理,便于同时操作多个 Forgejo 服务器

潜在缺点与局限性

  • 功能依赖外部 CLI:必须预先安装 tea CLI,无法独立运行
  • 无交互式体验:纯命令行指引,无图形化或对话式辅助
  • 平台专一性:专为 Forgejo/Gitea 生态设计,与 GitHub/GitLab CLI 语法不互通
  • 示例 URL 占位:文档中的 forgejo.example.com 需用户替换为实际实例地址
  • 无自动补全提示:依赖用户对 tea CLI 参数的记忆或查阅官方文档

适合人群

  • 使用 Forgejo 自托管代码仓库的开发者与团队
  • 偏好命令行工作流的 DevOps 工程师
  • 需要批量管理多实例仓库的运维人员
  • 熟悉 Gitea/Forgejo 生态的开源贡献者

常规风险

  • 凭据管理责任:用户需自行安全存储 API Token,Skill 本身不处理认证逻辑
  • 命令复制风险:用户直接复制示例命令时若未替换占位符(如 owner/repo),可能导致执行失败
  • tea CLI 版本差异:不同 tea 版本参数可能变化,建议定期核对官方文档
  • 实例 URL 配置错误:若登录时 URL 拼写错误,可能导致请求发送至非预期服务器

forgejo 内容

手动下载zip · 1.2 kB
SKILL.mdtext/markdown
请选择文件