mcpField
B
bazi-persona

bazi-persona

github.com/cantian-aiその他16153 回インストール28 週間前に更新
リポジトリ

bazi-persona について

Bazi Persona は、生年月日、八字の知識、現実の事実をもとに会話用の人格を作成・更新するスキルです。人格との対話、時点別分析、暦の照会、チャットの取り込みに対応し、ファイル管理用 CLI も備えます。

主な機能

  1. 01出生情報から人格を作成
  2. 02プロフィールと重要な記憶を更新
  3. 03通常と八字分析付きの会話を切り替え
  4. 04大運や日付ごとの運勢を分析
  5. 05中国暦を照会
  6. 06チャットを取り込み候補事実を抽出

活用シーン

  1. 01誕生日から会話用人格を作成
  2. 02現実の変化を人格に反映
  3. 03指定時点の人格状態を分析
  4. 04過去のチャットから記憶を抽出

MCP 対応

ワークフローでは、命式作成、時点別の八字照会、人格・記憶管理、暦の検索、チャット取り込み用のツールを提供します。README には、これらのツールが MCP プロトコルを使うとの記載はありません。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cantian-ai/bazi-persona-skill --skill bazi-persona

インストール後、Claude Code で/bazi-personaを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.npmignore
LICENSE
.gitignore
README.en.md
README.zh-TW.md
README.ko.md
README.md
README.ja.md
package.json
package-lock.json
.github/workflows/
openclaw-package.yml
publish.yml
openclaw/
README.md
prompts/
chat_base.md
cheat_mode.md
create_persona.md
compat_guidance.md
knowledge.md
manifest.json
memory_builder.md
release/openclaw/bazi-persona/
README.md
package.json
release/openclaw/bazi-persona/prompts/
compat_guidance.md
create_persona.md
manifest.json
knowledge.md
memory_builder.md
scripts/
build-openclaw-release.sh
src/
index.ts
src/kernel/
intent.ts

詳細

八字人格 Bazi Persona

チャット履歴は不要です。誕生日だけで人格を生成できます。

八字人格は、八字の命式、命理の知識、現実の事実を組み合わせた人格システムです。
目標は「ラベルのレポート」を生成することではなく、継続的に対話し、更新し、分析の視点を切り替えられる人格を完成させることです。

デフォルトではユーザーの現在の入力言語に合わせます。言語が明確でない場合は、まず中国語を使用します。

1) この Skill でできること

この skill は、次の 8 種類の処理を行います。

  1. 人格を作成する(まず命式を作成し、その後に人格を生成)
  2. 人格を更新する(事実を追加し、情報を修正し、関係性の手掛かりを補足)
  3. 通常モードでチャットする(まずその人らしく自然に話す)
  4. チートモードでチャットする(人格の口調に命理分析を加える)
  5. 動的な流時分析(大運/流年/流月/流日/流時)
  6. 黄暦/万年暦を照会する
  7. 外部チャットをインポートし、候補となる事実を抽出する
  8. オプションの人格起動時注入(SOUL/agent の起動コンテキスト)

1.1) 使用しない場面

次のような場面では、この skill は適していません。

  • ペルソナ、八字、流時、黄暦の情報を必要とせず、雑談だけをしたい場合。
  • 汎用タスク(コーディング、ドキュメント検索、翻訳、レポートなど)のみを行う場合は、汎用スキルを使用してください。
  • 人格を作成または特定するために必要な重要情報がない場合(少なくとも対象を明確に特定できるか、name/gender/birth_date を指定できる必要があります)。
  • 医療、法律、投資など、高リスクな意思決定で専門的な意見が必要な場合、この skill が提供できるのは参考となる視点のみです。

1.2) コマンドラインでの実行方法(ローカルでのデバッグ/ファイル管理用)

skill のルートディレクトリで実行します。

npm i

推奨方法(コンパイル済み成果物):

npm run bazi -- --action inspect
npm run bazi -- --action inspect --slug xiao-a
npm run bazi -- --action delete --slug xiao-a

同等の方法(CLI を直接実行):

node dist/cli.js --action inspect

開発時のデバッグ(tsx が必要):

npx tsx src/cli.ts --action inspect

説明:

  • コマンドラインは主に、inspect/list/delete/help などのファイル管理操作に使用します。
  • 人格の作成、更新、チャット、流時分析、黄暦照会には、以下のツール+ワークフローを優先して使用してください。

2) ツールの説明(入力/出力)

2.1 bazi_chart_tool

用途:八字の命式作成+固定的な人格知識のマッピング(静的)。

入力パラメーター:

  • name string 必須
  • gender string 必須、male/female(男/女 にも対応)
  • birth_date string 必須、YYYY-MM-DD
  • birth_time string 任意、HH:mm
  • birth_location string 任意
  • calendar_type string 任意、solar/lunar、デフォルトは solar

結果の説明:

  • 完全な chart の結果を返します。以降、人格の生成、状態分析、命理の根拠の引用に使用します。
2.2 bazi_flow_tool

用途:動的な八字情報の照会(大運/流年/流月/流日/流時)。

入力パラメーター:

  • chart object 任意(本命の情報を直接渡します)
  • persona_slug string 任意(人格から本命の情報を読み込みます)
  • base_dir string 任意
  • at string 任意(例:今天/昨天/2026-04-12)
  • include_calendar boolean 任意、デフォルトは true
  • lang string 任意、zh/en/ja/ko

結果の説明:

  • 指定時点の動的な状態(現在の大運、段階的な変化、コミュニケーション/判断の変化)を返します。
  • 日付の黄暦情報(農暦、干支、節気、宜忌など)を含めることもできます。
2.3 persona_data_tool

用途:人格ファイルのデータ管理(List/Search/Create/Query/Patch(Update)/Delete)。

入力パラメーター:

  • action string 必須:list/search/create/query/patch/delete
  • base_dir string 任意
  • persona_slug string(query/patch/delete では必須)
  • search_query string(search では任意)
  • create_payload object(create では必須)
  • patch_payload object(patch では必須)

結果の説明:

  • 対応する操作の結果と最新の状態を返します。
  • query/patch の場合は、チャットへの注入や以降の更新に使用する人格ファイルの場所を返します。
2.4 memory_tool

用途:重要な記憶と知識の書き込み、更新、統合、照会。

入力パラメーター:

  • action string 必須:upsert/merge/delete/query
  • persona_slug string 必須
  • base_dir string 任意
  • memories array(upsert/merge では必須)
  • merge_policy string 任意:append/replace_same_key/higher_confidence_wins

結果の説明:

  • 書き込み/更新の概要(追加、更新、削除、競合)を返します。
  • 書き込み後に人格のスナップショットを更新し、以降のチャットや分析に使用できるようにします。
2.5 calendar_tool

用途:万年暦/黄暦の照会。

入力パラメーター:

  • at string 任意(デフォルトは今日)
  • lang string 任意

結果の説明:

  • 該当する日付のグレゴリオ暦、農暦、干支、節気、宜忌などの情報を返します。
2.6 chat_import_tool

用途:外部チャット履歴をインポートし、候補となる事実を抽出します。

入力パラメーター:

  • source_type string 必須:text/json/ocr_text
  • payload string または object 必須
  • persona_slug string 任意
  • timezone string 任意、デフォルトは Asia/Shanghai
  • max_candidates number 任意、デフォルトは 50

結果の説明:

  • 構造化されたチャット項目の候補と記憶項目の候補を返します。
  • AI がさらに選別した後、memory_tool と persona_data_tool.patch に渡します。

3) ワークフロー(ツールを連携して実行)

3.1 人格の作成

適用場面:ユーザーが特定の人格を初めて作成する場合。

  1. 基本情報を抽出します。name/gender/birth_date は必須です。birth_time/birth_location/relationship は任意です。
  2. bazi_chart_tool を呼び出して chart を取得します。
  3. chart + relationship + initial_facts に基づいて profile/snapshot を生成します。
  4. persona_data_tool(action=create) を呼び出して人格ファイルに書き込みます。
  5. 追加の事実がある場合は、memory_tool(action=upsert) を呼び出して重要な記憶を書き込みます。
  6. 作成完了を伝え、チャットを始めるよう案内します。

