.claude/skills/init-project/SKILL.md

@@ -49,6 +49,86 @@ curl -sf "${GITEA_URL}/gc/template-react-ts/raw/branch/develop/.editorconfig"
 
 ⚠️ 팀 규칙(.claude/rules/), 에이전트(.claude/agents/), 스킬 6종, 스크립트는 12단계(sync-team-workflow)에서 자동 다운로드된다. 여기서는 settings.json만 설정한다.
 
+### 3.5. Gitea 토큰 설정
+
+**CLAUDE_BOT_TOKEN** (팀 공용): `settings.json`의 `env` 필드에 이미 포함되어 있음 (3단계에서 설정됨). 별도 조치 불필요.
+
+**GITEA_TOKEN** (개인): `/push`, `/mr`, `/release` 등 Git 스킬에 필요한 개인 토큰.
+
+```bash
+# 현재 GITEA_TOKEN 설정 여부 확인
+if [ -z "$GITEA_TOKEN" ]; then
+  echo "GITEA_TOKEN 미설정"
+fi
+```
+
+**GITEA_TOKEN이 없는 경우**, 다음 안내를 **AskUserQuestion**으로 표시:
+
+**질문**: "GITEA_TOKEN이 설정되지 않았습니다. Gitea 개인 토큰을 생성하시겠습니까?"
+- 옵션 1: 토큰 생성 안내 보기 (추천)
+- 옵션 2: 이미 있음 (토큰 입력)
+- 옵션 3: 나중에 하기
+
+**토큰 생성 안내 선택 시**, 다음 내용을 표시:
+
+```
+📋 Gitea 토큰 생성 방법:
+
+1. 브라우저에서 접속:
+   https://gitea.gc-si.dev/user/settings/applications
+
+2. "Manage Access Tokens" 섹션에서 "Generate New Token" 클릭
+
+3. 입력:
+   - Token Name: "claude-code" (자유롭게 지정)
+   - Repository and Organization Access: ✅ All (public, private, and limited)
+
+4. Select permissions (아래 4개만 설정, 나머지는 No Access 유지):
+
+   ┌─────────────────┬──────────────────┬──────────────────────────────┐
+   │ 항목             │ 권한             │ 용도                          │
+   ├─────────────────┼──────────────────┼──────────────────────────────┤
+   │ issue           │ Read and Write   │ /fix-issue 이슈 조회/코멘트   │
+   │ organization    │ Read             │ gc 조직 리포 접근              │
+   │ repository      │ Read and Write   │ /push, /mr, /release API 호출 │
+   │ user            │ Read             │ API 사용자 인증 확인           │
+   └─────────────────┴──────────────────┴──────────────────────────────┘
+
+5. "Generate Token" 클릭 → ⚠️ 토큰이 한 번만 표시됩니다! 반드시 복사하세요.
+```
+
+표시 후 **AskUserQuestion**: "생성한 토큰을 입력하세요"
+- 옵션 1: 토큰 입력 (Other로 입력)
+- 옵션 2: 나중에 하기
+
+**토큰 입력 시**:
+
+1. Gitea API로 유효성 검증:
+```bash
+curl -sf "https://gitea.gc-si.dev/api/v1/user" \
+  -H "Authorization: token <입력된 토큰>"
+```
+- 성공: `✅ <login> (<full_name>) 인증 확인` 출력
+- 실패: `❌ 토큰이 유효하지 않습니다. 다시 확인해주세요.` 출력 → 재입력 요청
+
+2. `.claude/settings.local.json`에 저장 (이 파일은 .gitignore에 포함, 리포 커밋 안됨):
+```json
+{
+  "env": {
+    "GITEA_TOKEN": "<입력된 토큰>"
+  }
+}
+```
+
+기존 `settings.local.json`이 있으면 `env.GITEA_TOKEN`만 추가/갱신.
+
+**나중에 하기 선택 시**: 경고 표시 후 다음 단계로 진행:
+```
+⚠️ GITEA_TOKEN 없이는 /push, /mr, /release 스킬을 사용할 수 없습니다.
+   나중에 토큰을 생성하면 .claude/settings.local.json에 다음을 추가하세요:
+   { "env": { "GITEA_TOKEN": "your-token-here" } }
+```
+
 ### 4. Hook 스크립트 설정
 
 ⚠️ `.claude/scripts/` 스크립트 파일은 12단계(sync-team-workflow)에서 서버로부터 자동 다운로드된다.