- name
- zaomeng-skill
- description
- 面向中文小说人物蒸馏、关系抽取、关系图谱和角色对话的 ClawHub skill
zaomeng-skill
| 项目 | 内容 |
|---|---|
| 名称 | zaomeng-skill |
| 版本 | 4.1.4 |
| 类型 | ClawHub / Host-managed skill |
| 核心模式 | LLM-first |
| 适用场景 | 人物蒸馏、人物包物化、关系图谱导出、角色 act / insert / observe |
| 宿主职责 | 调用宿主 LLM,负责最终生成与对话推进 |
| skill 职责 | 准备 prompt payload、物化人物包、导出图谱、校验产物、维护运行状态 |
1. 定位
- 这是一个宿主驱动的 prompt-first skill。
- 宿主负责实际调用 LLM;skill 负责把任务整理成标准输入、标准产物和标准状态。
- skill 的主路径是
prompts + helper tools + run_manifest.json,不是内嵌 chat CLI。
2. 宿主能力契约
宿主侧只需要理解四个标准能力:
| 能力 | 入口 | 作用 | 标准成功标记 |
|---|---|---|---|
distill | tools/build_prompt_payload.py --mode distill | 生成蒸馏 payload,等待宿主 LLM 产出 PROFILE.generated.md | capability status status=ready, success=true |
materialize | tools/materialize_persona_bundle.py | 把 PROFILE.generated.md 物化为完整人物包 | ARTIFACT_STATUS.generated.json + capability status |
export_graph | tools/export_relation_graph.py | 导出人物关系图谱 HTML / Mermaid / SVG | <relations>.status.json + capability status |
verify_workflow | tools/verify_host_workflow.py | 校验整条宿主工作流产物是否完整 | capability status status=complete, success=true |
所有能力都应该满足:
- 有明确输入
- 有 JSON 输出
- 有 sidecar status 文件
- 有
success布尔值 - 可选更新
run_manifest.json
能力总览集中定义在:
references/capability_index.mdexamples/host_workflow_example.md
distill 默认支持增量蒸馏:
- 如果
data/characters/<novel_id>/<角色名>/已存在人物包,tools/build_prompt_payload.py --mode distill会自动把已有档案并入request.existing_profiles request.update_mode会自动落成incrementalrun_manifest.json的artifacts.distill_context会记录本次是create还是incremental,以及命中的已有角色数量
3. 标准运行状态
宿主如果要跑完整蒸馏链路,先初始化一个 run_manifest.json:
py -3 tools/init_host_run.py --novel <路径> --characters A,B,C --output <run_manifest.json>run_manifest.json 是宿主侧的统一索引,记录:
- 当前阶段
- 已锁定角色
- 当前正在处理的角色
- 已完成数量
- 关系图导出状态
- 各能力 status 文件
- 人物目录
- 关系图 HTML / SVG / Mermaid 路径
- 最终 workflow 校验结果
- 增量蒸馏上下文(
update_mode、已有档案数量、已有档案目录)
4. 标准进度阶段
宿主侧统一使用这些阶段名:
characters_lockeddistill_payload_readyrelation_payload_readycharacter_startedcharacter_completedgraph_export_startedgraph_export_completedworkflow_verified
如果宿主要主动播报当前角色和进度,直接调用:
py -3 tools/update_run_progress.py --run-manifest <run_manifest.json> --stage character_started --character 林黛玉 --message "正在蒸馏林黛玉"5. 标准流程
- 初始化
run_manifest.json - 运行
distill能力,生成蒸馏 payload - 宿主 LLM 为每个角色生成
PROFILE.generated.md - 每个角色生成后立刻运行
materialize - 宿主 LLM 生成关系结果后运行
export_graph - 运行
verify_workflow - 宿主向用户展示:
- 人物目录 - 关系图 HTML / SVG - 状态摘要 - 可进入 act / insert / observe
6. 推荐宿主串联方式
A. 初始化运行
py -3 tools/init_host_run.py --novel <路径> --characters A,B --output <run_manifest.json>B. 准备 distill payload
py -3 tools/build_prompt_payload.py --mode distill --novel <路径> --characters A,B --output <distill_payload.json> --run-manifest <run_manifest.json>如果宿主要显式指定已有角色目录,或强制切换创建 / 增量模式,可加:
py -3 tools/build_prompt_payload.py --mode distill --novel <路径> --characters A,B --characters-root <data/characters 或 data/characters/<novel_id>> --update-mode auto|create|incremental --output <distill_payload.json> --run-manifest <run_manifest.json>C. 角色开始 / 完成进度
py -3 tools/update_run_progress.py --run-manifest <run_manifest.json> --stage character_started --character A
py -3 tools/update_run_progress.py --run-manifest <run_manifest.json> --stage character_completed --character AD. 物化人物包
py -3 tools/materialize_persona_bundle.py --profile-file <character-dir/PROFILE.generated.md> --run-manifest <run_manifest.json>E. 导出关系图谱
py -3 tools/export_relation_graph.py --relations-file <relations.md> --run-manifest <run_manifest.json>F. 校验工作流
py -3 tools/verify_host_workflow.py --characters-root <characters/<novel_id>> --relations-file <relations.md> --run-manifest <run_manifest.json>7. 最终产物
完整 run 结束后,宿主应该直接拿到:
run_manifest.json- 每个角色的人物目录
- distill 增量上下文:
- artifacts.distill_context.update_mode - artifacts.distill_context.existing_character_count - artifacts.distill_context.existing_profile_paths
- 每个角色的
ARTIFACT_STATUS.generated.json - 关系图:
- *_relations.html - *_relations.svg - *_relations.mermaid.md - *.status.json
- workflow 校验 JSON
8. 对话接管
当人物包和关系图准备完成后,宿主即可进入:
act:指定角色代入发言,既可单聊,也可直接参与多人群聊insert:用户以“自己”的身份进入小说场景,角色按人设与场景身份回应用户;首次进入应建立轻量身份卡observe:进入群聊模式,但用户不代入具体角色,只观察多角色对话推进
这里的对话由宿主直接驱动,skill 不提供单独的 chat CLI 能力。宿主应直接使用:
- 人物包目录
PROFILE.md/ 拆分人格文件 /MEMORY.md- 关系图谱及关系 markdown
run_manifest.jsonreferences/output_schema.md、references/style_differ.md、references/logic_constraint.md
宿主结束提示建议直接说清楚:
- 人物档案已完成
- 关系图谱已生成
- 可以查看图谱
- 可以进入
act - 可以进入
insert - 可以进入
observe