Menu
Mino-Android SDD spec.md 생성. Figma 화면 + 기획서로부터 "무엇을 만들까"(화면 동작 정의) 기준 문서 spec.md와 화면 PNG(assets/)를 만들고, spec-reviewer 서브에이전트로 Figma·기획서 대조 자가검수까지 수행한다. Figma URL과 기획서가 주어졌을 때 사용.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | spec-gen |
| description | Mino-Android SDD spec.md 생성. Figma 화면 + 기획서로부터 "무엇을 만들까"(화면 동작 정의) 기준 문서 spec.md와 화면 PNG(assets/)를 만들고, spec-reviewer 서브에이전트로 Figma·기획서 대조 자가검수까지 수행한다. Figma URL과 기획서가 주어졌을 때 사용. |
Mino-Android 프로젝트의 SDD(Spec Driven Development) spec.md를 생성하는 스킬이다.
spec.md는 "무엇을 만들까"(화면 동작 정의)를 기술하는 기준 문서이며, 유일한 원천은 Figma다.
입력(Figma + 기획서)을 토대로 출력 규약(spec-format.md)을 정확히 그대로 따라 작성한 뒤, 반드시 자가검수 단계까지 수행한다.
입력이 비어 있으면 사용자에게 Figma URL과 기획서를 요청한다.
산출물 위치: 모든 산출물은
docs/specs/{슬러그}/아래에 둔다. 이하 이 디렉터리를{작업 디렉터리}라 부른다. 대시보드는 spec.md 첫 줄<!-- feature: {슬러그} -->주석으로 PR 커밋 경로를 만들므로, 디렉터리 이름은 그 슬러그와 같아야 하고 번호 접두어를 붙이지 않는다.실행 구조: 메인이 Phase 1(공통 선행) 을 직렬로 끝낸 뒤, Phase 2 에서 spec 작성과 에셋 추출을 서브에이전트 2개로 병렬 실행한다(
Agent툴 동시 호출). 두 갈래의 유일한 공통 의존은 Figma 읽기 + 파일명 규칙 이며, 이를 Phase 1의 노드→파일명 매핑표(계약) 로 고정해 두 갈래가 서로 대기하지 않게 한다.
{작업 디렉터리} = docs/specs/{슬러그}/ (예: docs/specs/mypage/). 이 디렉터리와 그 하위 assets/를 만든다.{화면식별자}.png(예: 노드 ID 기반 2001-0001.png), 공백·한글 금지·영문 소문자/숫자/하이픈만. 이 표가 Phase 2 두 갈래의 단일 계약이다.메인이 Agent 툴 2개를 한 메시지에서 동시 호출한다(subagent_type으로 아래 커스텀 에이전트 지정). 둘 다 Phase 1의 매핑표를 입력으로 받으며, 서로의 산출물을 기다리지 않는다.
spec-generator — {작업 디렉터리} · 매핑표 · 사실 요약본 · 슬러그 · 원본 Figma URL을 주입한다. 에이전트는 출력 규약(spec-format.md)대로 {작업 디렉터리}/spec.md를 작성하고, 이미지 링크는 매핑표 파일명으로 경로만 박는다(PNG 실물 불필요).figma-asset-exporter — {작업 디렉터리} · 매핑표 · Figma fileKey/URL을 주입한다. 에이전트는 각 노드를 PNG export해 {작업 디렉터리}/assets/{파일명}에 저장하고, 접근 권한이 없으면 수동 export 안내로 폴백한다.두 에이전트의 역할·입출력 상세는 각 정의(
spec-generator·figma-asset-exporter) 참조.
두 에이전트가 모두 끝나면, spec.md가 참조하는 파일명 집합과 {작업 디렉터리}/assets/의 실제 파일 집합이 일치하는지(깨진 링크 0) 검증한다. 누락이 있으면 해당 노드만 figma-asset-exporter를 재시도하거나 수동 export 항목으로 표기한다(spec 본문은 경로가 이미 박혀 있어 영향 없음).
spec-reviewer 서브에이전트를 호출해 {작업 디렉터리}/spec.md를 입력 Figma URL·기획서와 대조 검수한다.
{작업 디렉터리}/spec.md 경로 ② 원본 Figma URL ③ 기획서.검수 통과 요약을 사용자에게 보고한다. 산출물 구성은 ## 산출물 핸드오프 참조.
결정성 옵션: 기본은 위
Agent팬아웃이다. 더 엄격한 결정적 실행이 필요하면 Phase 2를Workflow의parallel([A, B])배리어로 대체할 수 있다(사용자 opt-in 필요).
spec.md의 출력 템플릿·통제 어휘·작성 규칙은 spec-format.md를 단일 출처로 한다. spec-generator(작성)·spec-reviewer(검수)도 이 문서를 따른다. 규칙을 여기서 다시 풀어쓰지 않는다.
{작업 디렉터리}/spec.md + {작업 디렉터리}/assets/*.png다 (예: docs/specs/mypage/). 사용자는 이를 spec-center 대시보드에 drag-drop 업로드한다 (대시보드의 붙여넣기 구조 검증 → 디자이너 컨펌 게이트로 이어짐). 스킬은 대시보드/Firestore에 직접 쓰지 않는다.Mino-Android SDD plan.md 생성. 컨펌된 spec.md를 안드로이드 MVI 설계(plan.md)로 번역한다. Mino-Android 레포 체크아웃 안에서 docs·모듈 구조를 직접 읽어 작성하고, plan-reviewer 서브에이전트로 자가검수까지 수행한다. 컨펌된 spec 본문이 주어졌을 때 사용.
대화 중 되돌리기 어려운 설계·아키텍처 결정이 확정되는 순간 자동으로 docs/adr/에 ADR을 기록한다. 라이브러리·프레임워크 채택/교체, 모듈 경계·레이어 구조 변경, 의도적으로 하지 않기로 한 것 등 "이걸로 하자"라고 결론이 나는 대화에서 사용. 사용자가 ADR을 써달라고 명시적으로 요청하지 않아도, 결정이 확정되는 시점에 먼저 제안한다.
머지된 코드가 이후에 잘못된 설계·구현으로 판명되어 되돌리거나 다시 고칠 때 자동으로 docs/failures/에 실패 기록을 남긴다. 버그 수정·롤백 대화에서, 지금 고치는 코드가 과거의 의도적인 결정(특히 기존 ADR)을 뒤집는 것인지 git 히스토리로 확인하고 사용. 결정과 실패 판명이 서로 다른 세션에서 벌어지는 경우가 대부분이므로, 대화 기억이 아니라 git 로그·docs/adr를 근거로 판단한다.