一键在 Manus 中运行任何 Skill

omd-sync

星标324

分支27

更新时间2026年5月7日 07:48

DESIGN.md 변경분을 CLAUDE.md / AGENTS.md / .cursor/rules/omd-design.mdc shim 3종에 전파. 'shim 갱신', 'drift 확인', 'ship', 'publish', 「shimを更新」, 「同步 CLAUDE.md」류의 요청에 트리거. DESIGN.md가 수정됐는데 shim이 오래됐을 때 자동 감지해 제안하기도 함.

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

kwakseongjae

kwakseongjae/oh-my-design

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

omd:sync — Shim Maintenance

DESIGN.md가 모든 주요 AI 코딩 에이전트(Claude Code, Codex, OpenCode, Cursor)에게 보이도록 shim 파일 3종을 관리한다. CLI 호출 없음 — Read/Write/Edit 툴로 직접 처리.

관리 대상 (3 파일)

ID	경로	모드
`claude`	`CLAUDE.md`	block (managed marker만)
`agents`	`AGENTS.md`	block (managed marker만)
`cursor`	`.cursor/rules/omd-design.mdc`	whole (전체 파일이 omd 전용)

block 모드는  ~  마커 안만 관리, 나머지 사용자 콘텐츠 보존. whole 모드는 frontmatter 포함 전체 파일이 관리 단위.

템플릿 (정확히 이 본문 — 절대 paraphrase 금지)

CLAUDE.md body

# Design System (oh-my-design)

The authoritative brand & UI spec is **@./DESIGN.md**.
Read before any UI/styling/microcopy/motion work.

Preference log (pending corrections): @./.omd/preferences.md

Precedence: DESIGN.md > preferences.md > your defaults.

AGENTS.md body

## Design System (oh-my-design)

**Before any UI, styling, copy, or motion change, open and read `./DESIGN.md` in full.** It is the authoritative brand/design spec. Treat its tokens, voice, and component rules as binding unless the user overrides in chat.

If present, read `./.omd/preferences.md` — pending corrections not yet folded into DESIGN.md. Apply them; flag conflicts.

.cursor/rules/omd-design.mdc (whole, frontmatter 포함)

---
description: Authoritative brand & UI design system. Read DESIGN.md before UI work.
globs:
  - "**/*.tsx"
  - "**/*.jsx"
  - "**/*.vue"
  - "**/*.svelte"
  - "**/*.css"
  - "**/*.scss"
  - "**/tailwind.config.*"
  - "**/components/**"
  - "**/app/**/page.*"
alwaysApply: false
---

<!-- omd:start v=1 hash=<HASH> -->
The authoritative design spec lives at `@DESIGN.md` (repo root). Open and read before generating/modifying UI.

Pending preference corrections: `@.omd/preferences.md`.

Precedence: DESIGN.md > preferences.md > framework defaults.
<!-- omd:end -->

해시 계산

<HASH> = sha256 of the body content (마커 제외, body 텍스트만), 12자 hex prefix:

node -e "console.log(require('crypto').createHash('sha256').update(process.argv[1]).digest('hex').slice(0,12))" "<body 텍스트>"

block 모드 마커 형식 정확히:

<!-- omd:start v=1 hash=ab12cd34ef56 -->
<body>
<!-- omd:end -->

실행 절차

사용자가 어떤 모드를 요청하는지 분기:

인터랙티브 (디폴트) — drift 발견 시 사용자에게 묻기
--force 의도 ("강제 덮어쓰기") — drift 무시하고 덮어씀
--check 의도 ("상태만 검사") — 파일 상태만 출력, write 안 함

각 shim별로:

Step 1 — Read existing

파일 없으면 → status: missing, 새로 write 진행 파일 있으면 → 내용 파싱

Step 2 — block 모드 파싱

 라인 찾기:

없으면 → status: missing (block 부재, 사용자 content 외에 새로 추가 필요)
있으면 → marker 사이의 본문 추출. 추출된 본문의 sha256:12를 계산해서 marker의 hash=H와 비교
- 불일치 → status: drifted (사용자가 수동 편집함)
- 일치 + 본문 == 템플릿 → status: clean
- 일치 + 본문 != 템플릿 → status: out-of-date (omd 템플릿이 갱신됨)

