Setup Anping Skills 프로젝트 시작하기
현재 저장소를 Codex와의 장기 협업에 적합한 프로젝트 환경으로 초기화합니다. 이 Skill은 프롬프트 기반으로 동작하며, 결정론적 설치 스크립트가 아닙니다. 먼저 탐색하고, 질문하고, 초안을 보여준 뒤, 최종적으로 작성합니다.
목표는 모든 Skill을 설치하는 것이 아니라 프로젝트 필요에 따라 조합하는 것입니다.
- Anping 자체 Skill (예:
multi-agent-orchestrator,transfer-codex-sessions). - 외부 우수 Skill (예: Matt Pocock의 engineering skills).
- 프로젝트 수준 규칙 및 지식 파일 (예:
AGENTS.md,CONTEXT.md,CONTEXT-MAP.md,docs/agents/,docs/adr/).
실행 원칙
- 시작하기 전에 실행 주체를 명시합니다. 장기 또는 다중 파일 초기화는 현재 프로젝트의 멀티 에이전트 오케스트레이션 규칙을 따라야 하며, 도구 정책에서 위임을 허용하지 않는 경우 단계적 폴백(fallback)을 사용함을 설명합니다.
- 한 번에 사용자에게 한 부분만 질문합니다. 모든 결정을 한꺼번에 사용자에게 던지지 마십시오.
- 각 추천 Skill의 용도, 출처, 현재 프로젝트에 적합한 이유를 설명합니다.
- 타사 Skill 소스 코드를 벤더링(vendor)하지 마십시오. 외부 Skill은 설치 출처나 참조 디렉토리를 통해서만 연결합니다.
- 파일을 쓰기 전에 수정할 파일, 주요 블록, 기본 선택 사항을 먼저 보여주고 사용자 확인을 받은 후에 작성합니다.
- 사용자가 이미 가지고 있는
AGENTS.md,README.md,CONTEXT.md또는docs/agents/*내용을 덮어쓰지 않으며, 기존 블록을 업데이트하고 중복 추가를 피합니다.
워크플로우
1. 사전 점검: 종속 Skill 확인
먼저 현재 세션과 ~/.codex/skills/에 필수 Skill이 이미 있는지 확인합니다. references/skill-catalog.md를 읽고 프로젝트 필요에 따라 필수, 권장, 선택을 판단합니다.
- Skill 선택 및 목표 명확화:
ask-matt,grill-with-docs. - 도메인 및 지식 정리:
domain-modeling. - 메인 스레드 오케스트레이션:
multi-agent-orchestrator. - 엔지니어링 프로젝트 설정:
setup-matt-pocock-skills.
누락된 항목을 자동으로 설치하지 마십시오. 먼저 사용자에게 누락된 Skill, 출처, 용도, 권장 수준을 설명하고, 사용자가 확인한 후에 skill-installer 또는 상위에서 권장하는 방식으로 설치합니다.
2. 프로젝트 탐색
현재 저장소 상태를 빠르게 읽고 사용자에게 간단한 요약만 제공하며, 지나친 결론을 내리지 않습니다.
git remote -v및.git/config: GitHub/GitLab/로컬 프로젝트 여부.- 루트 디렉토리의
AGENTS.md,CLAUDE.md: 에이전트 규칙 또는Agent skills관련 섹션 존재 여부. - 루트 디렉토리의
README.md: 프로젝트 목표가 명확히 작성되었는지 확인. - 루트 디렉토리의
CONTEXT.md,CONTEXT-MAP.md. docs/agents/,docs/adr/,src/*/docs/adr/..scratch/: 로컬 마크다운 이슈 컨벤션이 이미 있는지 확인.~/.codex/skills/또는 현재 세션에서 사용 가능한 Skill: 어떤 자체 제작 및 외부 Skill이 설치되어 있는지 확인.
3. 발견 사항 표시
짧은 목록으로 사용자에게 알립니다.
- 현재 프로젝트의 대략적인 유형.
- 이미 존재하는 AI 협업 파일.
- 누락되었지만 가치 있을 수 있는 파일.
- 설치됨/설치되지 않은 주요 Skill.
- 다음에 어떤 결정을 단계적으로 질문할 것인지.
4. 단계별 질문
각 섹션에서 먼저 1-3문장으로 용도와 영향을 설명하고, 기본 권장 사항을 제시한 후 사용자 응답을 기다렸다가 다음 섹션으로 넘어갑니다.
A. 프로젝트 목표
프로젝트 목표가 명확하지 않은 경우 우선 ask-matt를 사용하여 적절한 프로세스를 선택하고, 인터뷰를 통해 문서를 정리해야 하는 경우 grill-with-docs를 사용합니다. 목표가 합의되면 README.md의 프로젝트 설명에 작성하거나 업데이트할지 질문합니다.
B. 메인 스레드 오케스트레이션 패턴
multi-agent-orchestrator를 활성화할지 질문합니다. 이점은 컨텍스트 거버넌스, 독립적 검증, self-validation 감소이며, 비용은 짧은 작업에서 총 토큰이 증가할 수 있다는 점입니다. 사용자가 동의하면 프로젝트 수준 위임 권한을 작성할지 계속 질문합니다. 즉, 메인 스레드가 system/developer/tool 정책, 저장소 규칙, 승인 요구 사항을 준수하면서 자율적으로 subagent/role agent를 생성하거나 사용자에게 보이는 Codex thread를 사용할 수 있도록 허용하는 것입니다. 사용자가 확인하면 메인 스레드 오케스트레이션 규칙과 권한을 AGENTS.md에 작성하며, 이미 설치된 Skill의 템플릿을 우선 사용합니다.
C. 컨텍스트 레이아웃
사용자가 선택합니다.
Single-context: 루트 디렉토리에 하나의CONTEXT.md와docs/adr/. 대부분의 저장소에서 기본 선택.Multi-context: 루트 디렉토리의CONTEXT-MAP.md가 여러 컨텍스트 디렉토리를 가리킵니다. 모노레포 또는 다중 제품 저장소에 적합합니다.
구체적인 파일을 작성해야 하는 경우 references/project-files.md를 읽습니다.
D. 프로젝트 지식 베이스
인간과 AI 모두를 위한 프로젝트 지식 베이스를 생성할지 질문합니다. 기본 권장 사항:
docs/agents/anping-skills.md: 이 프로젝트에서 활성화된 Skill, 용도 및 호출 경계.docs/agents/project-knowledge.md: 프로젝트 지식 정리 규칙.docs/adr/README.md: ADR 사용 설명. 기본적으로 중국어로 ADR을 작성하지만, 사용자가 명시적으로 영어 또는 이중 언어를 원하는 경우 예외로 합니다.
E. 외부 Skill 연결
프로젝트 유형에 따라 외부 Skill을 추천합니다. 기본적으로 전부 설치하지 말고, 현재 프로젝트에서 사용할 조합만 추천합니다. 타사 Skill을 설치하기 전에 출처와 이유를 설명하고 확인을 요청합니다.
5. 초안 표시 및 확인
작성하기 전에 다음을 표시합니다.
- 수정하거나 생성할 파일 목록.
AGENTS.md에 추가/업데이트할 섹션 요약 (Delegation Authorization포함 여부).docs/agents/anping-skills.md에 기록할 Skill 목록.CONTEXT.md또는CONTEXT-MAP.md의 레이아웃.- 외부 Skill 설치 여부 또는 설치 권장 여부.
사용자 확인 후 파일 수정을 실행합니다.
6. 프로젝트 설정 작성
사용자 선택에 따라 다음을 작성합니다.
AGENTS.md또는 기존 에이전트 규칙 파일 내 Anping/Codex 협업 섹션.docs/agents/anping-skills.md.docs/agents/project-knowledge.md.CONTEXT.md또는CONTEXT-MAP.md.docs/adr/README.md..gitignore에 보안 무시 항목 (예:codex_sessions/), 프로젝트에서 세션 마이그레이션을 사용하는 경우.
프로젝트가 setup-matt-pocock-skills도 사용하는 경우, 동일한 의미의 Agent skills 블록을 중복 작성하지 말고, 기존 섹션을 업데이트하거나 병합합니다.
7. 검증
작성 후 가벼운 검증을 먼저 수행한 후 완료를 보고합니다.
- 수정된 주요 섹션을 다시 읽어 내용이 예상된 파일에 포함되었는지 확인합니다.
- 중복된 Anping / Agent skills / Multi-Agent Orchestrator 블록이 없는지 확인합니다.
- 생성되어야 하는 파일이 존재하는지 확인합니다 (예:
docs/agents/anping-skills.md,CONTEXT.md또는CONTEXT-MAP.md,docs/adr/README.md). - YAML, TOML, JSON 또는 기타 구문 분석 가능한 구성을 수정한 경우 로컬 파서를 사용하여 형식을 검증합니다.
- 어떤 선택이 실행되지 않은 경우 그 이유와 남은 위험을 기록합니다.
8. 마무리
마지막으로 보고합니다.
- 어떤 기능이 활성화되었는지.
- 어떤 파일이 수정되었는지.
- 어떤 Skill이 설치되었고, 어떤 Skill이 단순히 권장되는지.
- 이후 사용자가 한 문장으로 이러한 기능을 어떻게 트리거할 수 있는지.
- 남은 위험 (예: 외부 Skill 미설치, GitHub 자격 증명 사용 불가, 프로젝트 목표 불명확).
사용자가 명시적으로 요청하지 않는 한 자동으로 commit, push 또는 공개 업로드하지 마십시오.