# Agent Fission

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

- Skill: `klarkxy/agent-fission` (Agent Skill)
- Install (CLI): `npx skillmds@latest add klarkxy/agent-fission`
- Raw SKILL.md: https://api.skillmd.com/api/skills/klarkxy/agent-fission/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: klarkxy (https://skillmd.com/u/klarkxy)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/klarkxy/agent-fission

---


只有在用户真的想创建一个独立的 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 或本地文件路径
- 不要花太多时间追求完美匹配，要尽快给出选项，让用户自己决定
- 如果这些候选都不行，问用户要不要再来一轮，或者直接提供自己的图片
- 一旦用户选定图片，**裁剪由你自己处理**，不要让用户来做
- 优先使用简洁的头像或图标型头像，这样小尺寸下更易读，但仍要尊重用户偏好
