zaomeng-skill（枣蒙技艺）

zaomeng-skill

1. 定位

• 这是一个宿主驱动的 prompt-first skill。
• 宿主负责实际调用 LLM；skill 负责把任务整理成标准输入、标准产物和标准状态。
• skill 的主路径是 prompts + helper tools + run_manifest.json，不是内嵌 chat CLI。

2. 宿主能力契约

宿主侧只需要理解四个标准能力：

所有能力都应该满足：

• 有明确输入
• 有 JSON 输出
• 有 sidecar status 文件
• 有 success 布尔值
• 可选更新 run_manifest.json

能力总览集中定义在：

• references/capability_index.md
• examples/host_workflow_example.md

distill 默认支持增量蒸馏：

• 如果 data/characters/<novel_id>/<角色名>/ 已存在人物包，tools/build_prompt_payload.py --mode distill 会自动把已有档案并入 request.existing_profiles
• request.update_mode 会自动落成 incremental
• run_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_locked
• distill_payload_ready
• relation_payload_ready
• character_started
• character_completed
• graph_export_started
• graph_export_completed
• workflow_verified

如果宿主要主动播报当前角色和进度，直接调用：

py -3 tools/update_run_progress.py --run-manifest <run_manifest.json> --stage character_started --character 林黛玉 --message "正在蒸馏林黛玉"

5. 标准流程

1. 初始化 run_manifest.json
2. 运行 distill 能力，生成蒸馏 payload
3. 宿主 LLM 为每个角色生成 PROFILE.generated.md
4. 每个角色生成后立刻运行 materialize
5. 宿主 LLM 生成关系结果后运行 export_graph
6. 运行 verify_workflow
7. 宿主向用户展示：

- 人物目录 - 关系图 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 A

D. 物化人物包

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.json
• references/output_schema.md、references/style_differ.md、references/logic_constraint.md

宿主结束提示建议直接说清楚：

• 人物档案已完成
• 关系图谱已生成
• 可以查看图谱
• 可以进入 act
• 可以进入 insert
• 可以进入 observe