ST-Compatible Independent RP App Builder

面向 Codex 的独立前端 RP 应用制作 Skill。

Release License: MIT

  • 当前版本：v0.3.1
  • 作者：牢凌
  • 调用名：$independent-narrative-app
  • 语言：以中文工作流和知识库为主

这是什么

本 Skill 帮助创作者把角色卡式 RP 想法逐步发展为可运行、可维护、可验证的独立应用。它兼容 SillyTavern 的角色字段、World Info、Prompt/Preset 与宏语义，但目标应用不依赖 SillyTavern 运行时。

支持四类入口：

  1. 从零创建独立前端 RP 应用。
  2. 将普通或 SillyTavern 角色卡迁移为独立应用。
  3. 审计、修复或渐进改造已有叙事应用。
  4. 在已有作品中单独设计角色、世界书、玩法、记忆、Prompt、UI、存档等系统。

它不是固定源码模板或一键生成器。Skill 负责让 AI 先理解创作目标、提供方案并记录决定，再进入设计、实施和验证。

主要能力

  • 面向小白的逐步引导：一次推进一个关键决定，并在用户不知道时提供可理解的方案与推荐。
  • RP 作品设计：世界观、玩家身份、角色关系、开局、剧情循环、文风、内容尺度和系统联动。
  • ST 兼容：角色卡、世界书、预设、Prompt、宏、未知字段与高风险扩展的保留和隔离。
  • 独立运行时：模型网关、流式输出、状态提交、记忆与上下文、世界书注入、存档迁移和崩溃恢复。
  • 前端体验：视觉方向、设置、正文渲染、COT 组装、Token 预估与缓存命中优化。
  • 工程质量：行为规格、集成 Trace、失败恢复、版本、回滚、发布和分级验收。

安装

方法一：使用 GitHub Release

  1. 从 最新 Release 下载 independent-narrative-app-v0.3.1.zip。
  2. 解压后确认存在 independent-narrative-app/SKILL.md。
  3. 将整个 independent-narrative-app 文件夹放入用户级 Skill 目录：

Windows：

%USERPROFILE%\.agents\skills\independent-narrative-app\

macOS / Linux：

~/.agents/skills/independent-narrative-app/

也可以放入单个项目的：

<项目根目录>/.agents/skills/independent-narrative-app/

方法二：让 Skill Installer 从 GitHub 安装

在 Codex 中输入：

使用 $skill-installer，从下面的 GitHub 路径安装 Skill：
https://github.com/LingYuYue1/st-compatible-independent-rp-app-builder/tree/main/independent-narrative-app

如果安装后没有立即出现，请重启 Codex，并使用 /skills 检查。

Codex Skills 官方说明：Build skills

使用

第一次使用建议显式调用：

使用 $independent-narrative-app。

我想从零制作一个独立前端 RP 应用。
我的初步想法是：……

请先建立讨论文档，从作品轮廓开始引导我。
每次只讨论一个关键问题，暂时不要直接写代码。

Card-to-App 示例：

使用 $independent-narrative-app。

我要把这张 SillyTavern 角色卡迁移为独立应用。
请先审计角色卡、世界书、预设、宏和插件依赖，
给出兼容报告，不要直接修改原始文件。

已有应用改造示例：

使用 $independent-narrative-app。

请审查这个已有 RP 应用的记忆、状态和存档系统。
先建立行为基线，区分已有问题与新增需求，
在我确认设计前不要重写核心玩法。

默认流程

提出想法
→ 讨论草案
→ 讨论结构与系统联动
→ 关键可行性检查
→ 完整设计方案
→ 阶段路线图
→ 分阶段实施
→ 单阶段与多系统验证
→ 全局验收和交付

验证边界

v0.3.1 已通过 Skill 结构校验、官方结构校验、脚本语法检查、知识包 fixture 和第一切片 Probe。具体项目仍需分别验证真实模型、并发、目标平台持久化、旧档迁移、长期性能与安装包运行。

仓库结构

independent-narrative-app/
├─ SKILL.md
├─ agents/
├─ assets/
├─ evals/
├─ references/
└─ scripts/

许可与声明

本项目使用 MIT License。

本项目由社区作者独立制作，不是 OpenAI 或 SillyTavern 官方项目。SillyTavern 名称仅用于描述兼容目标。