interactive-fiction-skill
Health Uyari
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Gecti
- Code scan — Scanned 1 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
AI agent 互动小说skill:选项驱动的沉浸式剧情体验,一个skill达到酒馆的体验
interactive-fiction
互动小说创作完整规范 v9.3.0 —— 让 AI agent 写出「有选项、有张力、有沉浸感」的互动小说。
为什么需要它
让 AI 写互动小说,最常见的问题:
- ❌ 每轮正文结束忘了给选项,剧情变成单向广播
- ❌ 主角视角漂移,「你」和「他/她」混着用,读者出戏
- ❌ 字数忽长忽短,紧迫战斗 300 字、日常水了 2000 字
- ❌ 角色千人一面,剧情全靠套话
- ❌ 剧情开了多条线,后文互相矛盾,存档/切换一塌糊涂
用了 interactive-fiction 之后:以上问题全部变成硬性规则,由 AI 每轮输出前强制自检,写出来的正文自带选项、视角、字数、一致性保障。
安装
方式 1:npx skills
npx skills add Treasure-hub-agent/interactive-fiction-skill
npx skills是通用的 agent skill 安装工具;没有的话直接用手动复制方式即可。
方式 2:手动复制
将仓库目录放入你的 agent 技能目录:
| 客户端 | 技能目录 |
|---|---|
| Hermes | ~/.hermes/skills/creative/interactive-fiction/ |
| Claude Code | ~/.claude/skills/interactive-fiction/ |
| Cursor | ~/.cursor/skills/interactive-fiction/ |
复制后重新加载 / 重启客户端即可识别,发送「加载小说包」即可开局。
核心能力
| 能力 | 说明 |
|---|---|
| 🔴 铁律 #0 选项机制 | 每轮正文输出后强制跟 A/B/C/D/E 五选项,正文结束不结束对话 |
| 🎭 视角一致性 | 主角「我/你」、对象「他/她」切换有硬规则,多角色切换有格式约束 |
| 📏 字数区间 | 500-1200 字主区间,紧迫战斗 250-400 字,情感/氛围 800-1200 字 |
| 💾 存档系统 | 轻量/持久/里程碑三档,断连恢复、切换小说、导出 |
| 🎴 角色卡系统 | 弹出/修改/深度创建/短篇,配角静默落卡 |
| 📖 三种模式 | 主线(mainline)/ 沉浸(immersion)/ 爽文(shuangwen) |
| 🧩 P0/P1/P2 分层 | 常驻规则精简,按需加载,上下文零持续负担 |
| 🤖 子 Agent 模式 | 可选:子任务派发生成正文(不支持时自动主 Agent 直出) |
快速开始
- 用你的客户端加载本 skill(如 Hermes 的
skill_view、Claude Code 的 skill 机制) - 发送「加载小说包」→ 进入开局路线选择
- 选路线 A(穿越成原著角色)/ B(自创角色)/ C(创世模式)/ 🎲 随机开局 → 开始正文
- 每轮正文后从 A/B/C/D/E 选一个推进剧情
- 随时发送「帮助」查看使用指南(全量指令速查)
提示:本 skill 默认由主 Agent 直出正文,无需任何额外配置即可使用。子 Agent 模式、联网蒸馏等为可选增强。
存储与权限
本 skill 会在你的用户目录下创建存储根目录(默认 ~/novels/,可通过环境变量 NOVEL_STORAGE_ROOT 覆盖),用于存放:
- 小说存档与运行时状态(
{小说名}/meta/novel_runtime.json) - 角色卡(
{小说名}/characters/与通用角色卡/) - 蒸馏中间产物(
output/characters/,会被 .gitignore 忽略)
需要 agent 具备文件读写权限。无文件写权限的环境会静默降级(不中断叙事,但存档不落盘),请确保你的运行环境允许写文件。
架构
interactive-fiction/
├── SKILL.md # P0 常驻核心规则(铁律、视角、字数、选项)
├── MANIFEST.json # 文件清单 + SHA256 校验
├── VERSION # 当前版本号
├── extended/ # P1/P2 按需加载:角色卡、蒸馏、事件、存储
├── modes/ # 主线/沉浸/爽文三种模式
└── references/ # 指令导航、写作指南、使用指南、切换规则等
平台适配
| 能力 | 必需? | 不支持时的表现 |
|---|---|---|
| 文件读写 | ✅ 必需 | 存档不落盘(静默降级) |
| 联网搜索 | ⚠️ 可选 | 蒸馏走「模型知识优先」降级路径 |
| 子任务派发(子 Agent) | ⚠️ 可选 | 自动降级为主 Agent 直出 |
| thinking 模式 | ⚠️ 可选 | 关闭后仍可用,选项推理质量略降 |
常见问题
Q: 和普通 prompt 写小说有什么区别?
A: 普通 prompt 是「建议」,本 skill 是「硬规则 + 自检清单」。铁律 #0(选项必跟)、视角规则、字数区间都有强制自检步骤,AI 每轮输出前逐项核对。
Q: 版本历史?
A: 见 references/changelog.md,版本号以 VERSION 文件与 SKILL.md frontmatter 为准。
内容说明
- 本 skill 提供互动小说创作规范,支持多种题材与情感张力描写
- 涉及相关场景时按描写规范与渐进推进执行
- 创作内容责任由使用者自负;本 skill 提供创作规范,不预设具体故事内容
版权
- MIT License,可自由使用、修改、分发
- 版本变更记录见
references/changelog.md
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi