SuperAPI AI 工具集

git-onboarding-step

编程与开发

查看项目

更新于 10-15 18:25

技能介绍

用途

该技能用于展示 Git 学习与配置的整体进度。它把从 Git 安装到创建 Pull Request 的流程拆分为 10 个步骤,以清单形式呈现,并引导用户前往下一步该做的事。适用问题包括“我做到哪一步了”“当前进度如何”“下一步做什么”。

主要能力

技能会收集本地环境的实际状态,并对 10 个环节逐一判定是否完成:

  1. Git 安装
  2. 用户名设置
  3. 邮箱设置
  4. GitHub CLI 安装
  5. GitHub 登录
  6. 仓库准备
  7. 分支创建
  8. 第一次提交
  9. Push
  10. Pull Request 创建

状态采集通过并行执行一系列命令完成,例如 which git、git config --global user.name、git config --global user.email、gh auth status、git rev-parse --git-dir、git branch --show-current、git log 相关命令以及 gh pr list 等,分别用于确认安装情况、配置、认证、仓库、分支、提交、未推送提交与 PR 状态。

判定规则

每个步骤有明确的完成条件,例如:用户名或邮箱配置值非空即视为完成(完成时会显示括号中的配置值);当前分支不是 main/master 视为分支创建完成;无未推送提交视为 Push 完成。特殊规则包括:若仓库尚未准备,则分支创建判定为未完成;若 upstream 未设置导致命令失败,则 Push 视为未完成;若未安装 gh CLI,则 PR 创建显示为“确认不可”。

使用方式与输出

输出采用代码块中的清单形式:已完成项标 [x],未完成项标 [ ],并在第一个未完成项旁标注“<-- 当前阶段”,确认不可的项标 [?]。清单之后会针对第一个未完成步骤说明其意义与解决办法:前 6 步引导执行 /git-onboarding-setup,第 7 至 10 步引导执行 /git-onboarding-workflow。当 10 项全部完成时,会输出全完成提示。

该技能本身只展示状态,不执行实际配置或操作,具体执行委托给 /git-onboarding-setup 与 /git-onboarding-workflow。

适用场景

适合 Git 初学者按步骤完成环境搭建与首次协作流程,随时查看自己处在哪一步,并明确下一步去向。

限制

技能不执行实际配置操作,仅作状态检查与引导;PR 环节在缺少 gh CLI 时无法确认;其他未在资料中说明的细节暂未提供。