ai-divination-skills

Servidor MCP de adivinhação auditado com tarô, I Ching e Xiao Liu Ren. Entropia local com semente; o modelo apenas interpreta a saída JSON.

GitHub

Experimente este MCPPatrocinado

Documentação

Oraclebone

O osso racha. O modelo lê.

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

Há três mil anos, os reis Shang gravavam suas adivinhações em ossos — o primeiro registro auditável de um oráculo em ação. O Oraclebone traz a mesma disciplina para agentes de IA: scripts auditados produzem o sorteio, o hexagrama, os pilares; o modelo apenas interpreta o que recebe. Ele nunca inventa o resultado.

English | 简体中文 | 日本語

Demonstração

🔮 Kit de ferramentas de adivinhação de código aberto para agentes de IA, anteriormente conhecido como ai-divination-skills (renomeado na v8.0.0 — o pacote antigo no PyPI está congelado; instale oraclebone em vez disso).

oraclebone é uma coleção prática de habilidades para tarô, I Ching, Xiao Liu Ren e futuros sistemas simbólicos. Foi construído para fluxos de trabalho de agentes que precisam de aleatoriedade auditável, limites de método claros e modelos de interpretação reutilizáveis.

Este projeto trata a adivinhação como raciocínio simbólico e reflexão, não como previsão determinística.

⚡ Instalação em uma linha para Agentes de IA

Cole isto no seu agente de IA:

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

Ou instale diretamente para habilidades locais no estilo Claude:

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

O destino padrão é ~/.claude/skills. Defina AI_SKILLS_DIR para outro diretório de habilidades do agente.

✨ Visão Geral

A maioria dos prompts de adivinhação com IA deixa o modelo inventar o resultado. Este repositório separa as duas tarefas:

Um script local produz o sorteio de cartas, o hexagrama ou a posição do Xiao Liu Ren.
O agente de IA interpreta o resultado gerado com limites de segurança claros.

Isso torna as leituras mais fáceis de testar, reproduzir, auditar e reutilizar entre agentes.

🧭 Rigor Metodológico

A regra central é simples: scripts ou lançamentos físicos fornecidos pelo usuário geram o resultado da adivinhação; a IA interpreta esse resultado e não gera o resultado da adivinhação.

Isto não é prova científica da eficácia da adivinhação. É um fluxo de trabalho mais rigoroso para raciocínio simbólico:

leituras reais usam aleatoriedade do sistema por padrão
o modo com semente é apenas para testes e demonstrações reproduzíveis
métodos tradicionais e limitações são documentados por habilidade
saídas JSON incluem metadados suficientes para auditar o método
modos aproximados emitem avisos em vez de fingir ser tradicionais

🌐 Documentação Multilíngue

O site no GitHub Pages oferece um seletor de seis idiomas — 简体中文, English, 日本語, Português, 한국어, Español. Ele segue o idioma do seu navegador por padrão e lembra sua escolha manual.

Abrir o site publicado

Pré-visualização local:

python3 -m http.server 8000 -d docs

Site publicado:

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

🧩 Habilidades Incluídas

Habilidade	O que faz	Script
`tarot`	Sorteia cartas de tarô para reflexão, decisões, bloqueios criativos e reformulação de projetos.	`skills/tarot/scripts/draw.py`
`iching`	Lança hexagramas de I Ching de seis linhas com hexagramas primário e resultante.	`skills/iching/scripts/cast.py`
`xiaoliuren`	Lança Xiao Liu Ren a partir de números no estilo lunar ou um fallback de tempo gregoriano.	`skills/xiaoliuren/scripts/cast.py`
`bazi`	Lança um mapa de Bazi (Quatro Pilares / 八字) a partir de uma data/hora de nascimento gregoriana. Requer o extra opcional `lunar-python`.	`skills/bazi/scripts/cast.py`

🚀 Início Rápido

Instale a partir do PyPI:

pip install oraclebone

Ou a partir de um checkout:

pip install .

Use o modo editável durante o desenvolvimento:

pip install -e .

Use um único comando para todos os 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

Peça um modelo de interpretação para o agente:

ai-divination template tarot

Use a API Python diretamente:

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

Você ainda pode executar os scripts subjacentes diretamente:

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

Use uma semente para demonstrações reproduzíveis:

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

Todos os scripts geram saída JSON.

📦 Instalar como Habilidades de Agente

Para configuração guiada por agente de IA, use o runbook de instalação remota:

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

Para instalação direta via shell:

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