重要な判断:

  • name/gender/birth_date のいずれかが不足している場合は、まず必要最小限の質問をします。
  • 同名の人格が存在する場合は、上書きするか新しい slug を作成するかを先に確認します。
3.2 人格の更新

適用場面:新たな変化を追加する場合、以前の情報を訂正する場合、関係性の手掛かりを補足する場合。

  1. persona_data_tool(search/query) を使用して対象の人格を特定します。
  2. 入力から追加の事実と訂正情報を抽出します。
  3. memory_tool(upsert/merge) を使用して記憶を書き込みます。
  4. persona_data_tool(patch) を使用して snapshot と必要な profile の項目を更新します。
  5. 更新の概要を返します。
3.3 通常モードでのチャット

適用場面:ユーザーが特定の人格に直接話しかける場合。

  1. コンテキストに現在の人格(current_persona_slug)があるかどうかを確認します。
  2. 人格が特定されており、対象の切り替えもない場合は、persona_data_tool(query) を直接呼び出します。search は繰り返しません。
  3. コンテキストがない場合、またはユーザーが明示的に対象を切り替える場合は、まず search を実行してから query を実行します。
  4. 基本チャットプロンプト(chat_base)と persona.md を注入します。
  5. 返信を生成します。記憶として残す必要がある場合は、memory_tool と persona_data_tool.patch を呼び出します。

重要な判断:

  • 複数の人格が該当する場合は、推測せずに先に確認します。
  • 通常モードでは自然な会話を優先し、命理用語を積極的に展開しません。
3.4 人格の起動時注入(オプション)

適用場面:ユーザーが明示的に「この persona に合わせてチャットを起動する」または「SOUL.md/agent の起動コンテキストに書き込む」よう求める場合。

  1. まず 3.3 に従って対象の persona を特定します。
  2. その persona 専用の起動プロンプトを生成し、現在のセッションコンテキストに注入します。
  3. 注入は対象の persona にのみ適用し、他の persona には影響させません。
3.5 作弊模式聊天(命理增强)

适用场景:用户说“打开作弊模式”“从八字看”“按命理分析一下”等。

  1. 先按 3.3 定位人格并注入普通模式基础内容。
  2. 再叠加作弊模式提示词(cheat_mode)。
  3. 按需注入 bazi_data.json。
  4. 涉及时间点时调 bazi_flow_tool,需要日期细节时补 calendar_tool。
  5. 输出保持人格口吻,同时给出可解释依据。
  6. 用户关闭作弊模式时,回到普通模式。
3.6 动态流时分析

适用场景:用户问“今天状态”“这周为什么变了”“某天推进是否合适”。

  1. persona_data_tool(query) 读取目标人格。
  2. bazi_flow_tool 传 persona_slug/chart + at。
  3. 必要时补 calendar_tool。
  4. 输出结论 + 依据 + 节奏建议。
3.7 黄历/万年历查询

适用场景:只查日期信息,不涉及人格。

  1. 调 calendar_tool(at 可空,空则今天)。
  2. 返回农历、干支、节气、宜忌。
3.8 外部聊天导入

适用场景:用户上传微信聊天记录、聊天截图文本或其他历史对话。

  1. chat_import_tool 提取候选信息。
  2. AI 筛选高价值候选。
  3. memory_tool 写关键记忆。
  4. persona_data_tool.patch 刷新 snapshot。
  5. 返回导入摘要(写入/跳过/冲突)。

4) 人设目录(代码默认)

默认目录:<当前 skill 根目录>/personas

每个人格目录:

  • personas/<slug>/persona.md:人设成品(聊天主注入文件)
  • personas/<slug>/bazi_data.json:八字结构化数据
  • personas/<slug>/memory.json:结构化记忆数据
  • personas/<slug>/history.json:结构化历史会话/导入记录

覆盖优先级:

  1. 显式 base-dir
  2. 环境变量 BAZI_PERSONA_HOME
  3. 默认 <skill-root>/personas

5) 质量标准

高质量八字人格至少满足:

  1. 像一个人,不像模板标签。
  2. 创建后能立刻开始聊天。
  3. 更新后能自然吸收现实变化。
  4. 普通模式与作弊模式切换自然,不互相污染。
  5. 关键判断能回到八字证据与现实信息。

コメント