用途
该技能用于展示 Git 学习与配置的整体进度。它把从 Git 安装到创建 Pull Request 的流程拆分为 10 个步骤,以清单形式呈现,并引导用户前往下一步该做的事。适用问题包括“我做到哪一步了”“当前进度如何”“下一步做什么”。
主要能力
技能会收集本地环境的实际状态,并对 10 个环节逐一判定是否完成:
- Git 安装
- 用户名设置
- 邮箱设置
- GitHub CLI 安装
- GitHub 登录
- 仓库准备
- 分支创建
- 第一次提交
- Push
- 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 时无法确认;其他未在资料中说明的细节暂未提供。