SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场x-git

x-git

编程与开发

查看项目

更新于 10-16 06:00

技能介绍

用途

x-git 是 x-cmd 生态中的一个技能，目标是在终端内统一管理 Git 与多个代码托管平台。它把 GitHub、GitLab、Codeberg、自建 Forgejo 等平台的常用操作收敛为一组命令行子命令，供开发者、DevOps 工程师和开源贡献者进行仓库管理、协作评审、Issue 跟踪、工作流自动化和团队管理。

主要能力

GitHub 管理（gh）

用法：x gh [subcommand] 主要子命令：repo（仓库管理）、issue（议题跟踪与管理）、pr（拉取请求管理）、action（GitHub Actions 工作流管理）、user（用户资料与账号管理）、search（仓库与主题搜索）、browse（在浏览器中打开 GitHub 资源）。 示例：x gh user info、x gh repo app、x gh repo clone owner/repo、x gh pr create、x gh action workflow。

GitLab 管理（gl）

用法：x gl [subcommand] 主要子命令：repo、issue、mr（合并请求）、user、group（群组与团队管理）、deploy（部署管理）、snippet（代码片段管理）。 示例：x gl repo ls、x gl mr create、x gl user info、x gl group ls、x gl repo clone project。

Codeberg 管理（cb）

用法：x cb [subcommand] 主要子命令：repo、user、org（组织管理）、issue、pr、notification（通知处理）。 示例：x cb repo ls、x cb user info、x cb issue create、x cb pr list、x cb repo clone owner/repo。

Forgejo 管理（fjo）

面向自建 Forgejo 实例。用法：x fjo [subcommand] 主要子命令：repo、user、org、issue、notification。 示例：x fjo repo ls、x fjo user info、x fjo issue create、x fjo pr create、x fjo repo clone project。

Git Hooks 管理（githook）

用法：x githook [subcommand] 主要子命令：apply（应用 Git hooks 配置）、clear（清除 hooks 并移除配置）。 示例：x githook apply、x githook clear。

使用方式

前置条件：已安装 x-cmd CLI、已安装并配置 Git、平台操作需要网络连接。

各平台认证配置：

  • GitHub：x gh init 或 x gh --cfg token=<github-token>，Token 获取地址 https://github.com/settings/tokens
  • GitLab：x gl init 或 x gl --cfg token=<gitlab-token>，Token 获取地址 https://gitlab.com/-/profile/personal_access_tokens
  • Codeberg：x cb init 或 x cb --cfg token=<codeberg-token>，Token 获取地址 https://codeberg.org/user/settings/applications
  • Forgejo：x fjo init 或 x fjo --cfg token=<forgejo-token>，需配置 Forgejo 实例与 Token

Git Hooks 配置：x githook apply 应用配置，x githook clear 清除配置。

与其他工具的集成：可使用 --co 标志启用 AI 代码副驾驶功能；使用 ddgoai 进行 AI 搜索与摘要；将输出管道传给 x jq 处理 JSON；结合 @zh 进行中文翻译；导出为 CSV/TSV 用于报告与分析；与 x curl 结合进行 API 交互；配合 shell 脚本实现自动化，并集成到 CI/CD 流水线。

适用场景

  • 仓库管理：用 x gh repo、x gl repo、x cb repo、x fjo repo 分别操作各平台仓库。
  • 协作与代码评审：用 x gh pr、x gl mr、x cb pr、x fjo pr 处理拉取请求与合并请求。
  • Issue 跟踪与项目管理：用各平台的 issue 子命令管理议题。
  • CI/CD 与自动化：用 x gh action 管理 GitHub Actions 工作流，用 GitLab 部署功能处理 CI/CD，用 x githook 做本地 Git 自动化。
  • 用户与团队管理：用 x gh user、x gl user/x gl group、x cb user/x cb org、x fjo user/x fjo org 进行账号与组织管理。

限制与注意事项

常见问题包括：认证错误（需核对 API Token 与权限）、网络连接问题、权限不足（需确保仓库访问权限）、配置问题（需核对平台相关设置）。性能方面建议使用具体查询而非宽泛搜索、安全缓存认证 Token、对复杂操作用交互界面、限制 API 调用以遵守速率限制。安全最佳实践包括安全存储并定期轮换 Token、遵循最小权限原则、保留平台操作审计记录、确保使用符合平台服务条款。

相关文档：x-cmd Git 文档 https://x-cmd.com/mod/git ；GitHub CLI https://x-cmd.com/mod/gh ；GitLab CLI https://x-cmd.com/mod/gl ；Codeberg CLI https://x-cmd.com/mod/cb ；Forgejo CLI https://x-cmd.com/mod/fjo ；Git Hooks https://x-cmd.com/mod/githook 。特定工具帮助可使用 x [tool] --help。