team-startlisted
Install: claude install-skill SWHee/skills
# Team Start
Codex 앱에서 `$team-start`로 호출한다. GitHub에 익숙하지 않은 팀장의 설명을 받아 새 협업 공간을 준비한다. 팀원에게는 이 스킬이 필요 없다. 계획, 생성·이어가기, 점검을 자연어로 구분한다.
## 대화
1. 목적·기간·팀 규모·이미 결정한 내용을 추출한다. 필요한 선택만 짧게 설명하고 추천한다. 기존 답변과 생성·초대 허락을 반복해서 묻지 않는다.
2. `gh` 로그인과 사용할 소유자·권한을 읽기로 확인한다. 적합한 기존 조직을 제안하되 강제하지 않는다. 개인 소유와 조직의 차이, 새 조직 생성, 권한 제약이 필요할 때만 [github.md](references/github.md)를 읽는다.
3. **소유자, 저장소명, 공개 여부, 새 프로젝트의 절대 경로, 초대할 GitHub 로그인**, 보드·AI 안내 사용 여부를 정한다. 현재 작업 폴더를 새 프로젝트로 간주하거나 업로드하지 않는다. 임시 폴더 대신 사용자의 지속적인 프로젝트 보관 위치를 사용한다.
4. 무료·비공개를 우선 추천한다. 해커톤은 PR 기록과 승인 0명, 지속 협업은 다른 팀원 승인 1명을 추천한다. 중요 미정 사항은 답을 받은 뒤 적용한다. 담당자·커밋 문체·스타일·라이선스를 임의로 정하지 않는다.
5. 생성 자원, 저장소·보드의 팀원별 쓰기 권한, 문서 초안, 강제 가능한 규칙과 보류 항목을 보여준다. 실제 저장소 API로 기능 지원을 확인하며 요금제 정보가 없다는 이유로 추가 인증을 요구하지 않는다.
새 저장소 하나와 2~10명 팀에 집중한다. 앱 개발·배포·결제·조직 전체 정책 변경·기존 저장소 전환은 범위 밖이다. 새 조직은 공식 웹 화면에서 사용자가 생성한 뒤 이어간다. 미지정 상대 초대나 공개 전환을 추정해서 실행하지 않는다.
## 실행
[interface.md](references/interface.md)에서 입력·출력을 확인한다. macOS Codex 앱에서 검증했으며 도우미는 Python 3.9+, git, 인증된 gh와 POSIX 파일 잠금을 사용한다. 인증 토큰을 대화·파일·명령 인자에 복사하지 않는다.
- **계획:** spec을 별도 산출물로 작성하고 `plan --spec …`으로 문서 초안을 확인한다. `--offline`은 계정 확인 없는 미리보기다.
- **생성·이어가기:** 허용된 설정으로 `apply --spec …` 또는 `apply --path …`를 실행한다.
- **점검:** `check --path …`로 읽기만 수행한다. 점검 요청을 복구 허락으로 해석하지 않는다.
실패 원인을 해결한 뒤 같은 프로젝트에서 재개한다. `.team-start`의 기록을 삭제·수정해 충돌 방지를 우회하지 않는다. 사용자 변경은 보류로 보고하며 차이를 설명한다. 이 도구 밖의 수동 수정은 별도 요청 범위에서 처리한다.
설정 PR을 생성하거나 요청에 따라 이어서 작업했다면 반환된 `setup_pr.url`을 Codex의 PR 첨부 도구로 현재 작업에 첨부한다. 자동 병합하지 않는다.
#