5 分钟快速上手

本页介绍 /gf-workflow 四阶段 Agent 编排的上手流程。若只想直接用 gf issue/pr/release 等底层 CLI 命令,无需 Claude Code / Skills,可跳过本页,直接安装 gf 后执行 gf auth login 与对应命令即可,详见 README「30 秒上手」。

0. 前置条件

以下前置条件仅针对 Agent 编排使用(/gf-workflow)。跑 /gf-workflow 前需准备好 Agent 运行环境与技能来源:

  • Claude Code — Agent 运行环境。推荐原生安装(curl -fsSL https://claude.ai/install.sh | bash,自带二进制、无需 Node.js);若用 npm 安装则需 Node.js 22+。
  • 技能来源 — superpowers 或 mattpocock-skills 之一,/gf-workflow 的编排引擎来自其中之一。未安装任一来源时 gf skills install 会硬阻断并中止。
  • Node.js ≥ 22.20.0 — 仅安装 mattpocock-skills 来源时需要:claude plugins install mattpocock-skills 与 npx skills@latest 都会拉起 mattpocock/skills 工具链(其 skills CLI 要求 Node ≥ 22.20.0)。superpowers 为纯 skills,无需 Node.js。先运行 node --version 确认。

安装技能来源(任选其一):

claude plugins install superpowers        # 全自动流水线
claude plugins install mattpocock-skills  # 人工驾驶流水线(需 Node.js ≥ 22.20.0)
# 或
npx skills@latest add mattpocock/skills   # 需 Node.js ≥ 22.20.0

1. 安装 gf

brew tap byx-darwin/tap && brew install gf
# 或
cargo install gitflow-cli

2. 安装 Skills

gf skills install        # 项目级(推荐,跟随仓库)
gf skills install -g     # 全局(所有项目可用)

不指定 --agent 时默认安装到 Claude Code。其他平台需显式指定 --agent codex|open-code|gemini|copilot|qoder|pi。

需先完成第 0 步安装技能来源,否则 gf skills install 会因「未检测到任何技能来源」而中止。

3. 验证

gf skills list           # 应看到 30 个 gf-* skills
gf --version

4. 开始开发

在支持的 Agent 平台中输入:

/gf-workflow 我要做 X

即可进入四阶段编排:需求澄清 → 计划制定 → 执行 → 交付后检查。

平台会基于 git remote 自动检测(GitHub / GitLab / GitCode),也可用 --platform 手动指定。