| name | summon |
| description | 任何角色，即刻生成可对话的 Persona Skill。
输入角色名（小说人物、游戏角色、动漫人物、影视角色），自动调研或接受用户材料，
提炼性格、台词风格、价值观、世界观，生成两种可用 Skill：
沉浸模式（角色扮演，不出戏）和视角模式（用角色思维框架分析真实问题）。
触发词：「/summon 角色名」「帮我生成XX的skill」「我想和XX对话」「创建XX角色」
「我想要生成XX」「XX里的男主/女主/反派」「帮我做一个XX的角色」「生成XX角色」
「/summon list」列出已有角色，「/summon add <slug>」追加材料，「/summon update <slug>」更新角色
|
| argument-hint | <角色名> | list | add <slug> | update <slug> |
| user-invocable | true |
| allowed-tools | ["Read","Write","Edit","Bash","WebSearch","WebFetch","Agent"] |
Skill Everyone · 万物皆可角色
任何你能叫出名字的角色，都可以在这里活起来。
退出 / 取消
用户在任意阶段说「取消」「算了」「退出」「cancel」「stop」→ 立即停止当前流程，回复：
已取消。已生成的文件保留在 $SKILL_DIR/characters/<slug>/（如有），可随时用 /summon update <slug> 继续。
如果什么都没生成，直接忽略即可。
之后恢复正常对话模式，不再执行 summon 的任何步骤。
语言规则
根据用户第一条消息的语言，全程使用同一语言。用中文触发就全程中文，用英文触发就全程英文。
路径约定
何时激活哪个流程
收到用户输入后，先判断路径：
| 输入形式 | 路径 |
|---|
/summon <角色名> 或 帮我生成XX 或 创建XX | → 主流程：生成新角色 |
/summon list 或 列出角色 | → 列出已有角色 |
/summon add <slug> 或 给XX追加材料 | → 追加材料流程 |
/summon update <slug> 或 更新XX | → 增量更新流程 |
工具检查（首次使用时执行）
触发时机：用户首次触发 /summon 时，在进入 Phase 0 前检查一次。
YTDLP_OK=false; SCRAPLING_OK=false; JQ_OK=false
command -v yt-dlp &>/dev/null || [ -f ~/.local/bin/yt-dlp ] && YTDLP_OK=true
python3 -c "import scrapling" &>/dev/null && SCRAPLING_OK=true
command -v jq &>/dev/null && JQ_OK=true
echo "yt-dlp=$YTDLP_OK scrapling=$SCRAPLING_OK jq=$JQ_OK"
只提示缺失的工具（已安装的不提），展示后直接继续，不等待用户：
─── 调研工具检查 ─────────────────────────────────────
[缺 yt-dlp 时显示]
⚠ yt-dlp 未安装 — 无法提取 B站/YouTube 视频字幕
安装命令：curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp \
-o ~/.local/bin/yt-dlp && chmod +x ~/.local/bin/yt-dlp
[缺 scrapling 时显示]
⚠ scrapling 未安装 — 无法绕过 Fandom 等网站的反爬
安装命令：pip install scrapling[all]
[缺 jq 时显示]
⚠ jq 未安装 — JSON 处理能力受限
安装命令：sudo apt install jq 或 brew install jq
─────────────────────────────────────────────────────
缺少工具会降低调研质量，但不阻止继续。
如果全部工具已安装：静默通过，不展示任何提示。
主流程：生成新角色
Phase 0：信息采集
读取 $SKILL_DIR/prompts/intake.md，执行信息采集。
最多 3 轮问答，收集：
- 角色名 + 所属作品（如果用户没说清楚）
- 版本确认（如有多版本）
- 想要的模式（沉浸 / 视角 / 两个都要）
- 材料来源选择
模式和材料来源一起展示，末尾带回复格式示例（读取 intake.md 中的模板，严格按格式输出，不省略任何选项）：
想要什么形式的 Skill？
[A] 沉浸对话 [B] 思维视角 [C] 两个都要
材料怎么来？
[1] 自动调研 [2] 我来提供文字 [3] 我来上传图片
[4] 先自动调研再手工补充 [5] 我来定义原创人设
回复两个选项即可，例如：「A, 2」= 沉浸对话 + 我来提供文字
重复检测：生成 slug 后，检查是否已有同名角色（详见 intake.md "重复角色检测"节）：
- 检查
$SKILL_DIR/characters/<slug>/meta.json 和 $SKILLS_BASE/<slug>/SKILL.md
- 如有重复，提示用户选择：重新生成 / 追加材料 / 更新设定 / 取消
- 用户确认后才继续
用户选完后立即创建目录，不再等待：
mkdir -p $SKILL_DIR/characters/<slug>/references/auto
mkdir -p $SKILL_DIR/characters/<slug>/references/auto/source
mkdir -p $SKILL_DIR/characters/<slug>/references/manual/text
mkdir -p $SKILL_DIR/characters/<slug>/references/manual/images
mkdir -p $SKILL_DIR/characters/<slug>/references/manual/source
Phase 1：材料收集
根据用户选择的路径执行。
路径 1 / 路径 4 的自动调研
读取 $SKILL_DIR/prompts/research_auto.md。
静默执行工具扫描（不展示、不等待、不阻断）：
- 扫描已安装的辅助 skill（gemini-video, agent-reach, pdf 等）
- 检查本机工具（yt-dlp, scrapling, jq, ffmpeg）
- 根据结果自动调整调研策略
告知用户开始调研，然后启动并行调研：
正在调研 [角色名]（[作品名]）...
三路并行搜索中，大约需要 2-5 分钟。
- Agent A（基础档案）：wiki / fandom 主页面，角色简介、背景、关系
- Agent B（台词与行为）：台词数据库、剧情摘要、具体场景描述
- Agent C（社区解读）：玩家/读者/观众的分析文章、人物解读、争议讨论
每个 Agent 完成后立即展示单行进度（不等全部完成）：
✓ 档案 — 找到 X 条基础信息
✓ 台词 — 找到 X 条台词/场景（Agent B 完成后展示）
✓ 解读 — 找到 X 篇分析（Agent C 完成后展示）
每个 Agent 结果写入：
$SKILL_DIR/characters/<slug>/references/auto/wiki.md$SKILL_DIR/characters/<slug>/references/auto/quotes.md$SKILL_DIR/characters/<slug>/references/auto/analysis.md
三路全部完成后，展示汇总质量摘要：
─── 调研完成 ────────────────────────────
角色档案 ✓ 找到 X 条基础信息
台词/行为 ✓ 找到 X 条台词/场景记录
社区解读 ✓ 找到 X 篇分析
─────────────────────────────────────────
总计：约 X 条有效信息
如果是路径 4，询问：「是否需要补充材料？可以粘贴文字或上传图片（输入"不用了"继续）」
路径 2：手工文字
读取 $SKILL_DIR/prompts/research_manual_text.md，引导用户粘贴材料。
- 支持多段输入，用户输入「完成」结束
- 每段让用户说明来源（「第三章」「wiki 引用」「自己总结」等）
- 写入
references/manual/text/ 目录，按顺序命名 01.md、02.md...
路径 3：图片/截图
读取 $SKILL_DIR/prompts/research_manual_image.md，引导用户上传图片。
- 对每张图片：识别文字内容 + 视觉描述（外貌/界面/设定图）
- 文字内容写入
references/manual/images/img-<N>-text.md
- 视觉信息写入
references/manual/images/img-<N>-visual.md
路径 5：原创人设
读取 $SKILL_DIR/prompts/research_original.md，先询问用户输入方式，再收集人设材料。
- 不跑自动调研，所有内容来自用户
- 支持三种输入方式（可组合）：文字材料/文件路径、图片、问卷（分5批提问）
- 材料写入
$SKILL_DIR/characters/<slug>/references/manual/original/
meta.json 里标注 "source_type": "original"- 直接进入 Phase 2 提炼，跳过 Phase 1.5 合并
Phase 1.5：材料合并（路径 4 或同时有自动和手工时）
读取 $SKILL_DIR/prompts/research_merge.md，执行合并。
原则：
- 手工材料权重 > 自动调研（用户提供的视为更可信的一手来源）
- 矛盾时两者都保留，标注来源，不强制统一
- 合并结果写入
$SKILL_DIR/characters/<slug>/references/merged.md
Phase 2：提炼
读取 $SKILL_DIR/prompts/extractor.md，从所有材料中提炼：
- 性格核心（3-5 个关键特质，每个有台词/行为证据）
- 台词风格（句式、口头禅、语气、幽默方式、语言习惯）
- 价值观与反模式（绝对在意什么，绝对不会做什么）
- 世界观边界（角色所在世界的知识范围，什么不可能知道）
- 成长弧（角色在故事中的变化节点，默认用完整弧度）
- 内在矛盾（角色身上真实存在的张力，这是深度的来源）
提炼结果写入 $SKILL_DIR/characters/<slug>/persona.md 和 $SKILL_DIR/characters/<slug>/world.md。
展示提炼摘要，用户确认：
─── 提炼完成 ────────────────────────────
性格核心 X 个特质
台词风格 已提取
价值观 X 条
世界观边界 已确定
内在矛盾 X 处
继续生成 Skill？（回复"好的"或直接说有什么要调整的）
─────────────────────────────────────────
Phase 3：构建 Skill
根据用户在 Phase 0 选择的模式，执行对应 builder。
沉浸模式
读取 $SKILL_DIR/prompts/builder_roleplay.md + $SKILL_DIR/templates/skill-roleplay.md，
从 $SKILL_DIR/characters/<slug>/persona.md 和 world.md（Phase 2 已写好）读取提炼结果，
写入：$SKILLS_BASE/<slug>/SKILL.md（name: <slug>）
视角模式
读取 $SKILL_DIR/prompts/builder_perspective.md + $SKILL_DIR/templates/skill-perspective.md，
从 $SKILL_DIR/characters/<slug>/persona.md 和 world.md（Phase 2 已写好）读取提炼结果，
写入：$SKILLS_BASE/<slug>-perspective/SKILL.md（name: <slug>-perspective）
两个都要
依次执行两个 builder。
Phase 4：质量验证
⚠️ 此步骤强制执行，不能跳过，不能以"完成"代替。
读取 $SKILL_DIR/prompts/quality_check.md，在当前会话里直接执行测试，不是描述测试，是真的跑：
基础测试（必做）：
- 已知场景测试：用一个角色在原作中有明确反应的情境，以角色身份回应，看是否 in-character
- 世界边界测试：提出一个角色世界里不存在的概念，检查是否能 in-character 地处理，不突然变成 AI 口吻
- 风格测试：生成一段 100 字左右的回应，检查是否有角色辨识度
条件测试：
4. 认知一致性测试（有心理建模时）：假设场景测试依恋模式和核心图式
5. 决策框架测试（perspective 模式）：真实场景测试路由表和心智模型
展示格式（必须展示，不能省略）：
─── 质量验证结果 ────────────────────────────────
已知场景 ✓/△/✗ [一句话说明]
世界边界 ✓/△/✗ [一句话说明]
风格识别 ✓/△/✗ [一句话说明]
认知一致性 ✓/△/✗ [一句话说明] ← 有心理建模时
决策框架 ✓/△/✗ [一句话说明] ← perspective 模式时
─────────────────────────────────────────────────
通过标准：
- roleplay 模式：测试 1-4，至少 3 个 ✓ + 至多 1 个 △
- perspective 模式：测试 1-5，至少 4 个 ✓ + 至多 1 个 △
验证通过后，自动进入 Phase 5 精炼。如有 ✗，按 quality_check.md 的修复指引处理，修完重测。
完成步骤
Step 1：自动安装验证
生成完 SKILL.md 后，立即用 Bash 工具验证：
ls $SKILLS_BASE/<slug>/SKILL.md && echo "✓ 沉浸模式已安装" || echo "✗ 沉浸模式 SKILL.md 未找到，需要重新生成"
ls $SKILLS_BASE/<slug>-perspective/SKILL.md 2>/dev/null && echo "✓ 视角模式已安装" || true
注意：SKILL.md 是 Phase 3 里用 Write 工具直接写入 $SKILLS_BASE/<slug>/SKILL.md 的。
如果文件不存在，说明 Phase 3 写入失败，需重新执行对应 builder，不要从 characters/ 目录复制（那里没有 SKILL.md）。
Step 2：展示完成提示
─── ✓ <角色名>（<版本>）已生成并安装 ──────────────
沉浸对话：/<slug>
角色不出戏，直接以角色身份对话
思维视角：/<slug>-perspective（如已生成）
用角色的价值观和判断方式分析你的问题
追加材料：/summon add <slug>
更新角色：/summon update <slug>
查看所有角色：/summon list
─────────────────────────────────────────────────
列出已有角色：/summon list
扫描 $SKILL_DIR/characters/ 目录，读取每个 meta.json，同时检查 $SKILLS_BASE/<slug>/ 和 $SKILLS_BASE/<slug>-perspective/ 是否实际存在，展示安装状态：
ls $SKILLS_BASE/<slug>/SKILL.md 2>/dev/null && echo "roleplay:ok" || echo "roleplay:missing"
ls $SKILLS_BASE/<slug>-perspective/SKILL.md 2>/dev/null && echo "perspective:ok" || echo "perspective:missing"
展示格式（✓ 表示已安装，✗ 表示数据存在但 SKILL.md 缺失）：
─── 已生成的角色 ──────────────────────────────
1. 林黛玉 红楼梦原著 ✓ 沉浸 ✓ 视角 2026-04-06
2. Geralt 巫师3 ✓ 沉浸 ✗ 视角 2026-04-05 ← 视角未安装，用 /summon update geralt-witcher3 修复
3. Cloud Strife FF7重制版 ✓ 沉浸 ✓ 视角 2026-04-04
调用：/<slug> 或 /<slug>-perspective
──────────────────────────────────────────────
追加材料：/summon add <slug>
- 确认角色存在（读取
$SKILL_DIR/characters/<slug>/meta.json）
- 询问追加方式：
- [1] 文字（路径 2）
- [2] 图片（路径 3）
- [3] 补充原创人设定义（路径 5，仅原创角色
source_type == "original" 时显示）
- 按对应路径收集新材料，写入
$SKILL_DIR/characters/<slug>/references/manual/
- 重新执行 Phase 2（提炼），对比新旧 persona.md
- 如有矛盾，提示用户确认保留哪个版本
- 重新执行 Phase 3 对应 builder（
builder_roleplay.md / builder_perspective.md），覆盖写入已有的 SKILL.md
- 更新
meta.json 的 updated_at 和 material_sources
增量更新：/summon update <slug>
-
确认角色存在，读取 $SKILL_DIR/characters/<slug>/meta.json
-
检查当前已有哪些模式：
ls $SKILLS_BASE/<slug>/SKILL.md 2>/dev/null && echo "has_roleplay"
ls $SKILLS_BASE/<slug>-perspective/SKILL.md 2>/dev/null && echo "has_perspective"
-
根据检查结果动态构建选项菜单：
基础选项（始终显示）：
- [1] 重新自动调研（重跑三路调研，更新材料）← 原创角色（source_type == "original"）不显示此项
- [2] 追加材料（粘贴文字或上传图片）
- [3] 修改某个特质（局部调整性格/台词风格/价值观）
- [4] 仅修复安装路径
按已有模式动态添加：
- 只有沉浸模式 → 追加 [5] 补充生成视角模式
- 只有视角模式 → 追加 [5] 补充生成沉浸模式
- 两种都有 → 追加 [5] 重新生成沉浸模式 / [6] 重新生成视角模式
- 两种都没有（数据存在但 SKILL.md 丢失）→ 追加 [5] 重新安装全部
-
执行对应操作，只重跑受影响的 agent，不全量重做：
| 更新类型 | 重跑哪些 agent | 不重跑什么 |
|---|
| 有新台词/场景出现 | Agent B（台词/行为） | A、C |
| wiki 设定被补全 | Agent A（基础档案） | B、C |
| 社区出现新解读/争议 | Agent C（社区分析） | A、B |
| 全量更新（大版本更新） | A + B + C 全跑 | — |
Agent 完成后只更新对应的 references/auto/*.md，然后重新执行 Phase 2 提炼（增量合并，不覆盖未涉及的特质），再重跑 Phase 3 builder 和 Phase 5 精炼。
补充生成模式的执行逻辑（[5]/[6] 补充模式时）：
- 直接读取已有的
$SKILL_DIR/characters/<slug>/persona.md 和 world.md
- 不重跑调研，不重新提炼
- 执行对应 builder（
builder_roleplay.md 或 builder_perspective.md）
- 写入
$SKILLS_BASE/<slug>/ 或 $SKILLS_BASE/<slug>-perspective/
原创角色完成提示
当 meta.json 中 source_type == "original" 时，完成后额外展示：
原创角色「[角色名]」已生成。
作为创作参考，你可以问他/她：
- 「面对 [某个情节]，你会怎么做？」
- 「你怎么看待 [某个其他角色]？」
- 「如果你必须做一个你不愿意做的选择，你会怎么处理？」
想继续完善角色？/summon add <slug>
注意事项
- 材料不足时诚实说：找不到足够材料就明说，生成诚实标注了局限的 skill，不要编造特质
- 矛盾不要调和：角色身上的矛盾是深度来源，保留它
- 不强制出戏：沉浸模式里角色遇到世界边界问题，用 in-character 方式处理，不要突然变成 AI 口吻
- 版本要标清：同一角色不同版本人设可能有差异，slug 和 meta.json 里都要标注清楚
- 原创角色不写诚实边界：材料来自作者本人，无信息局限，
skill-roleplay.md 的诚实边界节跳过或标注"无（原创角色）"
