메뉴
HN
Hacker News 29일 전

클로드 코드에 운세 기능을 더하는 플러그인 'Destiny'

IMP
6/10
핵심 요약

클로드 코드(Claude Code) 환경에서 작동하는 실제 사주명리학 기반 운세 플러그인이 공개되었습니다. 단순한 생성형 AI 운세가 아니라, 사용자의 생년월일시를 바탕으로 사주, 오행, 역경(주역) 괘를 수학적으로 계산한 뒤 그 결과를 클로드가 해석해주는 방식입니다. 한국 천문연구원 달력 수준의 정밀한 만년력 엔진과 진태양시 보정 기능이 적용되어 있어 기술적 완성도가 높습니다.

번역된 본문

Destiny는 클로드 코드(Claude Code)를 위한 실제 운세 점술 스킬입니다. 단순한 별자리 생성기가 아닙니다. 숫자는 계산되고, 오직 해석만 생성형 AI가 담당합니다.

빠른 시작

사전 요구 사항

  • 클로드 코드 v2.0 이상 (claude --version으로 확인, npm i -g @anthropic-ai/claude-code로 업데이트)
  • /plugin 명령어가 활성화되어 있어야 합니다. 최신 클로드 코드에서는 기본 활성화되어 있습니다. 인식되지 않는다면 /config에서 플러그인을 활성화하고 클로드 코드를 재시작하세요.

클로드 코드 내부 설치:

/plugin marketplace add xodn348/destiny
/plugin install destiny@destiny-marketplace
/destiny

터미널 설치 (/plugin을 사용할 수 없는 대안):

claude plugin marketplace add xodn348/destiny
claude plugin install destiny@destiny-marketplace

이후 클로드 코드를 실행하고 /destiny를 실행하세요.

설치 확인:

claude plugin list # destiny@destiny-marketplace가 표시되어야 합니다

/destiny 호출 시 생년월일, 태어난 시간, 도시, 성별을 한 번만 묻습니다. 이후 호출에는 /destiny만 입력하면 됩니다.

작동 흐름

클로드 코드 → Destiny 플러그인(/plugin install로 1회 설치) → /destiny 스킬(언제든 호출) → 생년월일(1회 요청, ~/.destiny/profile.json에 저장) → 오늘의 운수(개인화: 오늘의 운세 + 평생 명식)

제공되는 내용

/destiny 호출은 두 가지 섹션으로 구성된 명식을 제공합니다:

🔮 오늘의 운세 — 사주명식에 대한 오늘의 짧은 산문 운세. 5가지 범주(종합, 애정, 재물, 직장, 건강)의 별점, 이 순간에 뽑은 점괘(괘상), 그리고 행운의 숫자/색상/방향을 제공합니다.

🌌 평생 명식 — 당신의 성격, 인생의 큰 흐름, 현재 10년 대운(대운)에서의 위치. 알기 쉬운 언어로 풀이하며 번역되지 않은 전문 용어는 사용하지 않습니다.

예시 출력

샘플 프로필(1992년 7월 31일, 수원)의 실제 실행 결과. 동일한 인물 + 동일한 날짜는 항상 동일한 스크립트 출력을 생성하며, 호출 간에 산문 표현만 달라집니다.

작동 원리 (60초 요약)

이 스킬은 동양 전통 역리(易理) 세 가지를 사용하며, 각각 생년월일시로부터 결정론적으로 계산됩니다:

  • 사주(八字, 여덟 글자 사주 명식) — 출생 연도, 월, 일, 시간 각각이 한 쌍의 한자(천간 1개 + 지지 1개)와 매핑됩니다. 이는 2천 년 이상 연속으로 운영되어 온 60갑자 주기에서 뽑힙니다. 8개 글자는 당신의 '오행 지문'을 설명합니다: 오행(木·火·土·金·水) 중 무엇이 강한지, 무엇이 부족한지, 서로 어떻게 관계하는지. 일주(태어난 날의 글자)가 당신의 '진정한 자아'입니다.

  • 만년력 — 태양력 날짜를 8글자로 변환하는 엔진입니다. 절기(1년의 24기후 구분), 음력/양력 변환, 출생지 경도에 따른 진태양시 보정, 1987~88년 한국 서머타임 적용을 처리합니다. 한국 천문대에서 발행하는 달력과 동등합니다.

  • 역경(주역, Book of Changes) — 3,000년 된 64괘 점술 체계입니다. 매화역수(梅花易數) — 송나라 학자 소강절(邵雍)이 개발한 알고리즘으로 현재 음력 날짜와 시간에서 괘를 도출합니다. 괘 텍스트는 제임스 레그(James Legge)의 1899년 퍼블릭 도메인 번역본을 사용합니다.

이 스킬은 오늘의 '일주'를 같은 방식으로 계산하고 사주 명식과의 관계 — 오행 생극제화, 지지 합·충 등 — 를 분석하여 운세를 생성합니다.

실제 계산되는 내용 vs 클로드가 해석하는 내용

