interactive-fiction-skill

agent
Guvenlik Denetimi
Uyari
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.

SUMMARY

AI agent 互动小说skill:选项驱动的沉浸式剧情体验,一个skill达到酒馆的体验

README.md

interactive-fiction

互动小说创作完整规范 v9.3.0 —— 让 AI agent 写出「有选项、有张力、有沉浸感」的互动小说。

License: MIT
Version


为什么需要它

让 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 直出)

快速开始

  1. 用你的客户端加载本 skill(如 Hermes 的 skill_view、Claude Code 的 skill 机制)
  2. 发送「加载小说包」→ 进入开局路线选择
  3. 选路线 A(穿越成原著角色)/ B(自创角色)/ C(创世模式)/ 🎲 随机开局 → 开始正文
  4. 每轮正文后从 A/B/C/D/E 选一个推进剧情
  5. 随时发送「帮助」查看使用指南(全量指令速查)

提示:本 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)

Sonuc bulunamadi