技能：灵魂熔炉 — 家庭数字人格提炼

该技能将家庭群聊记录转化为可用于AI代理的人格文件。
基于数字民族志方法论：利用AI完成从田野调查到人格合成的完整流程。

触发条件

以下情况将触发此技能：

• - 用户说帮我分析聊天记录、生成灵魂文件、提炼家庭人格
• 用户提供了.json聊天导出文件
• 用户说运行灵魂熔炉、开始人格提炼
• 用户问如何用聊天记录生成人格档案

执行流程

第一步：确认输入

询问用户：

1. 1. 聊天记录文件路径（支持微信WeFlow导出的JSON格式）
2. 输出目录（默认：~/soul-forge-output/）
3. 家庭成员角色配置（默认：爸爸/妈妈/孩子三人结构）

确认ANTHROPICAPIKEY已设置（需调用Claude API）。

第二步：后台运行流水线

调用：
bash
python3 {SKILLDIR}/scripts/runforge.py --file {用户提供的文件路径}

四个阶段，代理依次推进：

阶段3说明：使用批处理API异步处理，成本低，自动缓存进度。
如被中断可用--resume恢复，不重复计费。

第三步：进度汇报

解析run_forge.py的标记输出：

• - [STAGE:N:START] → 告知用户正在进行阶段N
• [STAGE:N:DONE] → 告知用户阶段N完成
• [PROGRESS:N/M] → 展示进度条
• [OUTPUT:path] → 列出生成的文件
• [ERROR:msg] → 报告错误，建议用户如何处理
• [DONE] → 宣布完成，展示所有输出文件

第四步：完成后

输出文件说明：

soul-forge-output/
├── soul.md ← 集体人格，可直接作为AI代理的灵魂.md使用
├── persona_dad.md ← 爸爸个人人格
├── persona_mom.md ← 妈妈个人人格
└── persona_child.md ← 孩子/子女人格

询问用户是否要：

• - 将soul.md安装为当前代理的灵魂.md
• 为每个人格档案创建独立代理

进阶用法

仅更新灵魂，不重新生成人格档案

告诉代理：「灵魂熔炉只更新灵魂，跳过人格档案」

内部：python3 run_forge.py --file {path} --soul-only

仅重新生成人格档案（灵魂已存在）

告诉代理：「灵魂熔炉只刷新人格档案」

内部：python3 run_forge.py --file {path} --persona-only

从中断处恢复

告诉代理：「灵魂熔炉继续上次的任务」

内部：python3 run_forge.py --resume

查看当前进度

告诉代理：「灵魂熔炉状态」

内部：python3 run_forge.py --status

支持的输入格式

微信导出方法：使用WeFlow（Mac）→ 选择群聊 → 导出JSON格式。

成本估算

一份2-3年的家庭群聊（约500块对话）：

• - 阶段3（Haiku批处理）：约$0.5-1.0
• 阶段4（Opus）：约$2-5
• 合计约$3-6，一次性

常见问题

问：阶段3很慢怎么办？
答：批处理API通常需要10-30分钟，这是正常现象。代理会持续轮询状态，无需人工干预。

问：中途断了怎么办？
答：说灵魂熔炉继续，脚本会从断点恢复，已完成的阶段不会重复执行。

问：API密钥在哪里设置？
答：export ANTHROPICAPIKEY=sk-ant-...，或在OpenClaw的环境变量设置中配置。

问：支持几个人的群聊？
答：默认三人（爸爸/妈妈/孩子），可在pipeline/config.py中修改角色配置。

方法论背景

基于数字民族志（Digital Ethnography）：

• - 阶段1-2：田野记录整理（去噪、结构化）
• 阶段3：系统性观察（Haiku提取五维度行为模式）
• 阶段4：民族志分析（Opus综合厚描）

克利福德·格尔茨：浅描记录行为，厚描解释意义。

soul.md是厚描的产物——不是行为清单，而是理解这个家庭需要什么样的解释框架。