SKILL: Soul Forge — 家庭数字人格提炼

这个 skill 把一份家庭群聊记录变成可用于 AI agent 的人格文件。 基于数字民族志方法论：用 AI 完成「田野调查」→「人格合成」的完整流程。

触发条件

以下情况触发此 skill：

• 用户说"帮我分析聊天记录"、"生成 soul 文件"、"提炼家庭人格"
• 用户提供了 .json 聊天导出文件
• 用户说"运行 soul-forge"、"开始人格提炼"
• 用户问"怎么用聊天记录生成 persona"

执行流程

第一步：确认输入

询问用户：

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

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

第二步：后台运行 pipeline

调用：

python3 {SKILL_DIR}/scripts/run_forge.py --file {用户提供的文件路径}

四个阶段，agent 依次推进：

阶段3说明：使用 Batches 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 agent SOUL.md 使用
├── persona_dad.md   ← 爸爸个人人格
├── persona_mom.md   ← 妈妈个人人格
└── persona_child.md ← 孩子/子女人格

询问用户是否要：

• 将 soul.md 安装为当前 agent 的 SOUL.md
• 为每个 persona 创建独立 agent

进阶用法

只更新 soul，不重新生成 persona

告诉 agent：「soul-forge 只更新 soul，跳过 persona」

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

只重新生成 persona（soul 已存在）

告诉 agent：「soul-forge 只刷新 persona」

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

从中断处恢复

告诉 agent：「soul-forge 继续上次的任务」

内部：python3 run_forge.py --resume

查看当前进度

告诉 agent：「soul-forge 状态」

内部：python3 run_forge.py --status

支持的输入格式

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

成本估算

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

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

常见问题

Q: 阶段3 很慢怎么办？ A: Batches API 通常 10-30 分钟，这是正常的。agent 会持续轮询状态，不需要人工干预。

Q: 中途断了怎么办？ A: 说「soul-forge 继续」，脚本会从断点恢复，已完成的阶段不会重复执行。

Q: API key 在哪里设置？ A: export ANTHROPIC_API_KEY='sk-ant-...'，或在 OpenClaw 的环境变量设置里配置。

Q: 支持几个人的群聊？ A: 默认三人（dad/mom/child），可在 pipeline/config.py 修改角色配置。

方法论背景

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

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

Clifford Geertz：「浅描记录行为，厚描解释意义。」

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