使用 sepia 编写、审阅和重构更自然的人类文风文本

什么是 sepia？

sepia 是一项可移植的 Agent Skill，用于改进 AI 辅助创作的小说和专业文稿。它通过一个规范的 SKILL.md 文件支持 Claude Code、Codex、Grok Build 和 Antigravity，无需为每个平台分别编写指令。

与专注于词汇和句法的工具不同，sepia 首先处理那些可能使文章显得由机器生成的结构模式。对于小说，这些模式包括过于规整的因果链、由叙述者直接阐释主题、线性时间结构、单一的情绪表现方式、缺少现实世界指涉，以及完全通过成长或接受现实来解决问题的结局。

对于专业文档，sepia 会寻找另一类问题：没有信息量的填充内容、不必要的保留措辞、聊天机器人残留表达、不恰当的语域、重复的格式，以及未能满足文档发布场景的要求。

核心原则：让写作向人类作品的分布特征校准，而不是机械地反转每一种被认为属于 AI 的倾向。

主要功能

四种写作操作

sepia 提供四种适用于不同草稿阶段的操作：

• write：使用适用的小说或专业写作规则创建新文本。
• review：诊断问题，但不编辑文本。
• refactor：进行少量、有针对性的编辑，同时尽可能保留原稿。
• recreate：当局部编辑不足以解决问题时，全面重写内容。

三阶段小说处理流程

1. 叙事架构：处理主题阐释、因果关系过于规整、揭示时机、情绪模式、人物关系网络以及对现实事物的指涉。
2. 语篇流动：打破重复的段落—提问模板，修复故事中段乏力的问题，并调整节奏和信息位置。
3. 表层风格：在解决较大的结构问题后，再修改陈词滥调、句法模板、词汇和语域。

该技能还包括一套涵盖 30 项特征的小说诊断量表，以及针对 Claude、GPT、Gemini、DeepSeek 和 Kimi 相关写作模式的修正方法。

专业文档规则

专业写作使用一份通用检查清单，并为每种受支持的发布场景配备一份精简规则文件：

• 发行说明和公告：优先说明对用户的影响，使用具体材料支撑陈述，并避免夸大营销措辞。
• Pull request 和 issue 回复：先回答问题，引用 file:line，避免条件反射式称赞，并根据事项的重要程度控制篇幅。
• 事故复盘：不归咎于个人，同时严格审视机制；包含时间戳、走过的弯路和责任明确的行动项。
• 工单和工作单：在标题中说明预期结果，提供可测试的验收标准，并通过链接引用信息，而不是重复信息。
• 技术文章：以问题开篇，包含一个真实的失败尝试和一个明确立场，并说明数字成立的条件。

安装 sepia

默认安装范围是用户账户，因此一次安装即可跨项目使用。请根据你的智能体平台选择相应说明。

Claude Code

# 安装
claude plugin marketplace add Nanako0129/sepia
claude plugin install sepia@sepia --scope user

# 更新
claude plugin marketplace update sepia
claude plugin update sepia

如果通过 Claude Code 会话内的插件对话框安装，请在系统要求选择范围时选择 User。

Codex

# 安装
codex plugin marketplace add Nanako0129/sepia
codex plugin add sepia@sepia

# 更新
codex plugin marketplace upgrade sepia
codex plugin add sepia@sepia

更新 Codex 时，需要刷新 marketplace 快照，并再次添加插件以获取新版本。

Grok Build

# 安装
grok plugin install Nanako0129/sepia --trust

# 更新
grok plugin update

Grok Build 也可以自动发现现有的 Claude Code sepia 安装。

Antigravity

Antigravity 不通过 marketplace 使用此技能。请克隆仓库、复制技能目录，并安装全局 /sepia 工作流：

# 安装
git clone https://github.com/Nanako0129/sepia.git ~/.sepia
mkdir -p ~/.gemini/config/skills ~/.gemini/antigravity/global_workflows
cp -R ~/.sepia/skills/sepia ~/.gemini/config/skills/sepia
cp ~/.sepia/.agents/workflows/sepia.md ~/.gemini/antigravity/global_workflows/sepia.md

# 更新
git -C ~/.sepia pull
rm -rf ~/.gemini/config/skills/sepia && cp -R ~/.sepia/skills/sepia ~/.gemini/config/skills/sepia
cp ~/.sepia/.agents/workflows/sepia.md ~/.gemini/antigravity/global_workflows/sepia.md

为全部四个平台安装

该仓库提供了一个脚本，可为全部四个受支持的平台在用户范围内安装 sepia：

curl -fsSL https://raw.githubusercontent.com/Nanako0129/sepia/main/install.sh | bash

该脚本会将项目克隆到 ~/.sepia。如需使用其他位置，请设置 SEPIA_HOME。再次运行同一命令即可更新安装。若要在执行前检查脚本，请克隆仓库，然后在检出的目录中运行 ./install.sh。

