创作者适配指南
TauriTavern 的 Agent 系统延续了 SillyTavern 重视创作者自由的传统。创作者可以通过提示词、配置档案和 SKILLS，为某类玩法准备更稳定的运行环境。
这份指南不要求你理解后端实现。它只讨论面向用户分发时，怎样把 Agent 相关内容组织得清楚、温和、可维护。
先想清楚工作流
不要一开始就问“我要开放哪些工具”。更好的起点是：
- 用户在这个玩法里最常遇到什么问题？
- Agent 需要多看哪些资料，才能更好地回复？
- 哪些输出必须稳定，例如正文、状态栏、小剧场、摘要？
- 哪些自由应留给模型，哪些边界必须由创作者固定？
如果只是希望回复更有文采，普通预设可能已经足够。Agent 更适合需要查阅、整理、分步骤写作或维护长期状态的玩法。
把内容分到合适位置
可以用这个简单规则：
| 内容 | 推荐位置 |
|---|---|
| 每轮都必须遵守的短规则 | Agent 系统提示词 |
| 大段写作方法或示例 | SKILLS |
| 长期角色状态、未解决线索 | persist/ 或未来的记忆机制 |
| 本次运行的草稿和整理 | scratch/ |
| 最终回复正文 | output/main.md |
| 短对话节奏 | 系统提示词中说明何时使用 append 提交 |
| 仍依赖普通 SillyTavern 的提示组织 | 原有预设和角色卡 |
这样做能减少提示词膨胀，也能让用户更容易调试。
设计配置档案
一个 Agent 配置档案应服务一个明确目标。比如：
story-polisher：用于润色当前回复。lore-aware-writer：更重视世界书和历史检索。status-bar-writer：专注稳定生成状态栏格式。memory-summarizer：后台整理摘要或持久信息。
配置时可以从几个问题出发：
- 是否需要读取聊天历史？
- 是否需要读取世界书激活结果？
- 是否需要 SKILLS？
- 是否允许写入
persist/？ - 是否必须提交聊天消息？
- 最大轮数是否足够完成任务？
普通前台写作配置通常应保留：
chat.search
chat.read_messages
worldinfo.read_activated
skill.list
skill.search
skill.read
workspace.read_file
workspace.write_file
workspace.apply_patch
workspace.commit
workspace.finish如果你关闭了 workspace.commit，前台 Agent 将无法把回复提交到聊天。除非你明确在做后台任务，否则不建议这么做。
短对话优化
一些角色并不适合每轮都回复一整段长文。日常闲聊、暧昧拉扯、轻松吐槽、简短回应，往往更像真人聊天：一句话先接住，再补一点情绪或动作。
这类场景可以引导 Agent 使用追加提交：
当用户只是轻量闲聊，或角色此刻不需要长篇展开时，请使用短对话节奏。
可以多次 append 提交简短内容，让回复像连续发出的几句消息。
每段保持自然，不要为了显得完整而过度解释。建议把它作为“何时使用”的规则，而不是强制每次都拆分。剧情高潮、正式叙事、状态栏、复杂说明，通常仍需要一次性组织完整内容。
当前 append 的语义是同一次 Agent 运行对同一条 Agent 消息进行连续补充。它能制造短对话阅读节奏，但不会把每次 append 都变成独立聊天楼层。创作者在写示例时，最好按“短段连续出现”来设计，而不是依赖多楼层消息数量。
写 Agent 系统提示词
Agent 系统提示词不需要写成命令堆。它更适合像一份简洁的工作说明：
你是用于本玩法的写作 Agent。
请先理解当前聊天上下文；如果关系、剧情或设定不明确，优先搜索聊天历史和读取本轮激活的世界书。
最终回复写入 output/main.md，并在完成前提交。
如果需要使用写作风格说明，先查看可用 SKILLS，再按需读取相关文件。不要把临时分析写进最终回复。可以强调目标，但不必恐吓模型。清楚的工作步骤通常比大量否定句更稳定。
组织 SKILLS
分发给用户的 Skill 建议保持小而清楚。
推荐结构：
my-card-writing/
SKILL.md
references/
tone.md
relationship-pacing.md
status-bar-format.md
examples/
short-reply.mdSKILL.md 负责导航，不必承载所有内容。你可以在里面写：
- 本 Skill 适合哪些角色或玩法。
- Agent 应先读哪些文件。
- 哪些内容只是参考，哪些内容是格式要求。
- 如果和某个 Agent 配置档案配套，应写明配置名称。
兼容 Agent Mode 关闭的用户
不是所有用户都会开启 Agent Mode。创作者分发内容时，建议保持两层体验：
- Agent Mode 关闭时，预设和角色卡仍能正常使用。
- Agent Mode 开启时，额外的配置档案和 SKILLS 提供更强的工作流。
也就是说，Agent 适配最好是增强，而不是唯一入口。
谨慎使用持久信息
persist/ 可以让同一聊天的后续 Agent 运行继续看到某些信息。它很有用，也需要克制。
适合写入：
- 重要但简短的剧情事实。
- 未解决的问题。
- 角色关系状态。
- 用户明确偏好的写作方向。
不适合写入：
- 完整聊天记录。
- Agent 的思考过程。
- 一次性草稿。
- 工具调用原始结果。
- 用户没有同意保存的敏感内容。
发布前检查
发布 Agent 适配内容前，建议做一次小检查：
- Agent Mode 关闭时，原玩法仍可运行。
- Agent Mode 开启后，普通发送能完成并提交。
- 时间线中没有反复失败的工具调用。
- 配置档案没有依赖尚未开放的功能。
- SKILLS 可以导入、预览、读取和导出。
- 如果限制了工具，系统提示词没有要求 Agent 使用被禁用的工具。
- 如果改了输出路径，提交路径和提示词保持一致。
创作者不需要把所有能力一次用满。一个边界清楚、能稳定完成任务的小配置，通常比一个看似强大但难以维护的大配置更适合分发。