git-onboarding-step

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Git 진행 상황 체크리스트

Git进度检查清单

전체 10단계의 진행 상황을 확인하고 현재 단계를 안내합니다. 이 스킬은 상태만 보여주고, 실제 실행은 /git-onboarding-setup 또는 /git-onboarding-workflow에 위임합니다.

可查看总共10个步骤的进度，引导当前所处步骤。本技能仅展示状态，实际执行操作请调用/git-onboarding-setup或/git-onboarding-workflow。

상태 수집

状态收集

아래 명령어를 모두 병렬로 실행하세요:

```
which git
```
— Git 설치 여부
```
git config --global user.name
```
— 사용자 이름
```
git config --global user.email
```
— 이메일

which gh 2>/dev/null && echo "installed" || echo "none"

— GitHub CLI 설치 여부

```
gh auth status 2>&1
```
— GitHub 인증 상태

git rev-parse --git-dir 2>/dev/null && echo "repo" || echo "no-repo"

— 저장소 여부

```
git branch --show-current 2>/dev/null
```
— 현재 브랜치
```
git log --oneline -1 2>/dev/null
```
— 커밋 존재 여부
```
git log @{u}.. --oneline 2>/dev/null
```
— 미push 커밋

which gh >/dev/null 2>&1 && gh pr list --head "$(git branch --show-current 2>/dev/null)" --json number --jq '.[0].number' 2>/dev/null || echo "gh-unavailable"

— PR 존재 여부

请全部并行执行以下命令：

```
which git
```
— 检查Git是否安装
```
git config --global user.name
```
— 检查用户名配置
```
git config --global user.email
```
— 检查邮箱配置

which gh 2>/dev/null && echo "installed" || echo "none"

— 检查GitHub CLI是否安装

```
gh auth status 2>&1
```
— 检查GitHub认证状态

git rev-parse --git-dir 2>/dev/null && echo "repo" || echo "no-repo"

— 检查是否为Git仓库

```
git branch --show-current 2>/dev/null
```
— 查看当前分支
```
git log --oneline -1 2>/dev/null
```
— 检查是否存在提交记录
```
git log @{u}.. --oneline 2>/dev/null
```
— 检查未推送的提交

which gh >/dev/null 2>&1 && gh pr list --head "$(git branch --show-current 2>/dev/null)" --json number --jq '.[0].number' 2>/dev/null || echo "gh-unavailable"

— 检查是否存在PR

체크리스트 판정

检查清单判定

각 항목의 완료 조건:

단계	항목	완료 조건
1	Git 설치	`which git` 이 경로를 반환
2	사용자 이름 설정	`git config --global user.name` 이 비어있지 않음
3	이메일 설정	`git config --global user.email` 이 비어있지 않음
4	GitHub CLI 설치	`which gh` 가 경로를 반환
5	GitHub 로그인	`gh auth status` 출력에 "Logged in" 포함
6	저장소 준비	`git rev-parse --git-dir` 성공
7	브랜치 생성	현재 브랜치가 main/master가 아닌 feature 브랜치
8	첫 번째 커밋	`git log --oneline -1` 이 결과를 반환
9	Push	`git log @{u}..` 이 빈 결과 (미push 커밋 없음)
10	Pull Request 생성	gh CLI로 현재 브랜치의 PR 번호가 확인됨

各项目的完成条件：

步骤	项	完成条件
1	Git安装	`which git` 返回路径
2	用户名配置	`git config --global user.name` 不为空
3	邮箱配置	`git config --global user.email` 不为空
4	GitHub CLI安装	`which gh` 返回路径
5	GitHub登录	`gh auth status` 输出包含"Logged in"
6	仓库准备	`git rev-parse --git-dir` 执行成功
7	分支创建	当前分支不是main/master，而是feature分支
8	首次提交	`git log --oneline -1` 返回结果
9	Push	`git log @{u}..` 结果为空（无未推送提交）
10	Pull Request创建	通过gh CLI可查询到当前分支的PR编号

특수 판정 규칙

特殊判定规则

