sxt9805/xuanxue-engine

Deterministic engine for seven divination systems (Bazi, Ziwei, Plum Blossom, Qimen, Liuyao, Tarot, Western Astrology) as a Codex AI Agent skill.

O que é xuanxue-engine?

O **Xuanxue Engine** é uma skill para agentes de IA (Codex, Claude Code, Cursor) que fornece um motor determinístico e rigoroso para cálculo e interpretação de sete sistemas divinatórios chineses e ocidentais: Bazi (Oito Caracteres), Ziwei Doushu (Astrología do Imperador Roxo), Meihua Yishu (Plum Blossom Divination), Qimen Dunjia (Portas Misteriosas), Liuyao (Seis Linhas), Tarot e Astrologia Ocidental. A skill implementa um fluxo de trabalho claro: coletar os parâmetros corretos (data, hora, local, coordenadas), executar scripts Node.js dedicados, e separar rigorosamente o cálculo da interpretação. O agente nunca deve calcular manualmente; ele sempre invoca os scripts da skill, que retornam mapas astrais, hexagramas, cartas e outros resultados. A interpretação é feita exclusivamente com base nos campos retornados (chart, facts, warnings), evitando alucinações e mantendo o tom de 'sugestão ou tendência', nunca de predição fatalista. A skill suporta três modos: cálculo específico (calculate), rápido (quick) para seleção automática de 1-2 sistemas, e revisão completa (review) para todos os sistemas. Caso a pasta node_modules não exista, o agente instrui o usuário a executar npm install. O motor também possui um modo 'roast' acionado pelo usuário, permitindo comentários sarcásticos, mas sem aumentar a certeza das previsões. A privacidade é central: nenhum dado pessoal é salvo por padrão, e o agente deve sempre informar o usuário antes de persistir qualquer informação.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add sxt9805/xuanxue-engine

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Motor de Síntese de Metafísica Chinesa e Ocidental (Xuanxue Engine)

Princípios Fundamentais

  1. Primeiro, colete as entradas necessárias para o cálculo, depois execute o script.
  2. Sempre separe o cálculo da interpretação. Nunca calcule manualmente os Quatro Pilares, Estrelas, Casas, Trigramas, Cartas ou Posições Planetárias.
  3. Interprete apenas os campos que o script realmente retornar. Informações ausentes, conflitantes ou incertas devem ser explicitamente declaradas.
  4. Apresente os resultados como símbolos, tendências e alertas de risco dentro dos sistemas tradicionais. Não trate morte, doença, crime, retorno de investimento ou outros resultados de alto risco como fatos determinados.
  5. Por padrão, não salve nomes, datas de nascimento, locais, perguntas ou resultados.

Fluxo de Trabalho

1. Determinar o Modo de Execução

  • Quando o usuário especificar um sistema, use calculate.
  • Quando o usuário apenas descrever um problema sem mencionar o sistema, use quick, aceitando um ou dois sistemas escolhidos pelo roteador.
  • Quando o usuário solicitar explicitamente "revisão dos sete sistemas", "todos os sistemas" ou expressão equivalente, use review.
  • Não execute todos os sete sistemas no modo rápido apenas para parecer abrangente.

2. Coletar as Entradas Necessárias

  • Bazi: Data e hora de nascimento local, latitude/longitude; fuso horário opcional (pode ser inferido offline). Hora solar verdadeira ativada por padrão.
  • Ziwei Doushu: Data e hora de nascimento, sexo; usar a hora corrigida pela hora solar verdadeira.
  • Astrologia Ocidental: Data e hora de nascimento local, latitude/longitude; fuso horário opcional.
  • Qimen Dunjia: Pergunta e data/hora/local de início da consulta; não use uma hora fictícia se não for fornecida.
  • Meihua Yishu: Data/hora para cálculo temporal, números explícitos, ou números de imagem confirmados pelo usuário.
  • Liuyao: Seis resultados de três moedas, seis valores de linha, números explícitos, ou permitir que o script jogue moedas usando a semente retornada.
  • Tarot: Naipe ou número de cartas; a seleção aleatória deve ser gerada pelo script e a semente retornada.

3. Executar o Script

No diretório raiz da Skill:

node scripts/xuanxue.mjs quick --input <request.json>
node scripts/xuanxue.mjs calculate --system <system> --input <request.json>
node scripts/xuanxue.mjs review --input <request.json>

Também é possível usar --stdin para ler o JSON da entrada padrão. IDs dos sistemas: bazi, ziwei, meihua, qimen, liuyao, tarot, astrology.

Se a pasta node_modules/ não existir, informe ao usuário que a instalação inicial requer conexão com a internet e, em seguida, execute npm.cmd install. Não baixe dependências silenciosamente.

4. Verificar os Resultados

  • Confirme que ok no nível superior é true.
  • Consulte os campos method, chart, facts, warnings e provenance. Não consulte informações de mapa que não existam.
  • Mantenha requestDigest, inputDigest de cada sistema e o seed aleatório para reprodutibilidade.
  • Na revisão completa, relate também os sistemas skipped e explique por que foram ignorados.

5. Organizar a Interpretação

Saída na seguinte ordem:

  1. Resumo das Conclusões: Duas a cinco observações mais úteis e verificáveis.
  2. Mapa do Script: Liste brevemente os resultados reais do cálculo e o método.
  3. Validação Cruzada: Diferencie concordância, complementaridade e conflito entre múltiplos sistemas.
  4. Verificação na Realidade: Forneça pontos no tempo, indicadores comportamentais ou fontes de informação que o usuário possa verificar na vida real.
  5. Limites de Risco: Ao abordar saúde, finanças, questões legais ou segurança pessoal, recomende explicitamente o uso de informações profissionais e evidências do mundo real.

Não transforme frases genéricas em conclusões precisas. Quando não houver evidências suficientes, diga diretamente: "O mapa não sustenta esse julgamento."

Modo Sarcástico

Ativado apenas quando o usuário solicitar e o campo options.roast no request for true.

  • Pode usar linguagem chula, provocação, sarcasmo e ironia, limitado a escolhas, hábitos, planos ou contradições do usuário que podem ser mudados.
  • Não use discurso de ódio, ataques a características protegidas, degradação pessoal, desumanização, ameaças, incentivo à automutilação ou insultos a terceiros reais.
  • Não aumente a certeza das conclusões por estar no modo sarcástico.
  • Para tópicos como morte, doença, retorno de investimento, continue usando expressões de tendência e risco, exigindo verificação na realidade ou julgamento profissional.
  • Quando o usuário retirar o consentimento, retorne imediatamente ao modo moderado.

Privacidade

  • Por padrão, use arquivos de requisição temporários e exclua-os após a conclusão.
  • Escreva no diretório profiles/ apenas se o usuário solicitar explicitamente a preservação do arquivo.
  • Antes de salvar, mostre quais campos serão gravados e use apelidos em vez de nomes reais sempre que possível.
  • Não grave dados pessoais em logs, fixtures de teste, commits Git, Issues ou repositórios públicos.

Referências

  • Fontes e licenças: references/sources.yaml
  • Schema do Request: schemas/request.schema.json
  • Schema do Result: schemas/result.schema.json
  • Descrições dos métodos de cada sistema: references/methods/

Habilidades Relacionadas