写稿Agent v0.7.5

🚀 一个基于 Claude Code Skills + Subagents 的全栈写作系统。

不仅是写作，更是打磨进化：

• 🧠 自进化架构：首次引入采样编译闭环，能记住修改偏好并复用，越用越顺手。
• 🤖 反AI味写作：从选题到初稿，源头遏制 AI 腔调。
• 🧬 深度 Humanizer：注入人类观点、细节与灵魂，彻底去除机器味。
• 🎨 文章配图师：自动设计视觉风格，生成并植入高质量配图。
• 📺 真实读者模拟：模拟真实用户的"心理弹幕"与"朋友圈转发"，只为了检验传播力。

支持 DeepSeek / 智谱GLM / MiniMax 等多种国产大模型，兼容 OpenAI/Gemini 接口，成本极低（使用包月套餐几可忽略不计）。

从选题生成、风格建模、写作执行到发布评审与配图，提供完整的 AI 写作工作流。

🎯 项目简介

写稿Agent 是一个协作式写作工作流系统，通过强制性的模式选择、需求澄清、风格建模、素材调研和主编审稿，帮助你写出不像AI生成的高质量文章。

v0.7.5 锋利度与互动流强化 ⭐ New

• 🔪 6刀底层重构：引入 position-engine (Stage 1.5) 强制锁定立场，洗去默认程序员/互联网偏见；摒弃“空洞金句”，定义带有“代价、场景与判断”的真实金句；允许大纲执行时“局部失控”以增强真人口吻。
• 🛑 强制互动中断机制：在工作流导演中注入 Yield/Stop 强拦截器，彻底解决大模型 auto-pilot 的过度自治越权问题。强行限制大纲、标题、一稿审改和社交测试 4 个核心节点，必须经用户真实确认后才允许向下推演。
• 📱 微信社交传播测试：将头条系算法推荐测评全面升级为 wechat-reader-test，专注检验防杠精表现、亲友圈人设匹配和社交点赞动机。

v0.7.0 系统自进化双轴架构

• 🔄 自动复盘与经验装载：引入 edit-diff-learner 和 memory-loader。系统会自动对撞定稿与初稿提炼写作经验（15维风格DSL），并在下次写作前编译记忆包 (00_memory_packet.md)，注入到大纲、标题、执行和去AI味 Agent 中，实现"长记性"。
• ⚙️ 自动化物理排版 Hook：利用 Claude Code Hooks 机制跳出大模型约束，在工作流大结局通过 auto_clean_hook.py 静默生成排版纯净版 _clean.txt。

v0.6.4 技能结构优化

• 🔧 Progressive Disclosure 架构升级：应用 Skill Creator 最佳实践，大幅提升技能加载效率。
• 📉 Token 使用优化：公众号文章获取技能从 1238 行精简至 ~200 行，Token 消耗减少 85%。
• 📚 文档结构化：核心流程保留在 SKILL.md，详细说明拆分到 references 目录，按需加载。
• 📖 调用示例增强：工作流导演新增完整的 Agent 工具调用示例，提升可执行性。

v0.6.3 去AI味专家进阶升级

• ⚖️ 50分制质量自评：加入严苛输出把控，强迫 AI 根据五大维度自评，低于 40 分内部打回重写。
• 🚫 致命黑名单词库：精准打击“此外”、“至关重要”、“织锦”、“格局”等典型机器生成的“塑料词汇”。
• ⚡ 快速排雷自检 (Quick Check)：强制打断 AI 常见的“三段式强迫症”、“等长句式”和“无聊排比”。
• ❤️ 全新注入灵魂指令：通过引入具体生活细节、强加第一人称时局感、甚至刻意的逻辑混乱，赋予文本真正的强人设观感。

v0.6.0 去AI味与真实模拟

• 🤖 Humanizer 去AI味专家：基于 Wikipedia AI Cleanup 项目，识别并修复24种AI痕迹（内容/语言/风格），注入人类"灵魂"。
• 🎨 Article Illustrator 文章配图师：为文章自动设计视觉风格并生成高质量配图（封面/插图/概念图）。
• 📺 读者模拟器 v3.0 直播版：模拟真实读者的"直播现场"——心理弹幕、朋友圈截图预览。