단계 7: main/master에 있으면 미완료. 단, 저장소가 없으면(단계 6 미완료) 판정 불가 → 미완료 처리
단계 9: upstream이 설정되지 않아 명령어가 실패하면 미완료
단계 10: gh CLI가 미설치(
```
gh-unavailable
```
)이면 "확인 불가"로 표시

步骤7：处于main/master分支则未完成。若不存在仓库（步骤6未完成）则无法判定 → 按未完成处理
步骤9：未配置upstream导致命令执行失败则未完成
步骤10：gh CLI未安装（返回
```
gh-unavailable
```
）则标记为「无法确认」

출력 형식

输出格式

코드 블록 안에 아래 형식으로 출력하세요.

완료된 항목:
```
[x]
```
미완료 항목:
```
[ ]
```
첫 번째 미완료 항목 옆에:
```
<-- 현재 단계
```
단계 2, 3은 완료 시 설정값을 괄호 안에 표시
단계 10이 확인 불가면:
```
[?]
```
로 표시

Git 시작하기 — 현재 진행 상황

  [x] 1. Git 설치
  [x] 2. 사용자 이름 설정 (홍길동)
  [x] 3. 이메일 설정 (user@email.com)
  [x] 4. GitHub CLI 설치
  [ ] 5. GitHub 로그인            <-- 현재 단계
  [ ] 6. 저장소 준비
  [ ] 7. 브랜치 생성
  [ ] 8. 첫 번째 커밋
  [ ] 9. Push
  [ ] 10. Pull Request 생성

请在代码块中按照以下格式输出：

已完成项：
```
[x]
```
未完成项：
```
[ ]
```
第一个未完成项旁标注：
```
<-- 当前步骤
```
步骤2、3完成时将配置值放在括号内展示
步骤10无法确认时：标记为
```
[?]
```

Git入门 — 当前进度

  [x] 1. Git安装
  [x] 2. 用户名配置 (张三)
  [x] 3. 邮箱配置 (user@email.com)
  [x] 4. GitHub CLI安装
  [ ] 5. GitHub登录            <-- 当前步骤
  [ ] 6. 仓库准备
  [ ] 7. 分支创建
  [ ] 8. 首次提交
  [ ] 9. Push
  [ ] 10. Pull Request创建

현재 단계 설명

当前步骤说明

체크리스트 출력 후, 첫 번째 미완료 단계에 대해 아래 내용을 안내하세요:

输出检查清单后，请针对第一个未完成步骤说明以下内容：

단계 1: Git 설치

步骤1：Git安装

왜 필요한지: Git은 코드의 변경 이력을 관리하는 도구입니다. 모든 작업의 기반이 됩니다.
해결 방법:
```
/git-onboarding-setup
```
을 실행하세요.

为什么需要： Git是管理代码变更历史的工具，是所有操作的基础。
解决方法： 执行
```
/git-onboarding-setup
```
。

단계 2: 사용자 이름 설정

步骤2：用户名配置

왜 필요한지: 커밋할 때 "누가 이 변경을 했는지" 기록됩니다. 협업 시 필수입니다.
해결 방법:
```
/git-onboarding-setup
```
을 실행하세요.

为什么需要： 提交代码时会记录「谁做了本次变更」，是协作开发的必备配置。
解决方法： 执行
```
/git-onboarding-setup
```
。

단계 3: 이메일 설정

步骤3：邮箱配置

왜 필요한지: GitHub가 커밋과 계정을 연결하는 데 사용됩니다. GitHub 계정 이메일과 일치해야 잔디(contribution)가 심어집니다.
해결 방법:
```
/git-onboarding-setup
```
을 실행하세요.

为什么需要： GitHub会用该邮箱关联提交记录与账号，需要与GitHub账号邮箱一致才能点亮贡献度（contribution）图标。
解决方法： 执行
```
/git-onboarding-setup
```
。

단계 4: GitHub CLI 설치

步骤4：GitHub CLI安装

왜 필요한지: GitHub CLI(gh)는 터미널에서 GitHub 로그인, PR 생성 등을 쉽게 할 수 있는 도구입니다.
해결 방법:
```
/git-onboarding-setup
```
을 실행하세요.