O instalador copia tarot, iching e xiaoliuren para ~/.claude/skills por padrão. Para direcionar outro agente, defina AI_SKILLS_DIR antes de executá-lo.

A instalação manual é apenas copiar as pastas desejadas para o diretório de habilidades do seu 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 habilidade é autocontida:

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

Instale pastas individuais, não o repositório inteiro, quando quiser apenas uma habilidade.

Cada script de habilidade também funciona no modo de pasta única. Se o pacote Python estiver instalado, o script delega para o runtime do pacote. Se apenas a pasta da habilidade for copiada, ele usa o script autônomo incluído nessa habilidade.

Adaptadores por host

Cada habilidade inclui quatro arquivos de adaptador em skills/<skill>/agents/:

Host	Arquivo	Como é invocado
Habilidades OpenAI / Codex	`openai.yaml`	Metadados da habilidade + ícones de marca.
Habilidades de projeto Claude Desktop / claude.ai	`claude.yaml`	Especificação de ferramenta que executa `ai-divination <skill>`.
Gemini CLI / Extensões Gemini	`gemini.yaml`	Manifesto de extensão que executa o mesmo CLI.
Cursor	`cursor.mdc`	Arquivo de regras com proteção rígida de "nunca invente o sorteio".

Todos os quatro adaptadores passam pelo mesmo CLI auditado ai-divination <skill>, então o host do agente nunca inventa o resultado.

🧠 Use a partir do Claude Desktop / Codex / qualquer host MCP

oraclebone inclui um servidor MCP integrado (ai-divination-mcp). Qualquer host de Model Context Protocol — Claude Desktop, Codex, Continue, Cursor — pode montá-lo com uma única linha de configuração, e o modelo recebe cinco ferramentas: tarot_draw, iching_cast, xiaoliuren_cast, bazi_cast e interpretation_template.

O modelo nunca inventa o sorteio; o servidor executa os scripts auditados localmente.

Claude Desktop

Instale o pacote uma vez:

pip install oraclebone

Depois edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Reinicie o Claude Desktop. Peça "sorteie três cartas de tarô para minha decisão" — o Claude chamará tarot_draw e interpretará a saída JSON.

Codex / Continue / Cursor

Qualquer host compatível com MCP segue o mesmo padrão. O servidor fala JSON-RPC 2.0 via stdio sem dependências de terceiros.

Guias de configuração por cliente

Configurações JSON prontas para copiar e colar e exemplos de prompts para cada host:

🤖 Comportamento do Agente

Cada habilidade instrui o agente a:

gerar ou aceitar um resultado concreto de sorteio/lançamento
ler material de referência conciso apenas quando necessário
interpretar com o contrato de resposta compartilhado
evitar certeza, fatalismo e aconselhamento profissional

A orientação compartilhada está em:

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

🧪 Exemplos

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

🛡️ Limites de Segurança

Estas habilidades não são para orientação médica, jurídica, financeira ou de crise.

Boas leituras devem:

enquadrar o resultado como reflexão simbólica
conectar afirmações ao resultado gerado
preservar a autonomia do usuário
oferecer próximos passos pequenos e reversíveis
declarar a incerteza claramente

Veja ETHICS.md para a posição completa do projeto.

🛠️ Desenvolvimento

Nenhuma dependência de runtime é necessária além do Python 3.

Execute os testes:

python3 -m unittest discover -s tests

Verificações de cobertura atuais:

roteamento unificado do CLI
execução do CLI apenas com pacote
APIs Python importáveis
execução de habilidade em pasta única
contratos de metadados e ativos de habilidade
modelos de protocolo de interpretação
saída de spreads de tarô
estrutura de lançamento do I Ching e linhas manuais
comportamento de números e fallback de tempo do Xiao Liu Ren

💬 Comunidade

Lançamentos: https://github.com/sapuyou45-bit/oraclebone/releases
Roteiro: ROADMAP.md
Discussões: https://github.com/sapuyou45-bit/oraclebone/discussions
Problemas: escolha um good first issue ou proponha um new-skill
Segurança: veja SECURITY.md para relato privado de vulnerabilidades

🗺️ Roteiro

Curto prazo:

Adicionar um fluxo de trabalho de pacote publicado.
Expandir a validação automatizada de habilidades no CI.
Adicionar material de referência mais rico para cada habilidade MVP.
Adicionar mais exemplos de leituras.
Adicionar mais exemplos de integração com agentes.

Depois:

meihua
liuyao
runes
numerology
astrology

📄 Licença

MIT