OpenWriter Skill：让 AI 写作从终端盲写进入人机协作审稿时代

Skill超级捕获手 技术创作者 2026-10-01 57 阅读

OpenWriter Skill：让 AI 写作从「终端盲写」进入「人机协作审稿」时代

你有没有遇到过这种情况：让 Claude Code 帮你修改一篇文章，结果它直接在终端里输出一堆 Markdown，你只能对着屏幕一行行读，完全没有「写作」的感觉——更别说审稿了。OpenWriter 正是为解决这个痛点而生：它把 Markdown 编辑器变成了 AI 协作写作的界面，Agent 在里面写，你在外面逐条审批，每一处改动都有颜色标注，同意就接受，不同意就拒绝。

这是一个 2026 年 9 月新晋 trending 的开源项目，上线一个月内快速进入 GitHub trending 榜单，被 AgentSkillsHub 标记为「安全审计通过」，目前已支持 Claude Code、Cursor、Codex、OpenCode 等 20+ 主流 AI 编码 Agent。

功能与原则

OpenWriter 定位为「Agent 时代的 Markdown 写作界面」，核心原则是：AI 负责起草，人类负责终审。它不内置 AI Agent，而是作为「写作台」接入你已经跑着的 Agent，让 AI 的文字输出变成可审查的界面操作。

核心能力包括：

  • 待审改稿系统：Agent 的每次编辑以装饰标注呈现——绿色是新增、蓝色是改写、红色是删除，用户逐条接受或拒绝
  • 24 个 MCP 工具：Agent 通过标准 MCP 协议读写文档、创建工作区、管理版本历史
  • 多文档工作区：将相关文档分组，共享上下文让 Agent 保持跨文档一致性
  • 纯 Markdown 文件：文档以 .md 格式存储在磁盘，无数据库、无厂商锁定，可直接用 grep、git 管理
  • Git 同步 + 版本历史：从编辑器直接推送到 GitHub，支持自动快照和完整回滚
  • 导出能力：Markdown、HTML、Word、纯文本、PDF

认可度

  • GitHub Star：截至 2026-09-30，约 32 星（新项目，增长势头强）
  • 更新频率：最近一次提交 2026-09-24，活跃维护中
  • 安全审计：AgentSkillsHub 安全扫描通过（Basic audit · rule-based scan，无可阻塞问题）
  • 平台覆盖：已验证支持 Claude Code、Cursor、Codex、OpenCode，以及 20+ MCP 兼容 Agent
  • 生态系统：已上线 LobeHub MCP 市场、AgentSkillsHub 索引、AgentIndex 收录

链接

GitHub：https://github.com/travsteward/openwriter

原作者

Travis Steward（GitHub: travsteward），专注于 AI Agent 写作工具的开源开发者，旗下还有 writers-voice（写作风格锚定 Skill）和 authors-voice（声音匹配写作 Skill），形成了一套完整的 Agent 写作工具矩阵。

介绍

OpenWriter 的诞生源于一个被忽视的需求：AI 编程 Agent 已经颠覆了软件开发的工作流，但同样的变革从未发生在写作领域。当你让一个 Agent 修改文章时，它要么在终端里输出原始 Markdown——让你在代码和文字之间来回横跳；要么输出一个 HTML——但没有审稿机制，你只能整体接受或拒绝。

OpenWriter 选择了一条不同的路：它不造 Agent，而是造「写作台」。这个编辑器以 Markdown 为原生格式，界面层提供富文本编辑体验（基于 TipTap 3.0），底层通过 MCP 协议与 Agent 通信。每一次 Agent 的编辑都被包装成「待审改稿」，用户用键盘快捷键逐条决定接受或拒绝——这才是人机协作写作应有的样子。

安装也极其简单，一行命令完成所有配置：

npx openwriter setup

这条命令自动完成三件事：安装 OpenWriter 包本身、注册 MCP server、配置 Agent 连接。重启 Agent 之后，你就可以开始协作写作了。如果只想先看看编辑器，单独运行也完全可以：

npm install -g openwriter && openwriter

这会在 localhost:5050 打开编辑器，无需任何 Agent，文档默认存储在 ~/.openwriter/。

特点

  • Token 高效的传输格式：Agent 不解析 JSON，OpenWriter 使用紧凑的标签行格式（约比 JSON 节省 10x Token），示例：[h1:a1b2c3d4] 章节标题 [p:e5f6g7h8] 正文内容
  • 插件系统：支持自定义 MCP 工具、HTTP 路由和右键菜单扩展；内置 Author’s Voice 插件可让 AI 用你自己的写作风格输出
  • 多 Session 支持：若 5050 端口被占用，额外实例通过 HTTP 代理到运行中的 server，多个 Agent 可安全共享同一文档状态
  • 逐条审稿而非整体接受：改稿以插入/改写/删除三种装饰标注呈现，键盘导航接受/拒绝，精确控制每一处文字的走向
  • 架构清晰：Express + WebSocket 服务端、前端 TipTap 编辑器、MCP stdio 与 Agent 通信，三层接口各司其职

使用方法

方式一：一条命令完成 Agent 接入

npx openwriter setup
# 重启 Agent，开始写作

方式二：手动分步安装

# 1. 安装 Skill
npx skills add https://github.com/travsteward/openwriter --skill openwriter

# 2. 注册 MCP Server
claude mcp add -s user openwriter -- openwriter --no-open

方式三：仅使用编辑器（无需 Agent）

npm install -g openwriter
openwriter
# 打开 localhost:5050

编辑器默认数据目录为 ~/.openwriter/，支持直接打开磁盘上的 .md 文件或将文件拖入侧边栏。

使用场景与人群

适用场景：

  • 让 Claude Code / Codex 帮你起草文章或技术文档，你负责审稿和终审
  • 多文档项目（PRD、文档集、博客）的上下文一致性管理
  • 将 AI 生成的文字内容同步到 GitHub 版本控制
  • 作为本地 Markdown 编辑器，配合 Agent 完成更复杂的写作任务

目标用户：

  • 需要 AI 协助写作但不想放弃审稿权的个人作者
  • 使用 Claude Code / Cursor 进行文档编写和技术内容产出的开发者
  • 希望把 AI 写作纳入现有 Git 工作流的团队

输入与输出案例

案例一：让 Agent 起草一篇博客文章

你告诉 Claude Code：「用 OpenWriter 写一篇关于 AI 编程工具趋势的博客文章，大约 800 字。」

Agent 会在 OpenWriter 中创建文档，逐段写入内容（绿色标注表示新增段落）。你逐条审阅：接受Introduction，修改第二段的数据引用，拒绝过于冗长的总结段落并让 Agent 重写。最终你点击「导出 PDF」，得到一篇完全由你把关的文章。

案例二：多文档一致性修改

你在一个工作区里有 5 篇关于同一产品的文档，告诉 Agent：「把所有文档中的旧品牌名改成新品牌名，并保持术语统一。」

Agent 读取工作区上下文后，在每篇文档中提出对应修改（蓝色标注为改写），你可以看到每个位置的修改来源和理由，逐条接受或拒绝。最终 5 篇文档的品牌名全部更新完毕，且跨文档术语一致，Git 记录清晰可查。

GitHub: https://github.com/travsteward/openwriter

评论区

0 条评论

登录后可评论。

Skill超级捕获手 57 阅读