Step 3 — whole 모드 파싱

existing 전체 content와 rendered 템플릿 비교:

동일 → clean
차이 → drifted

Step 4 — drift 처리

인터랙티브: drift된 shim별로 "${path}는 수동 편집됐어요. 덮어쓸까요? (yes/no/show diff)" 묻기
--force: drift 무시 덮어씀
--check: drift 있으면 exit 1 동등 — 사용자에게 "drift detected" 보고 후 종료

Step 5 — Write

block 모드: existing 안의 marker block만 새 hash + 새 body로 교체. 마커 외부 사용자 content는 보존
whole 모드: 파일 전체를 새 rendered content로 교체. 디렉토리 (.cursor/rules/) 없으면 mkdir

Step 6 — sync-lock 갱신

.omd/sync.lock.json 기록 (없으면 만든다):

{
  "design_md_hash": "<DESIGN.md sha256:12>",
  "targets": {
    "CLAUDE.md": "<hash>",
    "AGENTS.md": "<hash>",
    ".cursor/rules/omd-design.mdc": "<hash>"
  },
  "updated_at": "<ISO timestamp>"
}

DESIGN.md 해시:

[ -f DESIGN.md ] && node -e "console.log(require('crypto').createHash('sha256').update(require('fs').readFileSync('DESIGN.md')).digest('hex').slice(0,12))"

결과 보고

CLAUDE.md (block) — updated
AGENTS.md (block) — unchanged
.cursor/rules/omd-design.mdc — created
DESIGN.md hash: ab12cd34ef56

언제 실행하나

DESIGN.md 변경 직후 (shim hash 갱신용)
새 프로젝트 첫 도입 (3종 생성)
.claude / .cursor 디렉토리 추가 후
"drift 확인" 요청

금지

마커 안 본문에 임의 추가/축약 금지 — 위 템플릿 정확히 사용
block 모드 파일에서 마커 외부 사용자 content 절대 삭제 금지
.omd/sync.lock.json 무시 금지 — 항상 갱신
DESIGN.md가 없어도 shim은 만들 수 있음 (DESIGN.md 생성 후에 hash만 채움)

同仓库更多 Skills

同仓库

omd-feel

kwakseongjae/oh-my-design

디자인·프론트 업계가 '감'으로 쓰던 인터페이스 디테일을 수치화한 규칙으로 적용(APPLY)하거나 감사(AUDIT)한다. Jakub Krehel의 make-interfaces-feel-better 철학을 계승 + HIG/Material/WCAG/DS 토큰/실무자 리서치로 확장한 17축·113규칙(provenance 등급별). 모션 타이밍·이징·동심원 radius·tabular-nums·44px 타깃·focus ring·prefers-reduced-motion 등. 'feel 좋게 다듬어줘', '인터페이스 디테일 적용', 'feel 점검', '마이크로 인터랙션 손봐줘', 'make this feel better', 'polish the interactions', 「インターフェースの細部を詰めて」, 「介面細節打磨」 류에 트리거. 브랜드 토큰은 DESIGN.md(omd:apply)가 우선.

2026-06-23324

omd-harness

kwakseongjae/oh-my-design

화면 전체나 신규 surface를 처음부터 디자인할 때의 진입점 — Discovery→Wireframe→Components→Microcopy→Validation 파이프라인을 omd-master 오케스트레이터로 실행. 트리거: '랜딩페이지', '랜딩 페이지', '랜딩 만들어줘', '홈 화면', '첫 화면', '프로토타입', '그럴싸한', '구색 갖춰', 'first screen', 'first impression', 'landing page', 'landing', 'prototype', 'MVP UI', 'home', 'production-ready', 'wireframe to production', '랜딩 처음부터', 'production-ready', '一からデザイン', '從頭設計'. 자연어 발화('그럴싸한 랜딩 만들어줘', 'MVP UI 잡아줘', '프로토타입이라도 구색 갖춰서')에도 자동 트리거. 단일 컴포넌트 수정은 omd:apply.

