把写作从“一次性吐全文”,改成“分阶段策划、审稿、去 AI 味、导出终稿”的流水线。
你拿到的不只是文章,更是一套能反复复用、能中断继续、能回头复盘的写作生产线。
它适合这几类人:
- 想写长文、观点文、公众号文章,不想再靠一把梭 prompt 碰运气
- 想让 AI 写作过程可中断、可修改、可复盘
- 不只想拿到一篇文,而是想把写作变成稳定、可控、可积累的工作流
当前实测可用模型:
DeepSeek-V3.2:默认推荐,最适合低成本先把完整流程跑明白智谱 GLM:已实测,不分伯仲MiniMax:已实测,不分伯仲
现在可以直接下载 Writing Agent App 的 Windows 预览版:
桌面应用源码位于:
writing-agent-app/
如果你只想直接使用桌面应用,优先下载上面的安装包。
如果你想查看或参与源码开发,可以直接看仓库里的 writing-agent-app/ 目录。
- 下载桌面应用:桌面预览版
- 先看完整样本:老板的AI战略骗局 Demo
- 再看当前版本:最新更新
- 先判断模型成本:模型与 Coding Plan
- 想直接部署:完整版安装
- 想按新手路径一步步装:给新手的完整安装与使用说明
如果你只想先判断这个仓库值不值得收藏,不要先看安装,先看这个真实样本:
这不是只放一篇成品,而是把整条写作链路都放出来了,包括:
- 选题和约束:01_theme.md
- 观点定牙齿:01b_position.md
- 伤疤和代价:02_scar_tissue.md
- 结构和开头:03_outline.md、05c_opening_hook.md
- 草稿迭代:draft_v1.md、draft_v2.md
- 审稿和传播测试:pre_publish_review.md、wechat_reader_test.md
- 最终发布稿:humanized_final_clean.txt
- 运行态记录:run_manifest.json
建议浏览顺序:
01_theme.md
-> 01b_position.md
-> 02_scar_tissue.md
-> 03_outline.md
-> 05c_opening_hook.md
-> draft_v2.md
-> humanized_final.md
-> humanized_final_clean.txt
如果你看完这套 Demo 觉得“这不是一次性吐全文,而是一条可复盘的生产线”,那这个仓库的核心价值你已经看到了。
下面不是虚构示例,是这个仓库里一篇真实跑完的文章项目。
- Demo 目录:
demo/老板的AI战略骗局/ - 主题:
老板的AI战略:每月2000块的"数字化转型"骗局 - 核心判断:
老板口中的"AI战略"本质是用最低成本购买员工的焦虑感和服从性,而非真正的数字化转型 - 完整过程文件都在这个目录里,包含选题、立场、伤疤、大纲、开头赛马、草稿、审稿、传播测试、终稿和复盘
这套 Demo 需要传达三件事:
- 这是一条完整生产线,不是只放终稿
- 默认发布出口仍然是
_clean.txt,也可以在最后一步额外导出公众号排版.html - 中间产物本身就能证明“可调度、可中断、可复盘”
最关键的几个文件:
- 01b_position.md:先把文章的“牙齿”定下来,避免后面越写越软
- 02_scar_tissue.md:不是堆资料,而是打捞致命场景、隐秘代价、荒诞细节
- 04_share_map.md:不是只做共情,而是设计读者为什么愿意转发
- 05c_opening_hook.md:先赛马开头,再锁定起手式
- pre_publish_review.md:发布前追问和红队挑刺
- wechat_reader_test.md:模拟朋友圈、同行群、家族群的真实反应
- humanized_final_clean.txt:最后给你一个可直接复制粘贴发布的纯文本终稿
如果你只看最终效果,这篇 Demo 的发布出口就是:
demo/老板的AI战略骗局/humanized_final_clean.txt
首页只保留当前主线版本,历史版本不再堆在前面。
- 新增
html-exporter末端导出器:最终 Markdown 定稿后,可以额外导出一份适合公众号排版和复制的.html - 内置 4 种默认版式可选:
经典正文(default)、精致长文(grace)、极简评论(simple)、现代杂志(modern) - 保留
_clean.txt作为默认纯文本出口:你可以只拿纯文本,也可以同时拿纯文本和排版 HTML - 收紧 Stage 12.5 契约、运行态记录和回归测试,让“是否导出 HTML、选择哪种版式”变成真实流程,而不是 prompt 口头约束
如果你关心的是“最后到底能交付什么”,这一版的答案很直接:正文、可直接复制的 _clean.txt、可选的公众号排版 .html,都能稳定落地。
research-expert从泛泛调研改成“伤疤打捞”,核心产物是 02_scar_tissue.mdempathy-designer从共情点设计升级成“社交转发动机”,核心产物是 04_share_map.md- 新增
opening-tournament,在正式写稿前先赛马开头,核心产物是 05c_opening_hook.md
如果你只想知道仓库现在值不值得拉下来试,先看 v0.7.7 这 3 条就够了。更老的版本记录去 CHANGELOG 或 Releases 看,不应该堵在首页前面。
这个项目不一定非要跑 Claude 官方模型。对大多数人来说,更实用的是通过 Anthropic 兼容接口接第三方模型。
当前推荐逻辑很简单:
- 想最低成本先把完整流程跑通:
DeepSeek-V3.2 - 已经有
智谱 GLM或MiniMax套餐:直接用,也已经实测过,效果不分伯仲 - 每个月会高频写作、频繁审稿和反复改稿:直接考虑
Coding Plan - 需要在多家兼容接口之间反复切换:上 CC-Switch
为什么首页默认先写 DeepSeek-V3.2:
- 不是因为它明显强于另外两家
- 而是最早测试路径最便宜,先充 10 块钱就足够把这套流程从头到尾验证一遍
首页只保留一个简表:
| 场景 | 推荐 |
|---|---|
| 首次验证完整流程 | DeepSeek-V3.2 按量付费 |
| 已有其他平台套餐 | 智谱 GLM / MiniMax 直接接入 |
| 中高频长期使用 | Coding Plan |
| 多模型来回切换 | CC-Switch |
完整的模型接入文档、Coding Plan 地址和选型建议,见下方 模型和成本怎么选。
普通 AI 写作:
- 一次性生成全文
- 改一轮就开始漂
- 风格、结构、审稿全混在一个大 prompt 里
- 很难知道文章为什么好,为什么差
写稿Agent:
- 先定主题和立场
- 再打捞场景、代价和细节
- 再做大纲、分享触点、具象化和开头赛马
- 写完后还有主编审稿、发布前评审、微信传播测试、去 AI 味
- 最后输出
_clean.txt终稿,并可按需额外导出公众号排版.html
一句话说:
它不是“让 AI 帮你写一篇文章”,而是“把写作拆成可调度、可中断、可复盘的流程”。
适合:
- 写公众号文章、长文观点文、行业评论的人
- 对“AI 味”“结构松”“标题软”“开头弱”敏感的人
- 想把 AI 写作纳入稳定工作流的人
不适合:
- 只想一句话秒出 300 字短文的人
- 不关心中间产物、只关心快的人
- 不想做任何确认和审稿的人
完整版不是只靠一个 Skill 在跑,它依赖整个仓库一起工作:
.claude/skills/.claude/agents/.claude/workflows/scripts/
最短路径:
- 先准备
Node.js 18+和Claude Code - clone 本仓库
- 配好你要用的模型 API 或 Claude 账号
- 一定在项目根目录启动
claude - 先用
demo/老板的AI战略骗局/理解流程,再开始正式写作
如果你已经准备直接跑完整版,继续看:
从这一版开始,这个项目同时支持两种使用方式:
| 方式 | 适合谁 | 运行根目录 |
|---|---|---|
git clone 仓库 |
想直接拿完整项目、看 demo、参与开发的人 | 仓库根目录 |
plugin 安装 |
不想先 clone 仓库,只想在任意工作目录里使用工作流的人 | 你的当前工作目录 |
两条路径的底层运行时现在共用一套事实源:
claude-runtime/
然后再分别同步到:
- 项目兼容层:
.claude/ - 插件目录:
plugins/writing-agent/
用法不变:
- clone 仓库
- 在仓库根目录启动
claude - 继续按项目内
.claude/、scripts/、demo/这套方式使用
插件模式的目标是:
- 安装插件后,不需要先 clone 这个仓库
- 在任意正常工作目录启动
claude - 插件会通过工作区自举脚本补齐最小运行目录
当前仓库里已经包含插件骨架:
plugins/writing-agent/.claude-plugin/marketplace.json
安装方式只保留最简单这一条。
假设仓库地址就是:
dongbeixiaohuo/writing-agent
那用户只需要执行:
claude plugin marketplace add dongbeixiaohuo/writing-agentclaude plugin install writing-agent@writing-agent-marketplace/reload-plugins
装完之后,在你想写文章的目录里启动 claude 就可以了。
插件第一次进入一个空工作目录时,会自动补齐最小运行结构:
articles/.claude/styles/.claude/workflows/scripts/
这意味着 plugin 用户不需要 clone 完整仓库,也能让工作流里那些依赖 .claude/ 和 scripts/ 的阶段继续正常工作。
如果你对这些东西还不熟:
- GitHub 仓库怎么 clone
- Claude Code 怎么装
- Node.js 为什么要装
- 模型和 API 怎么配
- 怎么确认项目真的跑起来了
那就直接按这一节来,不需要先去翻别的文档。
Claude Code 支持 macOS、Linux、Windows。你该选哪条路,取决于你的系统和习惯。
| 安装方式 | 命令 | 适用平台 | 推荐度 |
|---|---|---|---|
| Native Install | curl -fsSL https://claude.ai/install.sh | bash |
macOS / Linux / WSL | ⭐ 推荐 |
| Homebrew | brew install --cask claude-code |
macOS | 适合已经在用 brew 的人 |
| WinGet | winget install --id Anthropic.ClaudeCode -e |
Windows | Windows 首选 |
核心建议:
- 不确定选哪个:macOS / Linux 直接用 Native Install
- 已经是 Homebrew 用户:用
brew更顺手 - Windows:先装 Git for Windows,再走 WinGet
这点必须说清楚。
Anthropic 当前文档仍把 Node.js 18+ 作为 Claude Code 的系统要求。对这个仓库来说,提前准备好 Node.js 也仍然是最稳的做法,原因有两个:
- 如果你后面想走
npm路线安装、升级或调试 Claude Code,Node.js 是硬前置 - 这个仓库本身带了
package.json和一些基于 Node 的脚本、工具链,后面你大概率还是会用到node/npm
所以最稳的建议是:
- 先装好
Node.js 18+ - 再装 Claude Code
- 最后 clone 仓库并启动项目
Windows:
- 官网下载安装:nodejs.org
- 或者直接用 WinGet:
winget install OpenJS.NodeJS.LTSmacOS:
- 官网安装包
- 或者:
brew install nodeLinux:
- 推荐用
nvm - 或者用你发行版自己的包管理器
装完先验证:
node --version
npm --version能看到版本号,再继续下一步。
打开终端,运行:
curl -fsSL https://claude.ai/install.sh | bash这个脚本会自动下载 Claude Code,并把 claude 命令放到你的 PATH 里。
如果你是 Homebrew 用户,也可以直接:
brew install --cask claude-code装完验证:
claude --versionWindows 这里建议按“Git for Windows + WinGet”这条路走。
从 git-scm.com 下载也可以,直接 WinGet 更省事:
winget install --id Git.Git -e它会顺带给你 Git Bash。Claude Code 在 Windows 上需要这类 Unix 工具链支持,所以这一步不要跳。
winget install --id Anthropic.ClaudeCode -e如果你不用 WinGet,也可以改走官方 PowerShell 安装脚本:
irm https://claude.ai/install.ps1 | iex重新打开 PowerShell 或 Git Bash,运行:
claude --version看到版本号就说明装好了。
- 推荐用 PowerShell 或 Git Bash
- 不推荐直接在 CMD 里折腾
- 如果你装了便携版 Git,Claude Code 找不到 Git Bash,再单独配置
CLAUDE_CODE_GIT_BASH_PATH
Claude Code 装好之后,常见有五种用法:
| 环境 | 特点 | 适合谁 |
|---|---|---|
| 终端 CLI | 最原生、能力最完整 | 日常开发主力方式 |
| VS Code 扩展 | 在 VS Code 侧边栏里用 | 已经重度依赖 VS Code 的人 |
| Desktop App | 图形界面更直接 | 不熟终端、但想先上手的人 |
| Web | 浏览器直接使用 | 临时体验 |
| JetBrains 插件 | IntelliJ / WebStorm 等集成 | JetBrains 用户 |
这份 README 和本仓库的所有说明,默认都以 终端 CLI 为基准。
原因很简单:
- 这个仓库强依赖“当前项目目录”这个上下文
.claude/skills/、.claude/agents/、.claude/workflows/都更适合按 CLI 路径理解- 就算你后面要用 VS Code 或 JetBrains,也建议先把 CLI 这条路摸熟
你有两条常见路径:
- 直接用 Claude 官方订阅登录 Claude Code
- 不走 Claude 订阅,改用 Anthropic 兼容接口接第三方模型
这两条路不是互斥的,只是适用场景不同。
如果你打算直接用 Claude 官方账号,常见档位是:
| 方案 | 当前常见价格 | 适合谁 |
|---|---|---|
| Pro | $20/月 |
轻量使用、学习、个人开发 |
| Max 5x | $100/月 |
高频使用、每天长时间对话 |
| Max 20x | $200/月 |
重度使用、多人或商业项目 |
这组价格和额度变动比较快,最终以 Anthropic 官方页面为准。
简单选法:
- 你只是想先体验 Claude 官方服务:先从
Pro开始 - 你每天都在用,或者很容易撞额度:再升
Max 5x - 你是团队或商业重度使用:再看
Max 20x
对这个项目来说,更常见的用法其实是:
- 用 Anthropic 兼容接口
- 接
DeepSeek-V3.2、智谱 GLM、MiniMax这类第三方模型 - 用更低成本把长链路写作流程跑通
所以你不用把“Claude 官方订阅”和“第三方模型 API”理解成二选一。
这个项目的模型选择逻辑,不是“谁绝对最强”,而是“谁更适合你的使用方式”。
| 模型 | 当前定位 | 什么时候用 | 获取 API Key | 官方文档 |
|---|---|---|---|---|
| DeepSeek-V3.2 | 默认推荐 | 第一次完整验证流程、预算敏感、想先充少量金额试跑 | DeepSeek 平台 | 接入文档 |
| 智谱 GLM | 已实测同级 | 已有 GLM 套餐或更习惯智谱生态 | 智谱开放平台 | 接入文档 |
| MiniMax | 已实测同级 | 已有 MiniMax 套餐或更习惯 MiniMax 平台 | MiniMax 平台 | 接入文档 |
这里要说清楚:
智谱 GLM和MiniMax都已经实测过,和DeepSeek-V3.2不分伯仲- README 里先强调
DeepSeek-V3.2,不是因为它明显更强 - 只是因为最开始测试时它的按量成本最低,先充 10 块钱就足够把一整条链路从头到尾跑明白
如果你会频繁使用本项目,按量付费不一定最省心。下面这些地址本身就值得收藏:
| 平台 | 首月特惠 / 入门档 | 常见续费 | 适合谁 | 链接 |
|---|---|---|---|---|
| 阿里云百炼 | ¥7.9 / ¥39.9 |
约 ¥40 / ¥200 |
量大、价格低、入口稳定 | 阿里云百炼 |
| 腾讯云 | ¥7.9 / ¥39.9 |
约 ¥40 / ¥200 |
腾讯云用户 | 腾讯云 |
| 百度千帆 | ¥7.9 / ¥39.9 |
约 ¥40 / ¥200 |
千帆用户 | 百度千帆 |
| 火山引擎 | ¥9.9 / ¥49.9 |
约 ¥50+ |
字节生态用户 | 火山引擎 |
| 无问芯穹 | ¥19.9 / ¥40 |
¥40 / ¥200 |
追求更高配额的人 | 无问芯穹 |
| MiniMax | ¥29/月 起 |
¥290/年 起 |
已在 MiniMax 生态内 | MiniMax Coding Plan |
| 智谱 GLM | ¥30/月 左右 |
¥411/年 左右 |
GLM 用户 | 智谱 GLM Coding |
| Kimi Code | ¥49/月 起 |
以官方页为准 | 想看 Kimi 方案的人 | Kimi Code |
这些套餐的价格、额度和活动会变化,最终以各平台页面为准。这里保留完整地址,是为了方便收藏和后续比较。
- 每月少量使用:
DeepSeek-V3.2按量付费 - 每月持续写、持续改:优先看
Coding Plan - 手上已经有
智谱 GLM或MiniMax套餐:直接接,不需要为了 README 刻意换
如果你不想手改环境变量,推荐直接用:
它适合这类场景:
- 你在
DeepSeek-V3.2、智谱 GLM、MiniMax之间切换 - 你不想反复改
ANTHROPIC_BASE_URL - 你不想每次都重新整理 API Key
装好了,模型也有了,先不要急着正式写文章。先让 Claude Code 证明它真的能理解这个仓库。
git clone https://github.com/dongbeixiaohuo/writing-agent.git
cd writing-agentclaude如果你走 Claude 官方账号,第一次启动会引导你登录。
如果你走第三方兼容接口,先把 settings.json 配好再启动。
进入对话后,直接试一句:
先别写新文章,先解释 demo/老板的AI战略骗局 里每个阶段文件各自起什么作用。
这句话的好处是:
- 它能验证 Claude Code 读没读到当前项目目录
- 它能验证
.claude/skills/是否被正确加载 - 它能让你立刻理解这套流程到底怎么工作
按这个清单过一遍:
| 检查项 | 命令 / 操作 | 预期结果 |
|---|---|---|
| Node.js 可用 | node --version / npm --version |
能看到版本号 |
| Claude CLI 可用 | claude --version |
能看到版本号 |
| Claude 环境自检 | claude doctor |
没有关键错误 |
| 项目目录正确 | 在仓库根目录执行 dir / ls |
能看到 .claude/、demo/、scripts/ |
| Skills 可见 | 启动 claude 后询问有哪些 skills |
至少能识别项目级 skills |
| Demo 可读 | 让它解释 demo/老板的AI战略骗局/ |
能说明各阶段文件的作用 |
| 基础命令可跑 | 让它执行 git status 或 dir / ls |
能返回命令结果 |
如果这些都过了,就说明基础环境是正常的。
很多人会误以为:
- clone 了仓库 = 一定能跑完整流程
实际不是。
这个仓库的完整版依赖 4 层同时存在:
- skill 作为入口:
.claude/skills/ - agent 作为执行单元:
.claude/agents/ - workflow 作为协议:
.claude/workflows/ - scripts 作为底层工具:
scripts/
所以你必须做到:
- clone 完整仓库
- 在项目根目录启动
claude - 让这 4 层一起工作
少了其中一层,都不是完整链路。
现在仓库里多了一层运行时事实源:
claude-runtime/
维护逻辑变成:
- 开发时优先修改
claude-runtime/ - 然后同步生成项目兼容层
.claude/ - 再同步生成插件目录
plugins/writing-agent/
对应命令:
npm run sync:claude-runtime
npm run check:claude-runtime第一条负责同步,第二条负责检查有没有漂移。
这样可以避免后续出现:
git clone用户拿到的是新逻辑plugin用户拿到的还是旧逻辑
如果你在改运行时相关内容,例如:
skillsagentsstylesworkflowsscripts
那就不要只改 .claude/ 或 plugins/writing-agent/,而是优先改 claude-runtime/。
如果你是第一次接触这类工具,我建议按这个顺序来:
- 先看
demo/老板的AI战略骗局/ - 看明白
01_theme.md -> humanized_final_clean.txt这条链路 - 再决定你要走哪家模型和哪种费用方案
- 最后开始安装和配置
- 先装 Node.js
- 再装 Claude Code
- clone 仓库
- 配模型或账号
- 在项目目录启动
claude - 用 Demo 做第一轮验证
通常是:
- Claude Code 没装好
- PATH 没生效
- 终端没重开
处理方式:
- 重开终端再试
- 重新跑安装命令
- 再执行一次
claude --version
如果你在国内网络环境下访问 Anthropic 官方服务,可能需要代理。
macOS / Linux:
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890PowerShell:
$env:HTTPS_PROXY="http://127.0.0.1:7890"
$env:HTTP_PROXY="http://127.0.0.1:7890"如果你长期需要代理,把它写进你的 shell 配置里。
macOS / Linux 不要先上来就 sudo。
如果你走 Native Install 路线,先确认:
mkdir -p ~/.local/bin然后重新执行安装脚本。
如果你走的是 npm 安装路径,优先修正本地 Node/npm 权限,而不是直接把所有东西用 sudo 装。
优先排查这三件事:
- 你是不是在项目根目录启动的
claude .claude/skills/、.claude/agents/、.claude/workflows/、scripts/是否都在- 你的仓库是不是拉到了最新版本
这套系统不是只靠一个 Skill 跑起来的,它依赖完整目录和项目内启动。
先试:
claude update如果你更习惯沿用安装时的包管理方式,再用下面这些命令:
Native Install:
curl -fsSL https://claude.ai/install.sh | bashHomebrew:
brew upgrade --cask claude-codeWinGet:
winget upgrade Anthropic.ClaudeCode去 VS Code 扩展市场搜索 Claude Code,安装 Anthropic 官方扩展即可。
但建议先把 CLI 路线跑通,再切 IDE。
可以直接去 claude.ai/download 下载 Desktop App。
但这套仓库仍然建议你至少先把 CLI 跑通,因为项目目录上下文、skills、agents、workflows 的理解都更直接。
- 先看
demo/老板的AI战略骗局/,比先看安装说明更容易看懂项目价值。 DeepSeek-V3.2是默认推荐,不是因为它压过另外两家,而是因为它最适合低成本先把整套流程跑通。- 完整版一定要在项目根目录启动 Claude Code,最后默认交付的是
_clean.txt,并可按需额外导出公众号排版.html。