mcpField
F
forgejo-cli-ops

forgejo-cli-ops

github.com/daisuke897开发048 次安装1 周前更新
代码仓库

关于 forgejo-cli-ops

forgejo-cli-ops 是一项技能，指导使用 `fj` CLI 登录 Forgejo，并执行常见的仓库、Issue 和 PR 操作。它还说明主机选择方式及登录故障排查。

主要功能

  1. 01Forgejo 身份验证与访问检查
  2. 02使用 `-H` 或 `FJ_HOST` 选择主机
  3. 03常见仓库、Issue 和 PR 命令
  4. 04登录及主机不匹配故障排查
  5. 05使用 `secret-tool` 可选存储令牌

适用场景

  1. 01设置 `fj` 对 Forgejo 主机的访问
  2. 02检查当前账户和身份验证状态
  3. 03执行 Issue、PR 或仓库命令
  4. 04排查主机选择导致的登录失败

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/daisuke897/dotfiles --skill forgejo-cli-ops

安装后在 Claude Code 中输入/forgejo-cli-ops确认已加载。

详细介绍

范围

  • 验证 Forgejo 主机身份并确认访问权限。
  • 使用正确的主机运行常见的问题 / PR / 仓库命令。
  • 排查主机和登录信息不匹配的问题。

前提条件

  • 在 Forgejo 网页界面中创建的 Forgejo 个人访问令牌（PAT）。
  • 已安装 fj，且可在 PATH 中找到。
  • 可选：使用 secret-tool（GNOME Keyring）安全存储令牌。

主机用法（重要）

-H/--host 是一个全局选项，必须放在子命令之前。

fj -H <FORGEJO_HOST> repo view <owner>/<repo>

为避免重复指定主机，可设置 FJ_HOST：

export FJ_HOST=<FORGEJO_HOST>

身份验证（secret-tool 示例）

存储令牌（仅需一次），并使用 fj 注册：

echo -n "<PAT_VALUE>" | secret-tool store --label="Forgejo PAT" service forgejo user <username>@<FORGEJO_HOST>
echo -n "$(secret-tool lookup service forgejo user <username>@<FORGEJO_HOST>)" | fj -H <FORGEJO_HOST> auth add-key <username>

验证：

fj -H <FORGEJO_HOST> auth list
fj -H <FORGEJO_HOST> whoami

清理

fj auth logout <FORGEJO_HOST>
secret-tool clear service forgejo user <username>@<FORGEJO_HOST>

故障排查

  • Error: not logged in 通常表示主机默认设为 github.com；请添加 -H 或设置 FJ_HOST。
  • 如果 secret-tool lookup 未返回任何内容，请解锁密钥环，或确认已存储的用户 / 主机密钥。

评论

支持 Markdown