先看一个完整样本

如果你只想先判断这个仓库值不值得收藏，不要先看安装，先看这个真实样本：

demo/老板的AI战略骗局/

这不是只放一篇成品，而是把整条写作链路都放出来了，包括：

• 选题和约束：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：老板的AI战略骗局

下面不是虚构示例，是这个仓库里一篇真实跑完的文章项目。

• 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

最新更新

首页只保留当前主线版本，历史版本不再堆在前面。

v0.7.7 新增公众号排版 HTML 导出

• 新增 html-exporter 末端导出器：最终 Markdown 定稿后，可以额外导出一份适合公众号排版和复制的 .html
• 内置 4 种默认版式可选：经典正文（default）、精致长文（grace）、极简评论（simple）、现代杂志（modern）
• 保留 _clean.txt 作为默认纯文本出口：你可以只拿纯文本，也可以同时拿纯文本和排版 HTML
• 收紧 Stage 12.5 契约、运行态记录和回归测试，让“是否导出 HTML、选择哪种版式”变成真实流程，而不是 prompt 口头约束

如果你关心的是“最后到底能交付什么”，这一版的答案很直接：正文、可直接复制的 _clean.txt、可选的公众号排版 .html，都能稳定落地。

v0.7.6 深化生产骨架

• research-expert 从泛泛调研改成“伤疤打捞”，核心产物是 02_scar_tissue.md
• empathy-designer 从共情点设计升级成“社交转发动机”，核心产物是 04_share_map.md
• 新增 opening-tournament，在正式写稿前先赛马开头，核心产物是 05c_opening_hook.md

如果你只想知道仓库现在值不值得拉下来试，先看 v0.7.7 这 3 条就够了。更老的版本记录去 CHANGELOG 或 Releases 看，不应该堵在首页前面。

模型与 Coding Plan

这个项目不一定非要跑 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 写作工具有什么不一样

普通 AI 写作：

• 一次性生成全文
• 改一轮就开始漂
• 风格、结构、审稿全混在一个大 prompt 里
• 很难知道文章为什么好，为什么差

写稿Agent：

• 先定主题和立场
• 再打捞场景、代价和细节
• 再做大纲、分享触点、具象化和开头赛马
• 写完后还有主编审稿、发布前评审、微信传播测试、去 AI 味
• 最后输出 _clean.txt 终稿，并可按需额外导出公众号排版 .html

一句话说：

它不是“让 AI 帮你写一篇文章”，而是“把写作拆成可调度、可中断、可复盘的流程”。

适合谁，不适合谁

适合：

• 写公众号文章、长文观点文、行业评论的人
• 对“AI 味”“结构松”“标题软”“开头弱”敏感的人
• 想把 AI 写作纳入稳定工作流的人

不适合：

• 只想一句话秒出 300 字短文的人
• 不关心中间产物、只关心快的人
• 不想做任何确认和审稿的人

完整版安装

完整版不是只靠一个 Skill 在跑，它依赖整个仓库一起工作：

• .claude/skills/
• .claude/agents/
• .claude/workflows/
• scripts/

最短路径：

1. 先准备 Node.js 18+ 和 Claude Code
2. clone 本仓库
3. 配好你要用的模型 API 或 Claude 账号
4. 一定在项目根目录启动 claude
5. 先用 demo/老板的AI战略骗局/ 理解流程，再开始正式写作

如果你已经准备直接跑完整版，继续看：

• 给新手的完整安装与使用说明

现在有两种交付路径

从这一版开始，这个项目同时支持两种使用方式：

| 方式 | 适合谁 | 运行根目录 | |------|------|------| | git clone 仓库 | 想直接拿完整项目、看 demo、参与开发的人 | 仓库根目录 | | plugin 安装 | 不想先 clone 仓库，只想在任意工作目录里使用工作流的人 | 你的当前工作目录 |

两条路径的底层运行时现在共用一套事实源：

• claude-runtime/

然后再分别同步到：

• 项目兼容层：.claude/
• 插件目录：plugins/writing-agent/

如果你是 git clone 用户

