Claude Code, Codex, OpenCode에서 프롬프트와 스킬을 동기화하는 방법 (복사/붙여넣기 드리프트 없이)

컴퓨터 간에 재사용하는 지시를 위한 실용적인 워크플로: 단일 진실 공급원, 안전한 설치, 프로바이더가 디스크의 파일을 기대할 때의 드리프트 감지.

기준 버전
CLI
0.2.17
프리뷰 ref
a2c45c8

"스킬"과 재사용 가능한 프롬프트는 좋은 아이디어입니다.

하지만 실제로 관리되는 방식은 그리 좋지 않습니다.

  • 한 머신에 폴더 하나
  • 다른 머신에 다른 폴더
  • 조금씩 다른 버전들

그러다 세션을 시작하면 실제로 어떤 지시 세트를 쓰는지 알 수 없습니다.

이게 드리프트 문제입니다.

이 가이드는 Claude Code, Codex, OpenCode에서 프롬프트/스킬을 일관되게 유지하는 워크플로를 다룹니다.

요약

  1. 컴퓨터 간에 재현 가능한 동작을 원한다면 프롬프트/스킬의 단일 진실 공급원이 필요합니다.
  2. 프로바이더가 디스크의 파일을 기대한다면 설치/내보내기 경로도 필요합니다.
  3. 실패 패턴은 조용한 드리프트입니다(한 복사본은 바꾸고 다른 하나는 잊음).
  4. Happier는 도움이 되는 한 가지 방법입니다. 라이브러리를 진실 공급원으로 다루고, 프로바이더 고유 위치로 내보내기/설치할 수 있으며, 링크와 다이제스트를 추적해 조용히 덮어쓰는 대신 드리프트를 감지합니다.

문제

재사용 가능한 지시는 일관될 때만 쓸모 있습니다.

다음과 같아지면:

  • 머신이 둘 이상이거나
  • 프로바이더가 둘 이상이면

…복사/붙여넣기는 부담이 됩니다.

일반적인 방법과 트레이드오프

  • gist 하나를 두고 필요할 때 복사/붙여넣기: 되지만 수작업이고 일관성이 없습니다.
  • 프롬프트용 Git 리포지토리: 낫지만 프로바이더 고유 위치로 설치/내보내기는 여전히 필요합니다.
  • 프로바이더별 폴더 분리: 규칙 하나를 모든 곳에 적용하고 싶어지기 전까지는 괜찮습니다.

Happier가 처음이라면

Happier를 처음 본다면: Claude Code, Codex, OpenCode 같은 세션을 여러 컴퓨터에서 실행하기 위한 오픈 소스 컴패니언 앱(모바일/웹/데스크톱)입니다.

이 가이드와 관련된 부분은 단일 프롬프트/스킬 라이브러리와, 프로바이더 고유 위치로 안전하게 내보내기/설치하는 방법을 제공한다는 점입니다.

설정하기:

실제로 쓸 수 있는 워크플로

1) 라이브러리를 진실 공급원으로 다루기

생각의 전환은 이렇습니다.

  • .claude/skills나 .opencode/skills를 라이브러리로 여기지 않는다
  • 그것들은 내보내기 대상으로 여긴다

2) 빠른 컴포저 단축키에는 Templates 사용

"/review"나 "/ship-check" 같은 단축키를 원한다면 저장된 프롬프트를 삽입하는 Templates를 사용하세요.

동기화가 유지되므로 복사/붙여넣기보다 낫습니다.

3) 에이전트 자체의 명령과 스킬도 사용

0.2.16부터 새 세션 컴포저에서 / 또는 $를 입력하면, 지원되는 경우 선택한 에이전트가 그 컴퓨터, 프로젝트, 연결된 계정에서 이미 제공하는 명령이나 스킬을 볼 수 있습니다. 네이티브 스킬을 고르면 에이전트 자체의 복사본을 직접 쓰므로 Happier 라이브러리에 중복이 추가되지 않습니다. 검색하려면 그 컴퓨터에서 에이전트와 로그인이 준비되어 있어야 합니다.

4) 지속적인 동작에는 System prompt additions 사용

모든 세션(또는 프로필)에 규칙을 적용하고 싶다면 System prompt additions를 사용하세요.

이렇게 하면 "diff 검토 방식"을 다시 입력하지 않고도 일관되게 유지할 수 있습니다.

많은 사람이 걸려 넘어지는 실무 부분입니다.

어떤 도구(나 팀)는 디스크의 실제 파일을 기대합니다.

  • .claude/skills
  • .opencode/skills
  • .agents/skills
  • .claude/commands

그래서 내보내기 경로가 필요합니다.

Happier에서는 프롬프트/스킬을 머신의 대상 위치로 내보낼 수 있고, 설치 방법을 고를 수 있습니다.

  • Copy: 대상 위치에 독립된 복사본을 씁니다.
    • 완전히 자체 포함된 폴더가 필요할 때 좋습니다.
    • 트레이드오프: 업데이트는 수동입니다.
  • Symlink: Happier가 관리하는 실체 복사본 하나를 두고 외부 대상을 그것에 연결합니다.
    • 업데이트를 쉽게 하고 싶을 때 좋습니다.
    • 트레이드오프: 심볼릭 링크를 싫어하는 환경이 있습니다(또는 완전히 이식 가능한 폴더를 원할 때).

다중 컴퓨터 워크플로에서 이게 중요한 이유는, 여러 갈래로 갈라진 복사본을 두지 않고도 같은 스킬 묶음을 여러 컴퓨터의 프로바이더 고유 위치에 둘 수 있기 때문입니다.

6) 시크릿과 프로바이더 토큰: 스킬 파일에 넣지 않기

흔한 실수는 API 키를 스킬 묶음 안에 넣는 것입니다.

동작은 합니다… 다음을 하기 전까지는:

  • 스킬을 다른 머신으로 내보내기
  • 리포지토리 공유
  • 스킬을 이슈에 붙여 넣기

스킬에 자격 증명이 필요하다면 스킬은 코드로, 자격 증명은 시크릿으로 다루세요.

  • 스킬 내용은 범용적으로 유지
  • 자격 증명은 환경 변수나 저장된 시크릿 기능에서 가져오기
  • 시크릿은 프로필별/머신별로 연결

(Happier 프로필을 쓴다면 CLI 시크릿 확인 순서가 중요합니다: 환경 변수 → 저장된 시크릿 연결 → 대화형 프롬프트.)

7) 조용히 덮어쓰지 않기: 드리프트 감지

여기서 유용한 건 조용한 안전성입니다.

  • 외부 복사본이 바뀌면 Happier가 다이제스트 불일치를 감지한다
  • 파일을 조용히 덮어쓰지 않는다

그래서 필요할 때는 의도적으로 로컬에서 편집하면서도, 동기화가 어긋났다는 사실은 알 수 있습니다.

관련 가이드

skillspromptsclaudecodexopencodemulti-machine
마지막 업데이트: 2026-10-26