agent-fission

name	agent-fission
description	当用户明确想使用 agent-fission_split_agent 工具创建一个拥有独立身份、灵魂、头像或初始技能的全新持久 Hanako 代理时使用。新技能安装后需要判断是否扩散到多个代理时，接入技能路由流程。

只有在用户真的想创建一个独立的 Hanako 代理时才启用此技能，这种代理会在对话结束后继续存在。

如果请求属于下面这些情况，就不要使用此技能：

• 临时的运行时搭档
• 一次性的独立子代理运行
• 应该始终依附当前代理的后台任务

角色自动补充流程：

当用户只提供角色名或人名，而没有提供完整身份和 ishiki 内容时：

1. 使用 web_search 收集该角色的背景信息、性格特征和设定
2. 起草一份初步的 identity.md 和 ishiki.md，然后交给用户审阅
3. 在调用工具之前，先让用户确认或提出修改意见

当用户已经提供完整描述时，尊重其原文，直接调用工具。

当角色设定很丰富，且用户希望完整呈现时，使用 contentMode=replace，不要被 overlay 模式里的“简洁”建议限制住。

调用工具前，先准备好以下内容：

• name：新代理的显示名称
• 可选 id：稳定的 Hanako 代理 ID
• 可选 yuan：hanako、butter、ming、kong 之一
• identity：代理的身份内容；overlay 模式保持简洁，replace 模式允许完全控制
• ishiki：代理的 ishiki 内容；overlay / replace 的逻辑相同
• 可选 publicIshiki：需要时提供面向公众的内容
• 可选 contentMode：传 replace 表示写入完整重写结果（角色创建默认走这个）；传 overlay 仅用于小补丁。工具默认是 replace。
• 可选 avatarUrl：可访问的 http/https png/jpg/webp 图片 URL；头像流程见下方
• 可选 avatarDataUrl：只在你已经拿到图片字节时使用
• 可选 enabledSkills：新代理创建后要追加的初始技能；默认技能保留，只追加这些技能

默认元选择与改写流程（重点）：

当用户要“新角色”而不是“给现有角色打补丁”时，必须遵循下面流程：

1. 在 hanako、butter、ming、kong 四个元里，先选一个最贴近角色气质的 yuan。
2. 把该 yuan 的默认 identity/ishiki 当作底稿，不要把用户设定直接拼接到末尾。
3. 对底稿做“按段改写”：保留结构骨架，替换不匹配的人设段落，删掉重复表述，合并同义约束。
4. 产出最终完整版 identity 与 ishiki，然后用 contentMode=replace 调用工具写入。

overlay 只用于“轻量补充”：

• 仅当用户明确说“在现有模板上加一小段”时才使用。
• 内容应是短补丁（例如几条新增约束），不能是完整人设稿。
• 若输入已经是完整角色设定，禁止用 overlay 末尾拼接，改走上面的“选元+改写+replace”。

黄金规则：

• 只有主代理可以创建另一个持久代理
• 这个工具生成的是普通 Hanako 代理，不是运行时子代理
• 新角色创建默认使用 contentMode=replace，先选 yuan 再改写默认稿
• overlay 只做小补丁，不用于完整角色落地
• 在 replace 结果里，避免语义重复、段落重复、同义规则多次出现
• 需要 overlay 时显式传入 contentMode: "overlay"
• 同人角色、OC 人设和文学角色代理都可以做——按用户想要的语气来构建

技能感知的创建与分发：

• 当新代理一开始就需要某些通用能力时，把技能名通过 enabledSkills 传进去；这样只会追加技能，不会移除默认技能。
• 当一个新技能刚安装完，需要判断它要不要扩到多个持久代理时，先切到 agent-fission-skill-router，再用 agent-fission_sync_agent_skills 做预览和分发。
• 私有自学技能不要默认扩散到所有代理；只有在它确实是共享能力，或者用户明确要求时才分发。

头像流程：

• 当用户想要头像但还没提供时，按下面的优先级找候选图：
  1. 先用 web search —— 到合适的图片来源里搜索候选 URL，例如动漫插画站、角色图库等
  2. image-gen 兜底 —— 如果网页搜索没有拿到可用图片，就生成 4~6 个候选头像
  3. 再问用户 —— 如果前两步都失败，就请用户提供图片 URL 或本地文件路径
• 不要花太多时间追求完美匹配，要尽快给出选项，让用户自己决定
• 如果这些候选都不行，问用户要不要再来一轮，或者直接提供自己的图片
• 一旦用户选定图片，裁剪由你自己处理，不要让用户来做
• 优先使用简洁的头像或图标型头像，这样小尺寸下更易读，但仍要尊重用户偏好