为什么需要： GitHub CLI(gh)是可以在终端中快速完成GitHub登录、PR创建等操作的工具。
解决方法： 执行
```
/git-onboarding-setup
```
。

단계 5: GitHub 로그인

步骤5：GitHub登录

왜 필요한지: GitHub에 로그인해야 push/pull과 PR 생성이 가능합니다.
해결 방법:
```
/git-onboarding-setup
```
을 실행하세요.

为什么需要： 只有登录GitHub后才能执行push/pull、创建PR等操作。
解决方法： 执行
```
/git-onboarding-setup
```
。

단계 6: 저장소 준비

步骤6：仓库准备

왜 필요한지: Git으로 관리할 프로젝트 폴더가 필요합니다. clone(기존 프로젝트) 또는 init(새 프로젝트)으로 시작합니다.
해결 방법:
```
/git-onboarding-setup
```
을 실행하세요.

为什么需要： 需要有Git管理的项目文件夹，可通过clone（已有项目）或init（新项目）初始化。
解决方法： 执行
```
/git-onboarding-setup
```
。

단계 7: 브랜치 생성

步骤7：分支创建

왜 필요한지: main 브랜치는 완성된 코드만 유지합니다. 새 기능은 별도 브랜치에서 작업해야 안전합니다.
해결 방법:
```
/git-onboarding-workflow
```
를 실행하세요.

为什么需要： main分支仅保留已完成的稳定代码，新功能在独立分支开发更安全。
解决方法： 执行
```
/git-onboarding-workflow
```
。

단계 8: 첫 번째 커밋

步骤8：首次提交

왜 필요한지: 커밋은 작업의 "저장 지점"입니다. 언제든 이 시점으로 돌아올 수 있습니다.
해결 방법:
```
/git-onboarding-workflow
```
를 실행하세요.

为什么需要： 提交是工作的「存档点」，可随时回退到该时间点的状态。
解决方法： 执行
```
/git-onboarding-workflow
```
。

단계 9: Push

步骤9：Push

왜 필요한지: 로컬 커밋을 GitHub에 올려야 다른 사람이 볼 수 있고, 백업도 됩니다.
해결 방법:
```
/git-onboarding-workflow
```
를 실행하세요.

为什么需要： 将本地提交上传到GitHub后其他人才可以查看，同时也起到备份作用。
解决方法： 执行
```
/git-onboarding-workflow
```
。

단계 10: Pull Request 생성

步骤10：Pull Request创建

왜 필요한지: PR은 "이 변경을 main에 합쳐주세요"라는 요청입니다. 코드 리뷰를 받을 수 있습니다.
해결 방법:
```
/git-onboarding-workflow
```
를 실행하세요.

为什么需要： PR是「请求将本次变更合并到main分支」的申请，可用于发起代码评审。
解决方法： 执行
```
/git-onboarding-workflow
```
。

전체 완료 시

全部完成时

10개 항목이 모두 완료되면:

Git 시작하기 — 전체 완료!

  [x] 1. Git 설치
  [x] 2. 사용자 이름 설정 (...)
  [x] 3. 이메일 설정 (...)
  [x] 4. GitHub CLI 설치
  [x] 5. GitHub 로그인
  [x] 6. 저장소 준비
  [x] 7. 브랜치 생성
  [x] 8. 첫 번째 커밋
  [x] 9. Push
  [x] 10. Pull Request 생성

축하합니다! Git 설정부터 PR 생성까지 모든 과정을 완료했습니다.
이제 GitHub Flow에 따라 자유롭게 개발하세요.

10个项目全部完成时输出：

Git入门 — 全部完成！

  [x] 1. Git安装
  [x] 2. 用户名配置 (...)
  [x] 3. 邮箱配置 (...)
  [x] 4. GitHub CLI安装
  [x] 5. GitHub登录
  [x] 6. 仓库准备
  [x] 7. 分支创建
  [x] 8. 首次提交
  [x] 9. Push
  [x] 10. Pull Request创建

恭喜您！已完成从Git配置到PR创建的全流程。
现在您可以按照GitHub Flow自由开展开发工作了。