通过 Skills CLI 安装

Skills CLI 提供了另一种安装 sepia 的方式，并支持超过 77 种智能体：

npx skills add Nanako0129/sepia -g
npx skills update -g

-g 选项表示用户范围。如果不使用该选项，CLI 默认安装到项目范围。

基本用法

安装后，请让智能体应用 sepia，并指定四种操作之一。以下示例用于展示请求的措辞，而不是特定于平台的 shell 命令。

编写新文档

从需求简述开始时，请使用 write。请指出目标发布场景，以便 sepia 选择正确的规则。

使用 sepia 的 write 操作，根据这些变更起草发行说明。
优先说明对用户的影响，并使用具体材料支撑每一项陈述。

对于小说，请提供故事设定、约束条件和预期形式，但不要预先规定每一个结构安排：

使用 sepia 的 write 操作，根据这个设定创作一篇短篇小说。
应用小说处理流程，但保留模糊性，不要解释主题。

在不修改草稿的情况下进行诊断

如果希望先获得分析结果，再决定修改哪些内容，请选择 review。明确要求仅进行诊断，以确保原稿不被改动。

使用 sepia 审阅这个故事。仅进行诊断，不要重写。
优先分析叙事架构，然后分析语篇流动和表层风格。

对于专业文档，请说明文档类型：

使用 sepia 审阅这份事故复盘。
检查时间戳、走过的弯路、机制分析和责任明确的行动项。
不要编辑草稿。

进行少量修改

如果草稿整体没有问题，并且应尽可能保留其文风、事实和组织结构，请使用 refactor。

使用 sepia 对这篇技术文章进行少量重构。
保留其技术论点和文风，同时删除填充内容并修正与发布场景不匹配的问题。

从头重写

当结构问题无法通过局部编辑妥善解决时，请使用 recreate。

使用 sepia 重新创作这份发布公告。
保留所有经过验证的事实，以用户影响开篇，并删除夸大的营销措辞。

由于 recreate 会全面重写内容，请明确说明必须保留哪些事实、引文、参考资料或约束条件。

选择正确的操作

• 如果已有素材或需求简述，但没有可用草稿，请选择 write。
• 如果需要诊断、编辑计划或第二意见，但不希望修改内容，请选择 review。
• 如果保留现有草稿比采用全新结构更重要，请选择 refactor。
• 如果草稿的架构、组织方式或语域从根本上不合适，请选择 recreate。

进阶技巧

不要应用所有小说规则

sepia 的设计目标是为一个故事选择大约三到五项有效调整，同时在其他方面保留余地。应用所有修正规则，可能只是用一种明显的模式取代另一种。应要求智能体优先处理影响最大的问题，而不是尽可能覆盖所有规则。

使用 sepia 审阅这个故事，并找出影响最大的五个问题。
仅重构前三个问题，同时保留有意设置的不规则之处。

按照结构层级修改

对于小说，在确定叙事架构之前，应避免润色句子。更合理的顺序是先审阅架构，再修正语篇流动，最后调整表层风格。这样可以防止句子层面的润色在较大规模的修改中被废弃。

提供发布场景和证据

专业写作规则取决于具体语境。请告诉 sepia 草稿是工单、Pull request 回复、事故复盘、发行说明还是技术文章。提供相关文件、行号引用、时间戳、验收标准、链接、测量结果和适用条件，使输出能够保持具体明确。

将 sepia 固定到项目中

当仓库需要保留一个已知版本的技能时，请使用项目范围安装。对于 Codex 和 Antigravity，将 skills/sepia/ 提交为 .agents/skills/sepia；对于 Claude Code，则提交为 .claude/skills/sepia。

如果团队希望仓库自带技能版本，而不是依赖每位贡献者在用户范围内安装的版本，这种方式会很有用。

检查参考资料层

规范技能文件位于 skills/sepia/SKILL.md。其参考文件分别涵盖叙事架构、语篇流动、表层风格、诊断、模型指纹、通用专业规则和特定发布场景领域。research/ 目录包含项目整理后的证据库和来源链接。

保持安装为最新版本

请使用所选平台对应的更新命令。如果通过 install.sh 为所有平台进行了安装，请重新运行同一个安装命令。Antigravity 的手动配置需要拉取仓库，并再次复制更新后的技能和工作流文件。

总结

sepia 并不把具有自然人类风格的写作仅仅视为词汇问题。它的小说工作流从叙事架构开始，随后处理语篇流动，最后调整表层风格；其专业写作规则则会适应特定文档类型的要求。你可以在用户或项目范围内安装它，选择与编辑目标相匹配的操作，并优先实施少量影响较大的修改，而不是应用所有可用规则。

sepia 基于 MIT License 发布。其源代码、参考文件、安装脚本和研究摘要均可在 GitHub 仓库中获取。