ai-divination-skills

Servidor MCP auditado de tarot, I Ching y adivinación Xiao Liu Ren. Entropía local con semilla; el modelo solo interpreta la salida JSON.

GitHub

Prueba este MCPPatrocinado

Documentación

Oraclebone

El hueso se agrieta. El modelo lee.

uvx oraclebone-mcp · Página principal · v8.2.0

Hace tres mil años, los reyes Shang tallaban sus adivinaciones en hueso — el primer registro auditable de un oráculo en acción. Oraclebone aporta la misma disciplina a los agentes de IA: los scripts auditados producen la tirada, el hexagrama, los pilares; el modelo solo interpreta lo que se le da. Nunca inventa el resultado.

English | 简体中文 | 日本語

Demo

🔮 Kit de adivinación de código abierto para agentes de IA, anteriormente conocido como ai-divination-skills (renombrado en v8.0.0 — el paquete antiguo de PyPI está congelado; instala oraclebone en su lugar).

oraclebone es una colección práctica de habilidades para tarot, I Ching, Xiao Liu Ren y futuros sistemas simbólicos. Está diseñado para flujos de trabajo de agentes que necesitan aleatoriedad auditable, límites metodológicos claros y plantillas de interpretación reutilizables.

Este proyecto trata la adivinación como razonamiento simbólico y reflexión, no como predicción determinista.

⚡ Instalación en una línea para agentes de IA

Pega esto en tu agente de IA:

Install Oraclebone for this agent: https://raw.githubusercontent.com/sapuyou45-bit/oraclebone/main/docs/install.md

O instala directamente para habilidades locales estilo Claude:

curl -fsSL https://raw.githubusercontent.com/sapuyou45-bit/oraclebone/main/install.sh | bash

El destino predeterminado es ~/.claude/skills. Establece AI_SKILLS_DIR para otro directorio de habilidades de agente.

✨ Resumen

La mayoría de los prompts de adivinación con IA dejan que el modelo invente el resultado. Este repositorio separa las dos tareas:

Un script local produce la tirada de cartas, el hexagrama o la posición de Xiao Liu Ren.
El agente de IA interpreta ese resultado generado con límites de seguridad claros.

Eso hace que las lecturas sean más fáciles de probar, reproducir, auditar y reutilizar entre agentes.

🧭 Rigor metodológico

La regla principal es simple: los scripts o las tiradas físicas proporcionadas por el usuario generan el resultado de la adivinación; la IA interpreta ese resultado y no genera el resultado de la adivinación.

Esto no es una prueba científica de la eficacia de la adivinación. Es un flujo de trabajo más estricto para el razonamiento simbólico:

las lecturas reales usan aleatoriedad del sistema por defecto
el modo con semilla es solo para pruebas y demos reproducibles
los métodos tradicionales y sus limitaciones están documentados por habilidad
las salidas JSON incluyen suficientes metadatos para auditar el método
los modos aproximados emiten advertencias en lugar de pretender ser tradicionales

🌐 Documentación multilingüe

El sitio de GitHub Pages incluye un selector de seis idiomas — 简体中文, English, 日本語, Português, 한국어, Español. Sigue el idioma de tu navegador por defecto y recuerda tu elección manual.

Abrir el sitio publicado

Vista previa local:

python3 -m http.server 8000 -d docs

Sitio publicado:

https://sapuyou45-bit.github.io/oraclebone/

🧩 Habilidades incluidas

Habilidad	Qué hace	Script
`tarot`	Saca cartas de tarot para reflexión, decisiones, bloqueos creativos y replanteamiento de proyectos.	`skills/tarot/scripts/draw.py`
`iching`	Lanza hexagramas de I Ching de seis líneas con hexagramas primario y resultante.	`skills/iching/scripts/cast.py`
`xiaoliuren`	Lanza Xiao Liu Ren a partir de números de estilo lunar o una alternativa de tiempo gregoriano.	`skills/xiaoliuren/scripts/cast.py`
`bazi`	Lanza una carta de Bazi (Cuatro Pilares / 八字) a partir de una fecha y hora de nacimiento gregoriana. Requiere el extra opcional `lunar-python`.	`skills/bazi/scripts/cast.py`

🚀 Inicio rápido

Instala desde PyPI:

pip install oraclebone

O desde una copia del repositorio:

pip install .

Usa el modo editable durante el desarrollo:

pip install -e .

Usa un solo comando para todos los sistemas:

ai-divination tarot --deck major --spread three-card --reversals
ai-divination iching --method yarrow
ai-divination xiaoliuren --method numbers --month 3 --day 12 --hour 7

Pide una plantilla de interpretación para el agente:

ai-divination template tarot

Usa la API de Python directamente:

from oraclebone.tarot import draw
from oraclebone.iching import cast
from oraclebone.xiaoliuren import cast_numbers

Todavía puedes ejecutar los scripts subyacentes directamente:

python3 skills/tarot/scripts/draw.py --deck major --spread three-card --reversals
python3 skills/iching/scripts/cast.py --method coins
python3 skills/iching/scripts/cast.py --method yarrow
python3 skills/xiaoliuren/scripts/cast.py --method numbers --month 3 --day 12 --hour 7

Usa una semilla para demos reproducibles:

python3 skills/tarot/scripts/draw.py --spread decision --seed demo
python3 skills/iching/scripts/cast.py --method yarrow --seed demo

Todos los scripts generan JSON.

📦 Instalar como habilidades de agente

Para una configuración guiada por agente de IA, usa el manual de instalación remota:

Install Oraclebone for this agent: https://raw.githubusercontent.com/sapuyou45-bit/oraclebone/main/docs/install.md

Para instalación directa desde la terminal:

curl -fsSL https://raw.githubusercontent.com/sapuyou45-bit/oraclebone/main/install.sh | bash

El instalador copia tarot, iching y xiaoliuren en ~/.claude/skills por defecto. Para apuntar a otro agente, establece AI_SKILLS_DIR antes de ejecutarlo.

La instalación manual consiste en copiar las carpetas que quieras al directorio de habilidades de tu agente:

mkdir -p ~/.claude/skills
cp -R skills/tarot ~/.claude/skills/tarot
cp -R skills/iching ~/.claude/skills/iching
cp -R skills/xiaoliuren ~/.claude/skills/xiaoliuren

Cada habilidad es autocontenida:

skills/name/
  SKILL.md
  agents/openai.yaml
  scripts/
  references/

Instala carpetas individuales, no todo el repositorio, cuando solo quieras una habilidad.

Cada script de habilidad también funciona en modo de carpeta única. Si el paquete de Python está instalado, el script delega en el tiempo de ejecución del paquete. Si solo se copia la carpeta de la habilidad, recurre al script independiente incluido en esa habilidad.

Adaptadores por host

Cada habilidad incluye cuatro archivos de adaptador en skills/<skill>/agents/:

Host	Archivo	Cómo se invoca
Habilidades de OpenAI / Codex	`openai.yaml`	Metadatos de habilidad + iconos de marca.
Habilidades de Claude Desktop / proyectos claude.ai	`claude.yaml`	Especificación de herramienta que ejecuta `ai-divination <skill>`.
Gemini CLI / Extensiones de Gemini	`gemini.yaml`	Manifiesto de extensión que ejecuta el mismo CLI.
Cursor	`cursor.mdc`	Archivo de reglas con una protección estricta de "nunca inventes la tirada".

Los cuatro adaptadores pasan por el mismo CLI auditado ai-divination <skill>, por lo que el host del agente nunca inventa el resultado.

🧠 Úsalo desde Claude Desktop / Codex / cualquier host MCP

oraclebone incluye un servidor MCP integrado (ai-divination-mcp). Cualquier host de Model Context Protocol — Claude Desktop, Codex, Continue, Cursor — puede montarlo con una sola línea de configuración, y el modelo recibe cinco herramientas: tarot_draw, iching_cast, xiaoliuren_cast, bazi_cast y interpretation_template.

El modelo nunca inventa la tirada; el servidor ejecuta los scripts auditados localmente.

Claude Desktop

Instala el paquete una vez:

pip install oraclebone

Luego edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "divination": {
      "command": "ai-divination-mcp"
    }
  }
}

Reinicia Claude Desktop. Pide "saca tres cartas de tarot para mi decisión" — Claude llamará a tarot_draw e interpretará la salida JSON.

Codex / Continue / Cursor

Cualquier host compatible con MCP sigue el mismo patrón. El servidor habla JSON-RPC 2.0 sobre stdio sin dependencias de terceros.

Guías de configuración por cliente

Configuraciones JSON listas para copiar y pegar y prompts de ejemplo para cada host:

🤖 Comportamiento del agente

Cada habilidad instruye al agente a:

generar o aceptar un resultado concreto de tirada/lanzamiento
leer material de referencia conciso solo cuando sea necesario
interpretar con el contrato de respuesta compartido
evitar certezas, fatalismo y consejos profesionales

La guía compartida se encuentra en:

shared/methodology.md
shared/interpretation-protocol.md
shared/response-contract.md
shared/randomness-protocol.md
shared/safety-policy.md
shared/interpretation-style.md

🧪 Ejemplos

examples/tarot-decision.md
examples/iching-strategy.md
examples/xiaoliuren-daily.md

🛡️ Límites de seguridad

Estas habilidades no son para orientación médica, legal, financiera o de crisis.

Las buenas lecturas deberían:

enmarcar el resultado como reflexión simbólica
conectar las afirmaciones con el resultado generado
preservar la agencia del usuario
ofrecer pasos siguientes pequeños y reversibles
expresar la incertidumbre con claridad

Consulta ETHICS.md para conocer la postura completa del proyecto.

🛠️ Desarrollo

No se requieren dependencias de tiempo de ejecución más allá de Python 3.

Ejecuta las pruebas:

python3 -m unittest discover -s tests

Comprobaciones de cobertura actuales:

enrutamiento unificado del CLI
ejecución del CLI solo con paquete
APIs de Python importables
ejecución de habilidades en carpeta única
contratos de metadatos y activos de habilidades
plantillas de protocolo de interpretación
salida de tiradas de tarot
estructura de lanzamiento de I Ching y líneas manuales
comportamiento de números de Xiao Liu Ren y alternativa de tiempo

💬 Comunidad

Lanzamientos: https://github.com/sapuyou45-bit/oraclebone/releases
Hoja de ruta: ROADMAP.md
Discusiones: https://github.com/sapuyou45-bit/oraclebone/discussions
Problemas: elige un good first issue o propón un new-skill
Seguridad: consulta SECURITY.md para informar vulnerabilidades de forma privada

🗺️ Hoja de ruta

A corto plazo:

Añadir un flujo de trabajo de paquete publicado.
Ampliar la validación automatizada de habilidades en CI.
Añadir material de referencia más rico para cada habilidad MVP.
Añadir más lecturas de ejemplo.
Añadir más ejemplos de integración con agentes.

Más adelante:

meihua
liuyao
runes
numerology
astrology

📄 Licencia

MIT