v0.5.1 审稿质量增强

解决"打分就过"的问题，所有评审环节必须给出可执行的修改方案并等待用户确认：

• 🎯 标题设计师 v2.0：15种爆款公式（分6大类）+ 5个候选 + 钩子说明
• ✅ 发布前评审 v2.0：每个问题都有「原文→改为」的修改方案 + 用户确认
• ✅ 读者模拟 v2.1：具体修改建议 + 可自动执行修改 + 修改后重新测试
• 🔒 强制用户确认：不会再出现"打分就直接过去"的情况

v0.5.0 重大架构升级

引入 Subagent 模式，实现上下文隔离：

• 🔄 12 个执行步骤改为独立 Subagent，每个任务独立上下文
• 📁 信息通过文件传递，不依赖对话上下文，避免 Token 累积
• 🎯 工作流导演 Skill 显式调用 Subagent，保持用户交互能力
• 💾 每阶段产物自动落盘，支持断点续写

核心特点

• ✅ 自进化归因引擎：系统自动追溯初稿与定稿差异，抽取经验打包成 99_episode.md 实现跨次记忆 ✨ v0.7.0 New
• ✅ 无痕排版 Hook：自动拦截大模型生成结果，利用纯 Python 正则脚本清除底噪，实现公众号直接粘贴 ✨ v0.7.0 New
• ✅ 超大编制 Subagent 架构：16 个独立 Subagent 实现上下文完美隔离，将漫长的写作长链路切碎，节省海量 Token
• ✅ 深度协作工作流：全 14 阶段创作者模式，囊括盘前准备、记忆装载、素材分析到模拟直播的全链条闭环
• ✅ 强制去 AI 味道：Humanizer与24条红线规则，自动去除小标题病、排比上瘾、过度升华等AI特有文风
• ✅ 风格建模 v3.1：支持公众号 URL 自动抓取分析、批量多篇拆解、增量汇入语料库
• ✅ 共情点与标题设计：提供15类标题公式套件和5个候选方案，强制规划读者情绪跳动周期
• ✅ 全景素材调研：不仅梳理网络数据，还进行结构论证、爆款拆解与痛点验伪
• ✅ 读者实况沙盘：上线前模拟发出后的心理弹幕、真话吐槽以及朋友圈转发文案 ✨ v0.6.0
• ✅ Article Illustrator：跨端联动生图大模型，为文章生成带情绪的视觉风格匹配插图 ✨ v0.6.0
• ✅ 严苛自裁机制：评分系统与强制追问交叉质检，发现敷衍输出直接发回给重构引擎，杜绝烂尾

📚 什么是 Claude Code Skills 和 Subagents？

Skills 与 Subagents 的区别

本项目的架构（v0.7.5）

本项目采用 Skills + Subagents 混合架构：

.claude/
├── skills/                     # 语义触发（3个）
│   ├── 工作流导演/             # ⭐ 核心调度器（调用所有 Subagent）
│   ├── 公众号文章获取/         # 独立工具（检测到URL自动触发）
│   └── 风格建模/               # 独立工具（"学习这个风格"触发）
│
└── agents/                     # 显式调用，上下文隔离（16个编外专员）
    │
    ├── ── Stage 0-X: 记忆引擎 ──
    ├── memory-loader.md        # 记忆装载器 ✨ v0.7.0 New
    ├── edit-diff-learner.md    # 归因溯源与经验萃取 ✨ v0.7.0 New
    │
    ├── ── Stage X: 选题库系统 ──
    ├── topic-generator.md      # 选题生成器
    ├── topic-research.md       # 选题深度剖析
    │
    ├── ── Stage 1-5: 策划定调 ──
    ├── writing-clarifier.md    # 澄清需求与受众边界
    ├── research-expert.md      # 调研资料池聚合
    ├── outline-architect.md    # 逻辑大纲搭建
    ├── empathy-designer.md     # 共情点/阅读心流设计
    ├── concretizer.md          # 具象化特写与翻译
    ├── title-designer.md       # 标题爆款设计与敲定
    │
    ├── ── Stage 6: 原创下笔 ──
    ├── writing-executor.md     # 原生撰写执行
    │
    ├── ── Stage 7-11: 审核防呆与升华 ──
        ├── editor-review.md        # 主编初审筛雷
        ├── pre-publish-review.md   # 发布前终级追问反馈
        ├── toutiao-reader-test.md  # 读者群体模拟直播
        ├── humanizer.md            # 去AI病理净化/灵魂注入
        └── article-illustrator.md  # 高维情绪插图配图师

