Sepia：为AI写作注入人性化叙事架构的开源技能包
> Sepia 是一套基于叙事架构修复与场景匹配规则的开源写作技能包，让 Claude Code、Codex 等 AI 工具写出更自然、更有文学质感的中长文本。
## 为什么需要 Sepia？——AI 写作的“塑料感”之痛
如果你经常使用 Claude Code、Codex 或 Grok Build 生成小说、散文、技术博客或商业文案，你一定会遇到以下问题：
- **叙事扁平**：AI 生成的故事像流水账，缺乏张力、转折和人物弧光，读起来像产品说明书。
- **风格错位**：让 AI 写一篇学术论文，它却用营销口吻；让它写一封商务邮件，它又像在写小说。
- **结构松散**：长文生成后，段落之间缺乏逻辑衔接，像是拼凑的碎片。
- **“AI 味”浓重**：大量使用“总之”“值得注意的是”“综上所述”等套话，读者一眼就能看出是机器写的。
这些问题根源于大语言模型的训练目标——追求“平均正确”的文本，而不是“有作者意图”的叙事。而 Sepia 的诞生，正是为了修复这种“去人性化”的写作缺陷。
## Sepia 是什么？
Sepia 是一个基于 **StoryScope 叙事架构理论**（arXiv:2604.03136）的写作技能包，它通过一系列可复用的规则、模板和提示词，让 AI 在生成文本时遵循：
1. **叙事架构修复**：自动检测并补全故事中的缺失元素（如冲突、转折、人物动机），重建“起承转合”的节奏。
2. **场景匹配规则**：针对不同写作场景（小说、技术文档、商务邮件、新闻稿等），动态调整语气、句长、词汇密度和修辞手法。
它不是一个独立的编辑器，而是作为 **Claude Code、Codex、Grok Build、Antigravity** 等 AI 编程/写作工具的“技能插件”存在，通过 Shell 脚本和配置文件注入到工作流中。
## 安装与使用：三分钟上手
### 安装要求
- 已安装 Node.js 16+ 或 Python 3.9+（取决于你使用的 AI 工具）
- 已配置好 Claude Code / Codex 等 CLI 环境
- Git 已安装
### 安装步骤
bash
# 克隆仓库
git clone https://github.com/Nanako0129/sepia.git
cd sepia
# 运行安装脚本（自动检测当前 AI 工具并配置）
./install.sh
# 验证安装（输出当前激活的规则版本）
./sepia --version
### 基本使用：在 Claude Code 中启用 Sepia 技能
在 `~/.claude/commands/` 目录下创建 `sepia.md` 文件，内容如下：
markdown
---
name: sepia
描述: 使用 Sepia 叙事架构修复规则生成文本
---
请严格遵循以下规则生成文本：
1. 叙事结构：必须包含“铺垫-冲突-转折-升华”四段式。
2. 场景匹配：根据用户指定的文体（小说/论文/邮件），套用对应的风格参数。
3. 禁用词汇：避免“总之”“值得注意的是”“综上所述”等 AI 套话。
4. 句长控制：叙事段落平均句长不超过 20 字，技术文档不超过 25 字。
5. 修辞要求：至少使用 2 种修辞手法（隐喻、排比、设问等）。
然后，让 Claude Code 执行 `sepia` 命令，并输入你的写作要求：
bash
claude -p "用 sepia 风格写一篇关于人工智能伦理的短篇小说，800字"
或者，在 Codex 中通过环境变量激活：
bash
CODEX_PLUGIN=sepia codex "写一篇产品发布会的新闻稿"
### 高级用法：自定义场景规则
Sepia 允许你通过编辑 `rules/` 目录下的 YAML 文件来定制场景。例如，创建一个 `rules/tech-blog.yaml`：
yaml
name: 技术博客
匹配关键词: [技术, 教程, 博客]
参数:
语气: 专业但友好
句长: 20-30字
词汇: 允许专业术语，但需首次出现时加解释
结构: 问题-方案-验证-总结
禁用: [众所周知, 显而易见, 快速上手]
保存后，运行 `./sepia reload` 即可生效。
## 核心亮点：为什么 Sepia 与众不同？
### 1. 基于学术理论的深度架构
Sepia 不是简单的提示词集合，而是基于 **StoryScope 叙事架构理论** 实现。该理论将文本视为一个“叙事系统”，包含情节、角色、视角、节奏、主题五个维度。Sepia 的规则引擎会逐项检查这些维度，并自动生成修复建议。例如，当检测到故事缺乏冲突时，它会自动插入“价值观对立”或“资源争夺”的冲突类型，而不是生硬地加一个“突然出现的神秘人物”。
### 2. 场景自适应的动态规则
大多数写作工具只有一套固定的“写作风格”，而 Sepia 内置了 20+ 种场景模板（小说、剧本、学术论文、技术文档、商务邮件、新闻稿、广告文案、社交媒体短句等）。它会根据用户输入的关键词自动选择模板，甚至允许混合场景（如“用小说笔法写技术博客”）。
### 3. 与 CLI 工具的深度集成
Sepia 提供 Shell 脚本，可直接嵌入 Claude Code、Codex 等工具的 `pre-command` 钩子中。这意味着每次生成文本前，Sepia 会自动注入规则，无需手动复制粘贴提示词。它还支持 `--dry-run` 模式，让你看到规则如何影响输出。
### 4. 可解释的反馈机制
当 AI 生成文本后，Sepia 会输出一份“架构诊断报告”，标注哪些叙事元素缺失、哪些风格参数偏离，并给出修改建议。这相当于给 AI 写作加了一个“语法检查器”，不过检查的是叙事逻辑和文体风格。
## 适用场景：谁需要 Sepia？
- **小说家/剧本创作者**：用 AI 生成初稿，但苦于“AI 味”太重，需要快速修复叙事结构。
- **技术写作者**：需要将复杂技术概念写得通俗易懂，同时保持专业严谨。
- **营销文案人员**：需要根据不同的品牌调性（活泼/严肃/高端）调整文案风格。
- **学术研究者**：需要生成文献综述或论文初稿，避免口语化和逻辑松散。
- **AI 工具重度用户**：经常使用 Claude Code / Codex 生成代码注释、README、项目文档，希望文档读起来更自然。
## 与同类项目对比
| 项目 | 核心策略 | 优点 | 缺点 |
|------|----------|------|------|
| **Sepia** | 基于叙事架构理论 + 场景规则 | 学术深度高，场景覆盖广，可解释性强 | 需要一定配置成本，对新手不友好 |
| **PromptPerfect** | 自动优化提示词 | 上手简单，支持多语言 | 只优化提示词，不深入文本结构 |
| **TextFX** | Google 实验性写作工具 | 免费，适合创意写作 | 不支持 CLI 集成，场景有限 |
| **LangChain 的写作链** | 通过链式调用多次生成 | 灵活，可自定义 | 需要编程基础，且对长文本支持弱 |
| **AutoWriter** | 基于模板的生成 | 快速，适合固定格式 | 模板僵化，无法处理复杂叙事 |
**Sepia 的独特优势**在于它把“写作理论”变成了“可执行的规则”，而不是仅仅停留在提示词层面。它更适合那些对文本质量有较高要求的专业写作者。
## 实际测试：一个对比案例
为了验证效果，我们让 Claude Code 分别用默认模式和 Sepia 模式写一段 300 字的小说开头。
**默认模式输出（节选）**：
> 在一个遥远的未来，人类已经移民到火星。主角李雷是一个工程师，他每天的工作是维护氧气站。有一天，他发现了一个异常数据，于是他决定去调查。
**Sepia 模式输出（节选）**：
> 火星的黄昏是锈红色的，像一块被氧化了的铁皮。李雷站在氧气站的穹顶下，听着空气循环系统发出稳定的嗡鸣——那是整个殖民地的心跳。但今天，心跳乱了。数据显示，第47号气阀在过去的72小时里，泄漏了0.3%的氧气。这个数字太小，小到系统自动忽略了它。但李雷知道，在火星上，0.3%意味着死亡。他摘下安全帽，擦掉额头的汗，决定去那个废弃的管道舱看看。那里，似乎有什么东西在等着他。
可以看到，Sepia 模式下的文本有了更具体的场景、更细腻的感官描写、更明确的冲突（0.3%的泄漏 vs 死亡），以及一个悬疑的钩子。这就是叙事架构修复的威力。
## 局限性与改进方向
- **学习曲线**：需要用户理解“叙事架构”的基本概念，否则可能不知道如何调整规则。
- **依赖 CLI 环境**：不支持 Windows 原生 PowerShell，需要 WSL 或 Git Bash。
- **规则冲突**：当多个场景模板混合时，可能出现规则冲突，需要手动调整优先级。
- **语言支持**：目前主要针对英文和中文，其他语言支持有限。
未来版本计划加入可视化规则编辑器，以及针对多语言语料的自动规则生成。
## 结语
Sepia 是一个“小而美”的工具，它不试图取代 AI 写作，而是给 AI 写作加上一层“叙事过滤器”。如果你厌倦了 AI 生成的“塑料感”文本，或者需要让 AI 输出的内容更贴合特定场景，Sepia 值得一试。它目前已有 494 个 Star，社区活跃，作者持续更新，是一个充满潜力的开源项目。
**项目链接**：https://github.com/Nanako0129/sepia