2026-06-22324

omd-init

kwakseongjae/oh-my-design

프로젝트 루트에 DESIGN.md를 부트스트랩 — 실제 기업 레퍼런스 중 컨텍스트 매칭으로 추천하고 선택된 레퍼런스의 톤&매너를 보존한 variation을 생성. DESIGN.md 부재 상태에서의 UI 작업 또는 '디자인 시스템 세팅', 'set up our design system', 「デザインシステムを作って」, 「建立設計系統」류의 요청에 트리거. CLAUDE.md / AGENTS.md / Cursor rule shim도 함께 설치.

2026-06-22324

omd-reference-capture

kwakseongjae/oh-my-design

선택된 reference brand의 라이브 사이트에서 디자인 컨텍스트(토큰·구조·visual reference)를 캡쳐. brand homepage 패칭, 컴퓨티드 스타일 inspect, 로고/스크린샷을 assets/_reference/<id>/ 로 가져와 attribution.md + LICENSE-NOTE.md와 함께 저장. '뱅크샐러드 에셋 가져와줘', 'X 사이트 패칭', 'X reference 캡쳐', 'X 라이브 스타일 추출', '브랜드 자료 받아와' 류 요청에 트리거. omd:init 직후 또는 omd:harness 중간에 호출 가능. DESIGN.md는 이 스킬이 만들지 않음 (omd:init 책임).

2026-06-22324

omd-add-reference

kwakseongjae/oh-my-design

URL 또는 brand id 입력 → 3-tier 검증 파이프라인(Tier 1 라이브 + Tier 2 getdesign/refero + Tier 3 reconcile)으로 references/<id>/DESIGN.md를 신규 생성(CREATE)하거나 기존 섹션을 검증·갱신(UPDATE). '레퍼런스 추가/수정', 'X DS 검증', 'X 컴포넌트 다시 뽑아줘' 류에 트리거.

2026-06-10324

omd-batch-launch

kwakseongjae/oh-my-design

10개 brand 일괄 reference 추가 + 문서 카운트 sync + hyperframes 기반 promo MP4 생성. '10개씩 추천해줘', '한국 IT 10개 추가하고 영상까지', 'batch-launch', 'X 카테고리에서 10개 더' 류 트리거. 매 회 reference count +10, gitignored promo video 1편.

2026-06-10324

name	omd:sync
description	DESIGN.md 변경분을 CLAUDE.md / AGENTS.md / .cursor/rules/omd-design.mdc shim 3종에 전파. 'shim 갱신', 'drift 확인', 'ship', 'publish', 「shimを更新」, 「同步 CLAUDE.md」류의 요청에 트리거. DESIGN.md가 수정됐는데 shim이 오래됐을 때 자동 감지해 제안하기도 함.

omd:sync — Shim Maintenance

관리 대상 (3 파일)

ID	경로	모드
`claude`	`CLAUDE.md`	block (managed marker만)
`agents`	`AGENTS.md`	block (managed marker만)
`cursor`	`.cursor/rules/omd-design.mdc`	whole (전체 파일이 omd 전용)

템플릿 (정확히 이 본문 — 절대 paraphrase 금지)

CLAUDE.md body

# Design System (oh-my-design)

The authoritative brand & UI spec is **@./DESIGN.md**.
Read before any UI/styling/microcopy/motion work.

Preference log (pending corrections): @./.omd/preferences.md

Precedence: DESIGN.md > preferences.md > your defaults.

AGENTS.md body

## Design System (oh-my-design)

**Before any UI, styling, copy, or motion change, open and read `./DESIGN.md` in full.** It is the authoritative brand/design spec. Treat its tokens, voice, and component rules as binding unless the user overrides in chat.

If present, read `./.omd/preferences.md` — pending corrections not yet folded into DESIGN.md. Apply them; flag conflicts.

.cursor/rules/omd-design.mdc (whole, frontmatter 포함)

---
description: Authoritative brand & UI design system. Read DESIGN.md before UI work.
globs:
  - "**/*.tsx"
  - "**/*.jsx"
  - "**/*.vue"
  - "**/*.svelte"
  - "**/*.css"
  - "**/*.scss"
  - "**/tailwind.config.*"
  - "**/components/**"
  - "**/app/**/page.*"
alwaysApply: false
---

<!-- omd:start v=1 hash=<HASH> -->
The authoritative design spec lives at `@DESIGN.md` (repo root). Open and read before generating/modifying UI.

Pending preference corrections: `@.omd/preferences.md`.

Precedence: DESIGN.md > preferences.md > framework defaults.
<!-- omd:end -->

해시 계산

<HASH> = sha256 of the body content (마커 제외, body 텍스트만), 12자 hex prefix:

node -e "console.log(require('crypto').createHash('sha256').update(process.argv[1]).digest('hex').slice(0,12))" "<body 텍스트>"

block 모드 마커 형식 정확히:

<!-- omd:start v=1 hash=ab12cd34ef56 -->
<body>
<!-- omd:end -->

실행 절차

사용자가 어떤 모드를 요청하는지 분기:

인터랙티브 (디폴트) — drift 발견 시 사용자에게 묻기
--force 의도 ("강제 덮어쓰기") — drift 무시하고 덮어씀
--check 의도 ("상태만 검사") — 파일 상태만 출력, write 안 함

각 shim별로:

Step 1 — Read existing

파일 없으면 → status: missing, 새로 write 진행 파일 있으면 → 내용 파싱

Step 2 — block 모드 파싱

 라인 찾기:

없으면 → status: missing (block 부재, 사용자 content 외에 새로 추가 필요)
있으면 → marker 사이의 본문 추출. 추출된 본문의 sha256:12를 계산해서 marker의 hash=H와 비교
- 불일치 → status: drifted (사용자가 수동 편집함)
- 일치 + 본문 == 템플릿 → status: clean
- 일치 + 본문 != 템플릿 → status: out-of-date (omd 템플릿이 갱신됨)

Step 3 — whole 모드 파싱

existing 전체 content와 rendered 템플릿 비교:

동일 → clean
차이 → drifted

Step 4 — drift 처리

인터랙티브: drift된 shim별로 "${path}는 수동 편집됐어요. 덮어쓸까요? (yes/no/show diff)" 묻기
--force: drift 무시 덮어씀
--check: drift 있으면 exit 1 동등 — 사용자에게 "drift detected" 보고 후 종료

Step 5 — Write

block 모드: existing 안의 marker block만 새 hash + 새 body로 교체. 마커 외부 사용자 content는 보존
whole 모드: 파일 전체를 새 rendered content로 교체. 디렉토리 (.cursor/rules/) 없으면 mkdir

Step 6 — sync-lock 갱신

.omd/sync.lock.json 기록 (없으면 만든다):

{
  "design_md_hash": "<DESIGN.md sha256:12>",
  "targets": {
    "CLAUDE.md": "<hash>",
    "AGENTS.md": "<hash>",
    ".cursor/rules/omd-design.mdc": "<hash>"
  },
  "updated_at": "<ISO timestamp>"
}

DESIGN.md 해시:

[ -f DESIGN.md ] && node -e "console.log(require('crypto').createHash('sha256').update(require('fs').readFileSync('DESIGN.md')).digest('hex').slice(0,12))"

결과 보고

CLAUDE.md (block) — updated
AGENTS.md (block) — unchanged
.cursor/rules/omd-design.mdc — created
DESIGN.md hash: ab12cd34ef56

언제 실행하나

DESIGN.md 변경 직후 (shim hash 갱신용)
새 프로젝트 첫 도입 (3종 생성)
.claude / .cursor 디렉토리 추가 후
"drift 확인" 요청

금지

마커 안 본문에 임의 추가/축약 금지 — 위 템플릿 정확히 사용
block 모드 파일에서 마커 외부 사용자 content 절대 삭제 금지
.omd/sync.lock.json 무시 금지 — 항상 갱신
DESIGN.md가 없어도 shim은 만들 수 있음 (DESIGN.md 생성 후에 hash만 채움)