用法不变：

1. clone 仓库
2. 在仓库根目录启动 claude
3. 继续按项目内 .claude/、scripts/、demo/ 这套方式使用

如果你是 plugin 用户

插件模式的目标是：

• 安装插件后，不需要先 clone 这个仓库
• 在任意正常工作目录启动 claude
• 插件会通过工作区自举脚本补齐最小运行目录

当前仓库里已经包含插件骨架：

• plugins/writing-agent/
• .claude-plugin/marketplace.json

安装方式只保留最简单这一条。

假设仓库地址就是：

• dongbeixiaohuo/writing-agent

那用户只需要执行：

1. 添加 marketplace

claude plugin marketplace add dongbeixiaohuo/writing-agent

2. 安装插件

claude plugin install writing-agent@writing-agent-marketplace

3. 重新加载插件

/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

为什么 Node.js 还要讲

这点必须说清楚。

Anthropic 当前文档仍把 Node.js 18+ 作为 Claude Code 的系统要求。对这个仓库来说，提前准备好 Node.js 也仍然是最稳的做法，原因有两个：

• 如果你后面想走 npm 路线安装、升级或调试 Claude Code，Node.js 是硬前置
• 这个仓库本身带了 package.json 和一些基于 Node 的脚本、工具链，后面你大概率还是会用到 node / npm

所以最稳的建议是：

• 先装好 Node.js 18+
• 再装 Claude Code
• 最后 clone 仓库并启动项目

Node.js 怎么装

Windows：

• 官网下载安装：nodejs.org
• 或者直接用 WinGet：

winget install OpenJS.NodeJS.LTS

macOS：

• 官网安装包
• 或者：

brew install node

Linux：

• 推荐用 nvm
• 或者用你发行版自己的包管理器

装完先验证：

node --version
npm --version

能看到版本号，再继续下一步。

Claude Code 怎么装

macOS / Linux

打开终端，运行：

curl -fsSL https://claude.ai/install.sh | bash

这个脚本会自动下载 Claude Code，并把 claude 命令放到你的 PATH 里。

如果你是 Homebrew 用户，也可以直接：

brew install --cask claude-code

装完验证：

claude --version

Windows

Windows 这里建议按“Git for Windows + WinGet”这条路走。

1. 先装 Git for Windows

从 git-scm.com 下载也可以，直接 WinGet 更省事：

winget install --id Git.Git -e

它会顺带给你 Git Bash。Claude Code 在 Windows 上需要这类 Unix 工具链支持，所以这一步不要跳。

2. 安装 Claude Code

winget install --id Anthropic.ClaudeCode -e

如果你不用 WinGet，也可以改走官方 PowerShell 安装脚本：

irm https://claude.ai/install.ps1 | iex

3. 验证安装

重新打开 PowerShell 或 Git Bash，运行：

claude --version

看到版本号就说明装好了。

4. Windows 使用建议

• 推荐用 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 官方订阅

如果你打算直接用 Claude 官方账号，常见档位是：

| 方案 | 当前常见价格 | 适合谁 | |------|------|------| | Pro | $20/月 | 轻量使用、学习、个人开发 | | Max 5x | $100/月 | 高频使用、每天长时间对话 | | Max 20x | $200/月 | 重度使用、多人或商业项目 |

这组价格和额度变动比较快，最终以 Anthropic 官方页面为准。

简单选法：

• 你只是想先体验 Claude 官方服务：先从 Pro 开始
• 你每天都在用，或者很容易撞额度：再升 Max 5x
• 你是团队或商业重度使用：再看 Max 20x

这个仓库更常见的实际路径

对这个项目来说，更常见的用法其实是：

• 用 Anthropic 兼容接口
• 接 DeepSeek-V3.2、智谱 GLM、MiniMax 这类第三方模型
• 用更低成本把长链路写作流程跑通

所以你不用把“Claude 官方订阅”和“第三方模型 API”理解成二选一。

模型和成本怎么选

这个项目的模型选择逻辑，不是“谁绝对最强”，而是“谁更适合你的使用方式”。