bazi-persona について
Bazi Persona は、生年月日、八字の知識、現実の事実をもとに会話用の人格を作成・更新するスキルです。人格との対話、時点別分析、暦の照会、チャットの取り込みに対応し、ファイル管理用 CLI も備えます。
主な機能
- 01出生情報から人格を作成
- 02プロフィールと重要な記憶を更新
- 03通常と八字分析付きの会話を切り替え
- 04大運や日付ごとの運勢を分析
- 05中国暦を照会
- 06チャットを取り込み候補事実を抽出
活用シーン
- 01誕生日から会話用人格を作成
- 02現実の変化を人格に反映
- 03指定時点の人格状態を分析
- 04過去のチャットから記憶を抽出
MCP 対応
ワークフローでは、命式作成、時点別の八字照会、人格・記憶管理、暦の検索、チャット取り込み用のツールを提供します。README には、これらのツールが MCP プロトコルを使うとの記載はありません。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ cantian-ai/ bazi-persona-skill --skill bazi-personaインストール後、Claude Code で/bazi-personaを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
.npmignoreLICENSE.gitignoreREADME.en.mdREADME.zh-TW.mdREADME.ko.mdREADME.mdREADME.ja.mdpackage.jsonpackage-lock.json.github/workflows/openclaw-package.ymlpublish.ymlopenclaw/README.mdprompts/chat_base.mdcheat_mode.mdcreate_persona.mdcompat_guidance.mdknowledge.mdmanifest.jsonmemory_builder.mdrelease/openclaw/bazi-persona/README.mdpackage.jsonrelease/openclaw/bazi-persona/prompts/compat_guidance.mdcreate_persona.mdmanifest.jsonknowledge.mdmemory_builder.mdscripts/build-openclaw-release.shsrc/index.tssrc/kernel/intent.ts詳細
八字人格 Bazi Persona
チャット履歴は不要です。誕生日だけで人格を生成できます。
八字人格は、八字の命式、命理の知識、現実の事実を組み合わせた人格システムです。
目標は「ラベルのレポート」を生成することではなく、継続的に対話し、更新し、分析の視点を切り替えられる人格を完成させることです。
デフォルトではユーザーの現在の入力言語に合わせます。言語が明確でない場合は、まず中国語を使用します。
1) この Skill でできること
この skill は、次の 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
用途:八字の命式作成+固定的な人格知識のマッピング(静的)。
入力パラメーター:
namestring 必須genderstring 必須、male/female(男/女にも対応)birth_datestring 必須、YYYY-MM-DDbirth_timestring 任意、HH:mmbirth_locationstring 任意calendar_typestring 任意、solar/lunar、デフォルトはsolar
結果の説明:
- 完全な
chartの結果を返します。以降、人格の生成、状態分析、命理の根拠の引用に使用します。
2.2 bazi_flow_tool
用途:動的な八字情報の照会(大運/流年/流月/流日/流時)。
入力パラメーター:
chartobject 任意(本命の情報を直接渡します)persona_slugstring 任意(人格から本命の情報を読み込みます)base_dirstring 任意atstring 任意(例:今天/昨天/2026-04-12)include_calendarboolean 任意、デフォルトはtruelangstring 任意、zh/en/ja/ko
結果の説明:
- 指定時点の動的な状態(現在の大運、段階的な変化、コミュニケーション/判断の変化)を返します。
- 日付の黄暦情報(農暦、干支、節気、宜忌など)を含めることもできます。
2.3 persona_data_tool
用途:人格ファイルのデータ管理(List/Search/Create/Query/Patch(Update)/Delete)。
入力パラメーター:
actionstring 必須:list/search/create/query/patch/deletebase_dirstring 任意persona_slugstring(query/patch/deleteでは必須)search_querystring(searchでは任意)create_payloadobject(createでは必須)patch_payloadobject(patchでは必須)
結果の説明:
- 対応する操作の結果と最新の状態を返します。
query/patchの場合は、チャットへの注入や以降の更新に使用する人格ファイルの場所を返します。
2.4 memory_tool
用途:重要な記憶と知識の書き込み、更新、統合、照会。
入力パラメーター:
actionstring 必須:upsert/merge/delete/querypersona_slugstring 必須base_dirstring 任意memoriesarray(upsert/mergeでは必須)merge_policystring 任意:append/replace_same_key/higher_confidence_wins
結果の説明:
- 書き込み/更新の概要(追加、更新、削除、競合)を返します。
- 書き込み後に人格のスナップショットを更新し、以降のチャットや分析に使用できるようにします。
2.5 calendar_tool
用途:万年暦/黄暦の照会。
入力パラメーター:
atstring 任意(デフォルトは今日)langstring 任意
結果の説明:
- 該当する日付のグレゴリオ暦、農暦、干支、節気、宜忌などの情報を返します。
2.6 chat_import_tool
用途:外部チャット履歴をインポートし、候補となる事実を抽出します。
入力パラメーター:
source_typestring 必須:text/json/ocr_textpayloadstring または object 必須persona_slugstring 任意timezonestring 任意、デフォルトはAsia/Shanghaimax_candidatesnumber 任意、デフォルトは50
結果の説明:
- 構造化されたチャット項目の候補と記憶項目の候補を返します。
- AI がさらに選別した後、
memory_toolとpersona_data_tool.patchに渡します。
3) ワークフロー(ツールを連携して実行)
3.1 人格の作成
適用場面:ユーザーが特定の人格を初めて作成する場合。
- 基本情報を抽出します。
name/gender/birth_dateは必須です。birth_time/birth_location/relationshipは任意です。 bazi_chart_toolを呼び出してchartを取得します。chart + relationship + initial_factsに基づいてprofile/snapshotを生成します。persona_data_tool(action=create)を呼び出して人格ファイルに書き込みます。- 追加の事実がある場合は、
memory_tool(action=upsert)を呼び出して重要な記憶を書き込みます。 - 作成完了を伝え、チャットを始めるよう案内します。
重要な判断:
name/gender/birth_dateのいずれかが不足している場合は、まず必要最小限の質問をします。- 同名の人格が存在する場合は、上書きするか新しい slug を作成するかを先に確認します。
3.2 人格の更新
適用場面:新たな変化を追加する場合、以前の情報を訂正する場合、関係性の手掛かりを補足する場合。
persona_data_tool(search/query)を使用して対象の人格を特定します。- 入力から追加の事実と訂正情報を抽出します。
memory_tool(upsert/merge)を使用して記憶を書き込みます。persona_data_tool(patch)を使用して snapshot と必要な profile の項目を更新します。- 更新の概要を返します。
3.3 通常モードでのチャット
適用場面:ユーザーが特定の人格に直接話しかける場合。
- コンテキストに現在の人格(
current_persona_slug)があるかどうかを確認します。 - 人格が特定されており、対象の切り替えもない場合は、
persona_data_tool(query)を直接呼び出します。searchは繰り返しません。 - コンテキストがない場合、またはユーザーが明示的に対象を切り替える場合は、まず
searchを実行してからqueryを実行します。 - 基本チャットプロンプト(
chat_base)とpersona.mdを注入します。 - 返信を生成します。記憶として残す必要がある場合は、
memory_toolとpersona_data_tool.patchを呼び出します。
重要な判断:
- 複数の人格が該当する場合は、推測せずに先に確認します。
- 通常モードでは自然な会話を優先し、命理用語を積極的に展開しません。
3.4 人格の起動時注入(オプション)
適用場面:ユーザーが明示的に「この persona に合わせてチャットを起動する」または「SOUL.md/agent の起動コンテキストに書き込む」よう求める場合。
- まず 3.3 に従って対象の persona を特定します。
- その persona 専用の起動プロンプトを生成し、現在のセッションコンテキストに注入します。
- 注入は対象の persona にのみ適用し、他の persona には影響させません。
3.5 作弊模式聊天(命理增强)
适用场景:用户说“打开作弊模式”“从八字看”“按命理分析一下”等。
- 先按 3.3 定位人格并注入普通模式基础内容。
- 再叠加作弊模式提示词(
cheat_mode)。 - 按需注入
bazi_data.json。 - 涉及时间点时调
bazi_flow_tool,需要日期细节时补calendar_tool。 - 输出保持人格口吻,同时给出可解释依据。
- 用户关闭作弊模式时,回到普通模式。
3.6 动态流时分析
适用场景:用户问“今天状态”“这周为什么变了”“某天推进是否合适”。
persona_data_tool(query)读取目标人格。bazi_flow_tool传persona_slug/chart + at。- 必要时补
calendar_tool。 - 输出结论 + 依据 + 节奏建议。
3.7 黄历/万年历查询
适用场景:只查日期信息,不涉及人格。
- 调
calendar_tool(at可空,空则今天)。 - 返回农历、干支、节气、宜忌。
3.8 外部聊天导入
适用场景:用户上传微信聊天记录、聊天截图文本或其他历史对话。
chat_import_tool提取候选信息。- AI 筛选高价值候选。
memory_tool写关键记忆。persona_data_tool.patch刷新 snapshot。- 返回导入摘要(写入/跳过/冲突)。
4) 人设目录(代码默认)
默认目录:<当前 skill 根目录>/personas
每个人格目录:
personas/<slug>/persona.md:人设成品(聊天主注入文件)personas/<slug>/bazi_data.json:八字结构化数据personas/<slug>/memory.json:结构化记忆数据personas/<slug>/history.json:结构化历史会话/导入记录
覆盖优先级:
- 显式
base-dir - 环境变量
BAZI_PERSONA_HOME - 默认
<skill-root>/personas
5) 质量标准
高质量八字人格至少满足:
- 像一个人,不像模板标签。
- 创建后能立刻开始聊天。
- 更新后能自然吸收现实变化。
- 普通模式与作弊模式切换自然,不互相污染。
- 关键判断能回到八字证据与现实信息。