工作流程示意

用户请求 → [工作流导演 Skill] 介入指挥调度
    │
    ├──→ "使用 memory-loader ... " → 将前世经验带入本期 00_memory_packet.md ✨ New
    │
    ├──→ "使用 outline-architect ... " → 输出带目标的 03_outline.md
    │
    ├──→ "使用 writing-executor ... " → 注入规则与大纲产出 draft_v1.md
    │
    ├──→ "使用 humanizer ...." → 高压驱魔产出 _humanized.md
    │
    ├──→ 自动触发 [Hook: auto_clean_hook.py] 暴力排版净化 ✨ New
    │
    └──→ "使用 edit-diff-learner ... " → 碰撞首尾得出下一期的 99_episode.md 宝贵财富 ✨ New

每个 Subagent：

• ✅ 干净的上下文，从 0 开始
• ✅ 必须从文件读取前序信息
• ✅ 只返回摘要给主导演，不传递完整文本
• ✅ 独立隔离，避免 Token 累积

Skills 自动加载机制

重要说明：

1. 克隆项目后，Skills 已经在项目目录里了

   • 项目文件结构：writing-agent/.claude/skills/（包含 13 个 Skills）
   • 这些 Skills 是项目的一部分，随项目一起下载

2. 必须在项目目录中启动 Claude Code

   cd writing-agent        # 先进入项目目录
   claude                  # 再启动 Claude Code
   

   ⚠️ 关键：Claude Code 只会加载当前目录下的 .claude/skills/

   • ✅ 正确：在 writing-agent/ 目录中启动 → Skills 自动加载
   • ❌ 错误：在其他目录启动 → Skills 不会被加载

Claude Code 的 Skills 加载规则：

1. 全局 Skills 目录：~/.claude/skills/（所有项目都能用）
2. 项目 Skills 目录：项目根目录/.claude/skills/（仅当前项目可用）

本项目采用"项目级 Skills"，这意味着：

• ✅ 克隆项目后，Skills 已经在项目目录中（无需手动复制）
• ✅ 在项目目录中启动 Claude Code，Skills 自动可用
• ✅ 不会污染你的全局 Skills 目录
• ✅ 多个项目的 Skills 互不干扰

如果你想让这些 Skills 在所有项目中都能用：

Windows (PowerShell):

xcopy /E /I ".claude\skills" "$env:USERPROFILE\.claude\skills"

Linux/macOS:

cp -r .claude/skills/* ~/.claude/skills/

📦 快速开始

前置要求

方式一：使用 Claude 官方模型

• Claude Code 账号
• 基本的命令行操作能力

方式二：使用国产大模型（推荐，更经济）

本项目支持通过 Anthropic API 兼容接口接入多种国产大模型。根据使用频率，可选择按量付费或包月套餐：

按量付费模型（适合偶尔使用）

本项目所有测试均基于 DeepSeek-V3 模型完成。 一篇 2000 字文章成本约 ¥0.03，性价比极高。

💰 Coding Plan 包月套餐（适合频繁使用，强烈推荐）

如果你需要频繁使用本项目，包月套餐成本几乎可以忽略不计。以下是主流平台对比：

💡 如何选择：

• 偶尔使用（每月 < 10 篇文章）：推荐 DeepSeek-V3 按量付费，成本极低
• 轻度使用（每月 10-50 篇）：推荐 阿里云百炼 Lite（首月 ¥7.9）或 火山引擎 Lite（首月 ¥9.9）
• 中度使用（每月 50-200 篇）：推荐 无问苍穹 Lite（¥19.9 特惠）或 MiniMax Starter（¥29/月）
• 重度使用（每月 > 200 篇）：推荐 阿里云百炼 Pro 或 无问苍穹 Pro

配置方式： 所有 Coding Plan 套餐订阅后会获得专用 API Key，配置方式与按量付费模型完全相同（参考下方步骤 5）。

安装步骤（新手友好版）

本指南以 Windows 系统为主，同时提供 Linux/macOS 的对应说明。

步骤 1：安装 Node.js 环境

Claude Code 需要 Node.js 18 或更高版本才能运行。

方法一：官网下载（推荐）

1. 打开浏览器访问 https://nodejs.org/
2. 点击 "LTS" 版本进行下载（长期支持版本，版本号需 ≥ 18）
3. 下载完成后双击 .msi 文件
4. 按照安装向导完成安装，保持默认设置即可
5. 安装完成后，打开 PowerShell（推荐）或 CMD，输入以下命令验证：

   node --version
   npm --version
   

   如果显示版本号（如 v20.x.x 和 10.x.x），说明安装成功！

方法二：使用包管理器

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

Windows 注意事项：

• ⚠️ 建议使用 PowerShell 而不是 CMD（功能更强大）
• ⚠️ 如果遇到权限问题，尝试以管理员身份运行 PowerShell
• ⚠️ 某些杀毒软件可能会误报，需要添加白名单

Ubuntu/Debian:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

macOS (使用 Homebrew):

brew install node

验证安装：

node --version
npm --version

步骤 2：克隆项目到本地

1. 打开 PowerShell
2. 进入你想存放项目的目录，例如：

   cd D:\Projects
   

3. 克隆项目：

   git clone https://github.com/dongbeixiaohuo/writing-agent.git
   cd writing-agent
   

如果没有安装 Git：

• 下载安装：https://git-scm.com/download/win
• 或者直接从 GitHub 下载 ZIP 文件并解压

cd ~/Projects  # 或你想存放的目录
git clone https://github.com/dongbeixiaohuo/writing-agent.git
cd writing-agent

步骤 3：安装 Claude Code

1. 打开 PowerShell（建议以管理员身份运行）

2. 运行以下命令全局安装 Claude Code：

   npm install -g @anthropic-ai/claude-code
   

   如果下载速度慢，可以使用国内镜像：

   npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
   

3. 验证安装：

   claude --version
   

   如果显示版本号，说明安装成功！

更新 Claude Code：

claude update

npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

步骤 4：验证 Skills 是否正确加载

在配置 API 之前，先验证项目的 Skills 是否在正确的位置。

1. 打开 PowerShell
2. 进入项目目录：

   cd D:\Projects\writing-agent  # 替换为你的实际路径
   

3. 检查 Skills 目录：

   Get-ChildItem -Path ".claude\skills" -Directory
   

4. 预期输出：应该看到 13 个 Skills 目录

   工作流导演
   选题生成器
   选题调研
   澄清写作需求
   风格建模
   调研资料
   大纲架构师
   共情点设计师
   具象化专家
   标题设计师
   写作执行
   主编审稿
   发布前评审
   

如果没有看到这些目录：

• 检查是否正确克隆了项目（确认使用了 git clone 而不是只下载了部分文件）
• 确认 .claude 目录没有被意外删除

cd ~/Projects/writing-agent  # 替换为你的实际路径
ls -la .claude/skills/

应该看到 13 个 Skills 目录。

✅ 验证通过后，继续下一步配置 API。

步骤 5：配置第三方 API（推荐 CC-Switch 可视化工具）

本项目支持通过 Anthropic API 兼容接口接入多种第三方模型。

🔥 首选推荐：使用跨平台可视化管理工具 CC-Switch（完全免费）

如果你不想折腾命令行和环境变量，或者需要频繁在 DeepSeek、智谱、Minimax 等多个 API 之间切换，强烈推荐 CC-Switch。
这是一款专为 Claude Code 以及同类 CLI 工具设计的桌面全能网关，支持 Windows/macOS/Linux。

核心优势：

• 🔄 一键切换：图形化界面配置 API Key，点一下鼠标即可无缝切换不同的大模型，免去所有修改环境变量的烦恼。
• 📦 自动拉取：可视化安装与管理各种 MCP 服务器、Prompt 和 Skills。
• 📊 多语言与统计：自带用量追踪，API 成本一目了然；支持完整的本地多流管理。

获取方式： 前往 CC-Switch Releases 下载对应系统的安装包即可。

如果由于某些原因你无法使用 UI 工具，可以通过以下传统的纯代码/命令行方法进行手动配置：

你需要手动准备的信息：

• API_BASE_URL：第三方 API 的基础地址（如 https://api.example.com/v1）
• API_KEY：你的 API 密钥（从第三方平台获取）

这是最稳定的配置方式，配置一次永久生效。

Windows 操作：

1. 打开文件资源管理器，在地址栏输入：

   %USERPROFILE%\.claude
   

   如果文件夹不存在，手动创建它。

2. 在该文件夹下创建文件 settings.json（如果已存在则直接编辑）

3. 用记事本或 VS Code 打开 settings.json，填入以下内容：

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
       "ANTHROPIC_BASE_URL": "https://api.example.com/v1",
       "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
     }
   }
   

4. 替换示例值：

   • 将 "你的API密钥" 替换为你从第三方平台获取的实际 API Key
   • 将 "https://api.example.com/v1" 替换为第三方 API 的实际地址

5. 保存文件

Linux/macOS 操作：

# 创建配置目录（如果不存在）
mkdir -p ~/.claude

# 编辑配置文件
nano ~/.claude/settings.json

填入相同的 JSON 内容，保存后退出（Ctrl+X → Y → Enter）。

配置文件路径说明：

• Windows: C:\Users\你的用户名\.claude\settings.json
• Linux/macOS: ~/.claude/settings.json

这种方法会将配置写入系统环境变量，重启后仍然有效。

在 PowerShell 中运行：

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.example.com/v1", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)

验证设置：

# 查看环境变量
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", [System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", [System.EnvironmentVariableTarget]::User)

⚠️ 注意： 设置后需要重新打开 PowerShell 窗口才能生效。

这种方法只在当前 PowerShell/终端会话中有效，关闭窗口后失效。

Windows (PowerShell):

$env:ANTHROPIC_BASE_URL = "https://api.example.com/v1"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

Linux/macOS (Bash/Zsh):

export ANTHROPIC_BASE_URL="https://api.example.com/v1"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

验证设置：

# Windows PowerShell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

# Linux/macOS
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

具体模型配置示例：

如果你使用的是本项目推荐的模型，可以参考以下配置：

• DeepSeek-V3: 参考 接入文档
• 智谱 GLM: 参考 接入文档
• MiniMax: 参考 接入文档

步骤 6：启动 Claude Code

1. 打开 PowerShell
2. 进入项目目录：

   cd D:\Projects\writing-agent  # 替换为你的实际路径
   

3. 启动 Claude Code：

   claude
   

4. 首次启动会进行初始化，按照提示完成设置

cd ~/Projects/writing-agent  # 替换为你的实际路径
claude

步骤 7：开始使用并验证 Skills

启动成功后，先验证 Claude Code 是否识别了项目的 Skills。

验证 Skills 加载：

1. 在 Claude Code 对话中输入：

   你能看到哪些 Skills？
   

2. Claude 应该会列出所有可用的 Skills，包括：

   • workflow-producer（工作流导演）
   • topic-generator（选题生成器）
   • topic-research（选题调研）
   • 等等...

如果 Claude 没有识别到 Skills：

• 参考下方的"常见问题排查"部分

开始使用：

验证通过后，直接对 Claude 说：

帮我写一篇关于XXX的文章

系统会自动引导你完成整个写作流程！

常见问题排查

原因： Claude Code 未正确安装或未添加到系统 PATH

解决方法：

1. 重新运行安装命令：npm install -g @anthropic-ai/claude-code
2. 检查 npm 全局安装路径是否在 PATH 中：

   npm config get prefix
   

3. 重启 PowerShell/终端

原因： API Key 配置错误或未生效

解决方法：

1. 检查 settings.json 文件中的 API Key 是否正确
2. 确认 API Base URL 是否正确
3. 如果使用环境变量，重启 PowerShell 后重试
4. 验证环境变量是否生效（参考上面的验证命令）

原因： PowerShell 执行策略限制

解决方法：
以管理员身份运行 PowerShell，执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

原因： Claude Code 可能没有正确扫描项目目录

解决方法：

1. 确认 Skills 目录存在：

   # Windows
   Test-Path ".claude\skills"
   
   # Linux/macOS
   ls -la .claude/skills/
   

2. 确认在项目目录中启动 Claude Code：

   # 必须先 cd 到项目目录
   cd D:\Projects\writing-agent
   
   # 然后再启动
   claude
   

   ⚠️ 重要：Claude Code 只会加载当前目录下的 .claude/skills/，如果你在其他目录启动，Skills 不会被加载。

3. 重启 Claude Code：

   • 完全退出 Claude Code（输入 exit 或按 Ctrl+C）
   • 确认在项目目录中
   • 再次启动 claude

4. 手动复制到全局目录（如果项目级 Skills 无法加载）：

   # Windows
   xcopy /E /I ".claude\skills" "$env:USERPROFILE\.claude\skills"
   
   # Linux/macOS
   cp -r .claude/skills/* ~/.claude/skills/
   

   复制到全局目录后，Skills 在所有项目中都可用。

5. 验证 Skills 加载：
   对 Claude 说："列出所有可用的 Skills" 或 "你能看到哪些 Skills？"

🚀 使用示例

协作写作流程（全 14 阶段系统闭环）

你："我想写一篇关于35岁程序员危机的深度分析文章，3000字"
    ↓
Claude 会引导你：

🎬 请选择工作流模式：
【A. 轻量模式】快速产出
【B. 协作模式】深度创作 ⭐ 推荐

你选择 B（协作模式）后：

📋 完整工作流：
□ Stage 0: 🧠 经验装载 (记忆编译) ✨ v0.7.0 New
   - 读取过往 `99_episode.md` 修正历史
   - 生成 `00_memory_packet.md` 作为写作铁律
   
□ Stage 1: 主题与读者校准
   - 选择切入方向（A/B/C）
   - 确认受众、风格、字数
   
□ Stage 2: 案例与证据池
   - 搜集真实数据、案例
   
□ Stage 3: 逻辑骨架搭建
   - 设计文章结构
   - 标注每段功能
   
□ Stage 4: 共情点设计
   - 预测读者心理路径
   - ⚡ 强化开头钩子设计
   
□ Stage 5: 🧱 具象化翻译
   - 将抽象理论转化为带特写镜头的画面
   
□ Stage 5.5: 标题设计 ⭐ 必须
   - 设计3个候选标题让你选择
   - ⚡ 植入爆款标题公式
   
□ Stage 6: ✍️ 正式创作
   - 前往原生初稿（draft_v1.md）
   - ⚡ 强制阅读 Stage 0 记忆包
   
□ Stage 7: 主编审稿与改稿
   - 重点检查AI味道
   - 输出修订稿

□ Stage 8: 发布前把关 ✨ New
   - 发布前5问评审（标题/开头/认同/出路/分享）
    ↓
□ Stage 9: 读者模拟直播 ✨ New
   - 心理弹幕/真话吐槽/朋友圈现场
   
□ Stage 10: 最终去AI味 ✨ New
   - 深度扫描24种AI痕迹
   - 注入观点与灵魂
   
□ Stage 11: 🎨 视觉增强 (可选) ✨ New
   - 视觉风格设计 (Flat/Lofi/Cyberpunk)
   - 自动生成 3-5 张配图并植入

□ Stage 12: 📤 终局排版 Hook ✨ v0.7.0 New
   - 脱离 LLM，通过后台正则自动洗版
   - 生成完全排版干净的 `_clean.txt`

□ Stage 13: 🔄 经验归因蒸馏 ✨ v0.7.0 New
   - 自动回溯对撞成稿与初稿修改历史
   - 提取新约束沉淀至 `99_episode.md`，用于未来的长记性学习

如何为文章配图

如果在写作流程中没有生成配图，你可以随时手动调用 article-illustrator 子代理：

/slash-command 使用 article-illustrator 子代理为 articles/[项目名]/draft_vX.md 生成配图

工作模式：Agent 会先根据文章内容输出一份配图策划书（Prompt 清单），请务必检查并确认（或修改），确认后 Agent 才会批量执行生成并植入图片。

支持的模型：默认使用 Google Gemini Image 模型，无需额外配置。

风格建模详细教程

### 风格建模详细教程

**方式一：直接贴文章内容**

你："帮我分析这篇文章的风格：

[直接粘贴文章全文]

以后按这个风格写。"

**方式二：使用 @ 引用文件**

你："帮我分析 @sample_article.md 的风格，以后按这个风格写"

**方式三：提供多篇参考文章（推荐，更准确）**

你："帮我分析这几篇文章的共同风格：
@article1.md
@article2.md
@article3.md

提取共性，保存为'XXX风格'"

**方式四：URL 一键学习（🔥 强力推荐）**

你："学一下这几篇公众号文章的风格：
https://mp.weixin.qq.com/s/xxxx
https://mp.weixin.qq.com/s/yyyy

如果作者已经在风格库里，就更新它的风格文件。"

👉 Claude 会自动：

1. 打开浏览器抓取正文（自动绕过微信反爬）
2. 将文章保存到 docs/ 文件夹归档
3. 如果是新作者 -> 建新档
4. 如果是老作者 -> 融合新特征，更新旧档

**风格建模过程（v3.0 - 15维度）：**

提供样本文章
↓
Claude 会：

1. 深度解构15个维度：
   • 作者画像与核心人格 ✨ 新增
   • 思维内核与论证逻辑 ✨ 升级
   • 创作路径还原 ✨ 新增
   • 互动设计 ✨ 新增
   • 开头/过渡/结尾模式
   • 句式与节奏
   • 词汇指纹（5类细分）✨ 升级
   • 修辞手法
   • 格式与排版
   • 独特习惯与招牌动作（5类细分）✨ 升级
   • 反AI特征
   • 典型段落模板
   • 禁忌清单
2. 提取"招牌动作"（最具辨识度的写作习惯）
3. 保存风格文件到 .claude/styles/XXX风格.md
   ↓
   下次写作时可以直接调用这个风格

**最佳实践：**
- 样本文章建议 3000 字以上，效果更好
- 提供 3-5 篇同一作者的文章，提取的风格更准确
- 风格文件可以手动编辑，补充或调整特征

## 📚 核心 Skills 说明

| Skill | 功能 | 调用时机 |
|-------|------|---------|
| `workflow-producer` | 工作流导演 | 所有写作请求的唯一入口 ⭐ |
| `topic-generator` | 选题生成器 | 不知道写什么时，从0生成候选选题 ✨ New |
| `topic-research` | 选题调研 | Stage 0: 动笔前的热点与痛点验证 ✨ New |
| `writing-clarifier` | 澄清写作需求 | Stage 1: 主题与读者校准 |
| `research-expert` | 调研素材 | Stage 2: 案例与证据池 |
| `outline-architect` | 大纲架构师 | Stage 3: 逻辑骨架搭建 |
| `empathy-designer` | 共情点设计师 | Stage 4: 共情点设计 |
| `concretizer` | 具象化专家 | Stage 5: 具象化翻译（按需）|
| `title-designer` | 标题设计师 | Stage 5.5: 标题设计（含爆款公式）✨ Upgrade |
| `writing-executor` | 写作执行 | Stage 6: 正式创作（含开头钩子）✨ Upgrade |
| `editor-review` | 主编审稿 | Stage 7: 主编审稿与改稿 |
| `pre-publish-review` | 发布前评审 | Stage 8: 发布前5问把关 ✨ New |
| `style-modeler` | 风格建模 | URL提取/批量建模/增量更新 ✨ Upgrade |

## 🎨 风格库示例

项目自带四个风格示例：

### 1. 墨水怪风（`.claude/styles/墨水怪风.md`）
- **核心人格**：愤世嫉俗但真诚的毒舌老哥
- **招牌动作**：悖论翻转、质疑打断、真诚骂人
- **特色词汇**：兽性、进化心理学、巴甫洛夫
- **适用场景**：观点文、批判性分析

### 2. 九边风（`.claude/styles/jiubian.md`）
- **核心人格**：职场老炮式人生导师
- **招牌动作**："那问题来了"、案例故事化、承认局限
- **分析模式**：现象→机制→人性→出路
- **适用场景**：职场分析、深度解读

### 3. 老总在人间风（`.claude/styles/老总在人间.md`）✨ 新增
- **核心人格**：看透职场和人性的"老油条"
- **招牌动作**："拖出去砍了"夸张式反驳、【】强调金句、直白揭露
- **特色表达**：刻在骨髓里、本金风险、知识付费推广
- **适用场景**：职场真相揭露、务实建议、知识付费内容

### 4. sanbiaobiao风（`.claude/styles/sanbiaobiao.md`）✨ 新增
- **核心人格**：看透内容产业规律的媒体老兵
- **招牌动作**：反常识开场、具体化对比、知识结构决定论
- **特色表达**："喂,等等,不对劲啊"、一手资料vs二道贩子、鼻子上长了个洋鸡蛋
- **适用场景**：内容行业观察、产品评论、理解式批判

你可以基于任何文章创建自己的风格库。

## 📖 详细文档

- [协作写作工作流快速参考](docs/WORKFLOW_QUICK_REFERENCE.md) ⭐ 新增
- [Skills 更新总结](docs/SKILLS_UPDATE_SUMMARY.md) ⭐ 新增
- [DeepSeek API 配置指南](docs/DEEPSEEK_SETUP.md) ⭐ 推荐
- [Skills 开发指南](.claude/skills/)
- [风格建模教程](.claude/skills/风格建模/SKILL.md)
- [常见问题 FAQ](docs/FAQ.md)
- [项目结构说明](docs/PROJECT_STRUCTURE.md)

## 🛠️ 高级配置

### 自定义反AI规则

编辑 `.claude/skills/写作执行/SKILL.md` 中的"反AI写作技巧"部分，添加你自己的规则。

### 调整字数控制精度

编辑 `.claude/skills/写作执行/SKILL.md` 中的"字数控制"部分，修改允许范围（默认±20%）。

### 自定义工作流阶段

编辑 `.claude/skills/工作流导演/SKILL.md`，可以调整协作模式的阶段顺序或跳过某些阶段。

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📝 更新日志

查看 [CHANGELOG.md](CHANGELOG.md) 了解版本历史。

**最新版本 v0.2.0 (2025-12-29)**
- ✨ 风格建模升级至 v3.0（15维度）
- ✨ 新增协作写作工作流（8阶段）
- ✨ 新增标题设计师 Skill
- ✨ 新增九边风、墨水怪风两套风格配方
- 🔧 强制模式选择机制
- 🔧 子 Skill 权限调整

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。

## 🙏 致谢

- 感谢 [Claude Code](https://code.claude.com) 提供的 Skills 系统
- 感谢所有贡献者和使用者的反馈

## 📮 联系方式

- 提交 Issue: [GitHub Issues](https://github.com/dongbeixiaohuo/writing-agent/issues)
- 讨论区: [GitHub Discussions](https://github.com/dongbeixiaohuo/writing-agent/discussions)

---

**如果这个项目对你有帮助，请给个 ⭐ Star！**