Mimi Seed

---
name: mimi-seed
description: mimi-seed MCP(@yoonion/mimi-seed-mcp)로 Google Play·App Store Connect·Firebase·AdMob 출시 운영을 Claude Code/Codex에서 바로 실행하는 범용 진입 스킬. deferred-tool 로딩(ToolSearch select)과 비가역 작업 안전수칙을 포함한다. Use when a user asks to do app-store / Firebase / AdMob / CI ops via the mimi-seed MCP and you need the correct tool-loading order, workflows, and safety rules.
---

# mimi-seed

mimi-seed MCP 서버의 150+ 도구로 앱 출시 운영과 영상 제작(상태 점검 · 출시 준비도 · 릴리스 노트 · 스토어 적용 · Firebase/AdMob 설정 · story 기반 영상 리서치/렌더)을 대화형으로 수행하는 범용 스킬. 도메인별 세부 작업은 `appstore-publish` · `playstore-publish` · `deploy` 스킬로 분기하고, 호출 규약은 [`docs/agent-guide.md`](../../docs/agent-guide.md), 구조·아키텍처·함정은 도메인 온톨로지 [`docs/domain/_index.md`](../../docs/domain/_index.md)를 참조한다.

## 사전 조건

1. MCP 클라이언트(Claude Code / Codex / Claude Desktop)에 `mimi-seed`가 등록되어 있어야 한다.
2. 작업 대상 서비스 인증이 되어 있어야 한다 (`~/.mimi-seed/` 하위). `mimi_seed_status` 로 먼저 확인한다.
   미인증이면 사용자에게 **터미널에서** 이걸 실행하라고 안내한다 (모든 자격증명을 순서대로 연결하고,
   각 토큰을 어디서 발급받는지도 알려준다):
   ```bash
   npx mimi-seed setup
   ```
   개별 인증이 필요하면 `mimi-seed auth login | appstore | playstore | bigquery | jenkins | ci | googleads | facebook | instagram | threads`.
   각 토큰의 발급 절차는 [`docs/credentials.md`](../../docs/credentials.md).
   ⚠️ 이 명령들은 **대화형**이라 네가 대신 실행하면 안 된다 — 사용자가 직접 터미널에서 돌려야 한다.

## 도구 로딩 (가장 중요)

Claude Code 등은 mimi-seed 도구를 **deferred**로 노출한다 — 이름은 보이지만 schema 미로드 상태라 **직접 호출하면 `InputValidationError`** 가 난다. **반드시 호출 전에 schema를 로드**한다:

```
ToolSearch(query="select:<tool>[,<tool>...]")
```

- 한 작업에 필요한 도구를 한 번에 batch select (세션 동안 유지됨).
- `select:`가 비면 키워드 검색으로 폴백. 그래도 없으면 그때만 미등록으로 판단하고, curl/fastlane로 우회하지 말 것.
- 자주 쓰는 select 배치는 `docs/agent-guide.md` §0 표 참조.

## 실행 흐름

1. **`mimi_seed_status` 먼저 호출** — 서비스 연결을 ✅/❌로 스캔하고 미설정·만료 항목별 다음 명령을 알려준다. 인증 누락이면 위 auth 명령으로 안내.
2. 작업 의도를 파악해 분기:
   - 처음 설정 / "뭘 할 수 있어?" 탐색 → `mimi-seed-onboarding` 스킬
   - Play 스토어 출시/승격/리스팅 → `playstore-publish` 스킬
   - App Store 메타데이터/스크린샷/TestFlight → `appstore-publish` 스킬
   - CI 빌드→점검→노트→적용 풀 파이프라인 → `deploy` 스킬
   - story 기반 영상/쇼츠 제작·YouTube 게시 → `video-create-publish` 스킬
   - Firebase/AdMob/IAM/BigQuery → 해당 도메인 도구 직접
3. 스토어 **쓰기 전** `*_check_submission_risks` 또는 `*_plan_release`로 블로커를 먼저 점검하고 사용자에게 체크리스트로 보고.
4. 적용 후 결과·실패 지점을 요약.

## 로컬 자격증명을 원격 MCP에 연결

원격 Mimi Seed에서 로컬과 같은 Store 연결이 필요하면 먼저
`mimi_seed_remote_sync_credentials`를 `confirm=false`로 호출해 대상을 확인한다. 사용자에게
Apple P8 키와 Play 서비스 계정 JSON이 원격 워크스페이스에 암호화 저장된다는 점을 알리고,
명시 동의를 받은 뒤에만 `confirm=true`로 다시 호출한다. 특정 앱만 필요하면
`package_names`를 지정한다 — `playstore_list_service_accounts`에 **등록된** 패키지명(레거시 단일 SA 가 있으면
형식이 맞는 패키지명)만 보내고, 나머지는 **건너뛴 목록**으로 보여준다. 미리보기에 표시되는 **전송 대상 호스트**와
건너뛸 이름을 사용자에게 함께 보여준다 (https만 허용, http는 localhost 개발 서버만).

- 동기화 대상: `appstore.json`, `play-service-accounts/<packageName>.json`
- 동기화 제외: `tokens.json`. 로컬 Google OAuth refresh token은 로컬 OAuth client에 묶여 있으므로
  복사하지 않는다. Firebase·AdMob·Android vitals는 결과에 표시된 원격 웹에서 Google 플랫폼 권한을
  한 번 동의해야 한다.
- 도구 응답에는 private key, 서비스 계정 JSON, PAT가 포함되지 않아야 한다. 실패 시에도 비밀값을
  재출력하지 않는다.

## 안전 규칙

- 비가역 작업(`playstore_submit_release`/`promote_release` `status=completed`, `appstore_submit_for_review`, 스크린샷 셋 삭제, 상품/크리덴셜 삭제)은 **같은 턴에서 명시 승인** 없이는 실행하지 않는다.
- 카탈로그 **D** 도구(위 작업 + 공개 게시·리뷰 답글·IAM 키/바인딩·Jenkins 잡 덮어쓰기 등)는 서버가 확인을 강제한다:
  먼저 `confirm` 없이 호출 → 돌아온 dry-run preview 를 사용자에게 보여 승인 → 같은 인자 + `confirm: true` 로 재호출.
  첫 호출에 `confirm: true` 를 넣지 않는다.
- `mimi_seed_remote_sync_credentials(confirm=true)`는 비밀값을 외부에 저장하는 작업이므로 같은 턴의 명시 승인 없이는 실행하지 않는다.
- 반복 작업 중에는 `status=draft`를 쓰고, `completed` 전환은 명시 요청 시에만.
- 파일은 절대경로로 전달하고, 이미지 바이트를 대화 컨텍스트에 싣지 않는다.
- 비밀값은 대화로 옮기지 않는다. `iam_create_key`·`android_generate_keystore`는 키·비밀번호를
  `~/.mimi-seed/keys/`·`~/.mimi-seed/keystores/`에 0600 파일로 저장하고 **경로만** 돌려준다. 그 경로를
  `serviceAccountJsonPath` / `service_account_json_path` / `keystore_path` / `secret_file`로 넘기고, 파일을 읽어 값을 복사하지 않는다.
- mimi-seed는 **앱 바이너리를 빌드하지 않는다** (메타데이터·릴리스·credential 관리 전용). `.ipa`/`.aab`는 EAS·Xcode·CI/Jenkins 잡으로 만든다.