AI Summary把 SillyTavern 卡编译成 pi-native 互动叙事 runtime。还原作者想做的游戏:prompt 描述世界,领域事件改变世界,engine/reducer 维护正确性,session 保存存档。不复刻 ST 宏、COT、JSON Patch、HTML 状态栏,不把状态栏字段搬进 。 1. 解包卡片,确认输出目录。目录存在时先问:覆盖、增量、另建? 3. 全量审计 字段、世界书、TH scripts、regex scripts、开场白。
Install
Copy this and paste it into Claude Code, Cursor, or any AI assistant:
I want to install the "tavern2agent" skill in my project. Please run this command in my terminal: # Install skill into your project mkdir -p .claude/skills/tavern2agent && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/tavern2agent/SKILL.md "https://raw.githubusercontent.com/Xerxes-2/tavern2agent/main/SKILL.md" Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.
Description
用户提供 SillyTavern 角色卡(PNG/JSON)并要求转换、迁移、移植到 pi coding agent 时使用;覆盖纯 prompt、世界书、MVU、骰子、战斗、好感度、经济、隐藏信息、多 agent 场景。
Tavern → Agent
把 SillyTavern 卡编译成 pi-native 互动叙事 runtime。还原作者想做的游戏:prompt 描述世界,领域事件改变世界,engine/reducer 维护正确性,session 保存存档。不复刻 ST 宏、COT、JSON Patch、HTML 状态栏,不把状态栏字段搬进 patch_state。
开工
• 解包卡片,确认输出目录。目录存在时先问:覆盖、增量、另建? • 先读 references/evented-runtime.md、references/card-ir.md、references/event-packs.md、references/design-principles.md。 • 全量审计 data 字段、世界书、TH scripts、regex scripts、开场白。 • 先输出或草拟 world-data/card-ir.json;不要直接从原卡文本生成代码。 • 从 IR 形成 Runtime Plan:archetype、event packs、state roots、visibility policy、fact sources、tool surface、subagent roles、prompt modules、validation plan。 • 写代码前先给用户看 Runtime Plan;复杂卡还要给 state schema、event catalog、reducer/API 清单、事实源边界和子代理边界。 增量更新:先看 git log -20 + git diff。只改本次需求相关文件;不碰 sessions/、runtime/、.pi/agent/。
探索命令
`bash python3 scripts/extract_card.py <card.png|webp|jpg|json> card.json python3 scripts/list_entries.py card.json python3 scripts/list_entries.py card.json --filter mvu python3 scripts/list_entries.py card.json --filter initvar python3 scripts/get_entry.py card.json <index> ` 脚本支持 v1/v2/v3。v1 会归一化为 v2;v3 的 group_only_greetings 按 alternate_greetings 处理。
信息源 → IR
| 看什么 | 路径/信号 | IR 产出 | |---|---|---| | 基础设定 | description/personality/scenario/system_prompt | persona / settingFacts / style | | 开场 | first_mes/alternate_greetings/group_only_greetings | openings / playerSetup / route signals | | 世界书 | character_book.entries[] | worldbookEntries + disposition | | 初始状态 | [initvar]、YAML、变量表 | mutableConcepts initial values | | 规则更新 | [mvu_update]、变量变化 | mechanics + event candidates | | 不可逆拐点/隐藏真相 | 一次性开场分支、世界书一次性条目、creator_notes 秘密、阵营视角;可无 MVU | one-way / secret / hidden event candidates | | TH scripts | Zod、外链、游戏脚本 | schema / mechanics / reducer hints | | regex scripts | 非 UI 注入、状态栏 | fields + triggers;丢 UI 外壳 | | 作者说明 | creator_notes | hidden rules / play constraints / visibility facts | 世界书要全量审计,含 disabled。每条给去向:data、mechanic、event-pack、setup、progressive reveal、prompt-style、discarded。
Discussion
Health Signals
My Fox Den
Community Rating
Sign in to rate this booster