Menu
guide/ko·en 사용자 가이드를 AUTHORING.md 규칙대로 작성·갱신·동기화. 빌드·커밋 안 함.
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 | source-command-guide |
| description | guide/ko·en 사용자 가이드를 AUTHORING.md 규칙대로 작성·갱신·동기화. 빌드·커밋 안 함. |
Use this skill when the user asks to run the migrated source command guide.
guide/ko·guide/en 사용 가이드를 작성·갱신하는 전용 스킬. 코드(src/)는 건드리지 않고 guide/만 다룬다. 작성 규칙·IA·톤·사실 대조 소스는 전부 guide/AUTHORING.md가 단일 출처 — 이 스킬은 그 매뉴얼을 로드해 실행하는 손이다.
핵심 분리: /push는 가이드 stale을 감지·경고하는 가벼운 게이트, /guide는 실제 작성·갱신을 자기완결한다. 사용자 노출 기능을 바꾼 /implement 보고의 "가이드 영향 ⚠️" 플래그가 이 스킬의 진입 신호다.
/guide — 직전 컨텍스트(방금 구현한 기능, /implement의 "가이드 영향" 플래그)에서 갱신 대상 추론./guide <slug 또는 설명> — 대상 명시. 예: /guide ai-styling, /guide 30초 리플레이 권한 안내./guide sync — 전체 대조. 코드 현재 상태와 guide/ 23페이지를 전수 비교해 stale 페이지를 모두 찾아 갱신./guide new <섹션> — 새 페이지·섹션 추가(IA 변경) — SUMMARY·트리·footer까지./implement — 코드 구현. 가이드는 "영향 플래그"만 남기고 작성 안 함./guide ← 여기. guide/ko·en 작성·갱신 + 검증. 빌드·커밋 안 함./push — 가이드 stale 감지 + 신선도 게이트. 규모 작으면 직접, 크면 /guide 권장.가장 먼저 guide/AUTHORING.md를 읽는다. 운영 방식·IA·이슈 작성 공통 흐름·사실 대조 소스·톤앤매너·UI 라벨 규칙·마크다운/footer 규칙·ko/en 대칭·검증 체크리스트가 전부 거기 있다. 이 단계를 건너뛰고 작성하지 않는다.
/implement 직후면 그 보고의 "가이드 영향" 대상 페이지를 채택.sync면 23페이지 전체가 대상.AUTHORING.md "사실 대조 소스" 표의 경로를 읽어 현재 코드의 사실을 확정한다 — 단축키·본문 섹션 기본값·라벨(i18n ko/en)·스타일 섹션 순서·로그 정책·마커·플랫폼 표 등. 추측 금지 — 가이드 문구가 코드와 어긋나면 안 된다. 변경된 기능이면 그 기능의 i18n 키·동작을 직접 확인한다.
assets/, 하위 ../assets/) + 의미 있는 캡션.{% hint %}) 미사용 — 주의는 plain 인용구(>).SUMMARY.md와 트리를 양쪽 대칭으로 갱신.이번 변경이 가이드 작성 기준 자체를 바꿨으면(새 플랫폼 → 플랫폼 표, 단축키/로그 정책/본문 섹션 변경 → 사실 스냅샷, 새 페이지 → IA 트리) guide/AUTHORING.md의 해당 표·스냅샷도 함께 갱신한다.
AUTHORING.md "검증 체크리스트"의 정적 점검을 실행한다(cd guide):
.md 링크 무결 / 더미 이미지 경로 깊이 유효 / footer 페이지당 1개.순수 문서라 pnpm test·pnpm build는 돌리지 않는다.
대상: <페이지 N개 / sync / slug>
갱신 파일: <guide/ko/…, guide/en/… 목록>
사실 대조: <확인한 코드 소스 — 라벨/단축키/정책 일치 여부>
AUTHORING.md 동기: <갱신함(표/스냅샷) / 변경 없음>
검증: 플레이스홀더 0 · ko/en 트리·헤딩 대칭 · 링크·이미지·footer OK
/push·/merge가 docs(guide): ...로).guide/만. src/·manifest·i18n은 건드리지 않는다(읽기만).코드베이스 전체를 컨벤션·패턴 기준으로 감사. 리포트 전용 — fix·빌드·커밋 안 함.
pnpm build 실행 후 결과 요약
변경된 코드를 시급도별로 보고. 리포트 전용 — fix·빌드·커밋 안 함.
웹스토어 배포 (main 가드 → tag push → 스토어 빌드 → zip → GitHub Release draft → 심사 요청 안내)
저장소 문서(Codex/DIRECTORY/ARCHITECTURE/DESIGN/README/PERMISSION/privacy/AUTHORING)를 문서별 전담 에이전트가 병렬로 코드베이스와 양방향 대조(사실오류 + 누락 커버리지)해 stale 탐지 → 통합 리포트 → 항목별 확인 → 수정. guide/ko·en 본문은 제외(/guide 전담). 빌드 안 함.
e2e 전체 스위트 실행 + 리포트 전용. fix·spec 수정 금지. green & 클린 트리면 e2e/.last-green에 커밋 해시 기록.