항목 소스
8글자 사주 명식 lunar-python — 순수 파이썬 만년력
진태양시 보정 현지 표준시 자오선으로부터의 경도 오프셋 (1도 = 4분)
한국 서머타임 처리 (1987~88년) 자동 적용
오늘의 일주 lunar-python
오행 및 십신 관계 전통 60갑자 룩업 테이블
지지 합·충·형(刑) 전통 룩업 테이블
현재 순간의 역경 괘 매화역수
괘 코퍼스 문왕 순서, 레그(1899) 퍼블릭 도메인 번역
원문 보기
원문 보기 (영어)
destiny A real fortune-telling skill for Claude Code . Not a horoscope generator. The numbers are computed; only the interpretation is generative. Quick start Prerequisites Claude Code v2.0 or newer Check with claude --version Update with npm i -g @anthropic-ai/claude-code The /plugin command must be available. On modern Claude Code it's on by default. If /plugin isn't recognized inside Claude Code, run /config and enable Plugins, then restart Claude Code. Install (inside Claude Code) /plugin marketplace add xodn348/destiny /plugin install destiny@destiny-marketplace /destiny Install from terminal (fallback if /plugin isn't available) claude plugin marketplace add xodn348/destiny claude plugin install destiny@destiny-marketplace Then launch Claude Code and run /destiny . Verify claude plugin list # should show: destiny@destiny-marketplace That's it. The first /destiny call asks for your birth date, time, city, and gender — once. Every call after is just /destiny . How it flows Claude Code │ ▼ destiny plugin ← installed once via /plugin install │ ▼ /destiny skill ← invoked any time │ ▼ your birth date ← asked once, saved to ~/.destiny/profile.json │ ▼ destiny of the day ← personalized: today's fortune + life reading What you get Each /destiny produces a two-section reading: 🔮 Today's Fortune — a short prose reading of today against your birth chart, with five-category stars (overall, love, money, career, health), a hexagram drawn for this moment, and a lucky number / color / direction. 🌌 Life Reading — your character, the broad arc of your life, and where you are in your current 10-year period. Plain language, no untranslated jargon. Example output Real run from a sample profile (1992-07-31, Suwon). Same person + same day always produces identical script output; only the prose phrasing changes between calls. How it works (the principles in 60 seconds) This skill uses three pieces of classical East Asian metaphysics, each computed deterministically from your birth date and time: Four Pillars (the eight-character birth chart) — Your year, month, day, and hour of birth each map to a pair of Chinese characters (one "Heavenly Stem" + one "Earthly Branch") drawn from a 60-cycle calendar that has run continuously for over two millennia. The eight characters together describe your "elemental fingerprint": which of the five elements (Wood / Fire / Earth / Metal / Water) dominate, which are missing, and how they relate. The character of your day-of-birth is your "core self". Perpetual lunar calendar — The engine that converts solar dates to the eight characters. It handles solar terms (the 24 climate divisions of the year), lunar/solar conversion, true-solar-time correction by birthplace longitude, and Korean Daylight Saving for births in 1987–88. Equivalent to the calendar published by Korea's national astronomical observatory. The I-Ching (Book of Changes) — A 3,000-year-old divination system of 64 hexagrams. We draw one hexagram for the present moment using plum-blossom time divination — an algorithm by the Song-dynasty scholar Shao Yong that derives the hexagram from the current lunar date and hour. Hexagram texts are from James Legge's 1899 public-domain translation. The skill computes today's "day pillar" the same way and analyzes its relationship with your birth chart — five-element generation/control cycles, branch harmonies and clashes — to produce the reading. What's actually computed (vs. interpreted by Claude) Layer Source Your eight-character birth chart lunar-python — pure-Python perpetual calendar True solar time correction longitude offset from local standard time meridian (1° = 4 min) Korean DST handling (1987–88) automatic Today's day pillar lunar-python Five Elements + Ten Gods relationships classical 60-cycle lookup tables Branch harmonies, clashes, punishments classical lookup tables I-Ching hexagram for this moment plum-blossom time divination Hexagram corpus King Wen ordering, Legge (1899) public-domain translation Lucky number / color / direction derived from your day-of-birth's element + the hexagram Star ratings, character sketch, life arc, today's advice Claude, applying classical reading conventions to the data above Same person + same day always produces identical script output. Only the prose phrasing changes between calls. No external APIs. No scraped sites. Everything runs locally. Variants /destiny — full reading (auto-loads saved profile) /destiny today — only today's fortune /destiny life — only life reading /destiny reset — delete saved profile and start over /destiny in english|korean|japanese|chinese|spanish — switch language /destiny born YYYY-MM-DD HH:MM <city> <m|f> — one-off without saving /destiny quick — generic daily, no personal data Why this exists Most fortune apps either (a) compute the chart correctly but lock interpretation behind a paywall, or (b) let an LLM hallucinate the whole thing and call it astrology. This skill keeps the deterministic part deterministic — you can verify your eight characters against any traditional calendar source — and lets Claude do what it's actually good at: applying centuries-old reading conventions to that fixed data. Default output is English with every classical term unpacked into plain language. A reader with zero exposure to East Asian astrology should follow it. Output switches to Korean / Japanese / Chinese / Spanish on request. Stack Python 3.10+ lunar-python (MIT) — pure-Python perpetual lunar calendar I-Ching: King Wen ordering + Legge (1899) public-domain judgments Claude Code plugin format License MIT