gzhflow · 跨 Agent 公众号内容发布工作流
一套可复用、跨主流 AI Agent 的微信公众号内容发布工作流框架：从「一个主题」到「草稿箱里一篇排好版、配好图、去过 AI 味的文章」，六阶段流水线 + 每步质量门。
适配 Claude Code / Cursor / Codex CLI / Gemini CLI / Qwen Code / DeepSeek 等主流 Agent，也兼容 Hermes 的 SKILL.md 格式（同源标准）。
特性
- 跨 Agent 开箱即用：
AGENTS.md 单一真源 + CLAUDE.md 一行桥接，任何 Agent 打开即懂
- 七阶段流水线：素材先行 → 写作 → 去AI味 → 配图 → 排版 → 推草稿箱 → 复盘回写
- 四库 + 状态机：收件箱 / 范文锚 / 风格档案 / 教训库在下沉淀，
state.md 跨会话接续
- 质检门有实测依据：规则来自 629 篇 283 万字的对照语料研究（
lieflat-less-ai-tone，MIT），不是拍脑袋
- 个人化可替换：文风/配图风格/排版主题全部走
config/ 配置 + examples/ 模板，流程不绑定个人
- 质量门三件套：脚本门（确定性）+ 清单门（LLM 自检）+ 人工门（审阅/dry-run）
- 发布层个人号可用：官方 API
draft/add 推草稿箱（个人订阅号可用），手动粘贴兜底
- 纯 CLI 工具：stdlib 优先，无外部依赖，跨平台
快速开始
# 1. 复制配置模板
cp config/workflow.example.yaml config/workflow.yaml
cp config/styles.example.yaml config/styles.yaml
cp config/themes.example.yaml config/themes.yaml
cp config/publish.example.yaml config/publish.yaml
# 2. 自检工具链
python scripts/validate_repo.py
# 3. 对任意 Agent 说：
# 「用 gzhflow 工作流写一篇关于 XX 的公众号文章」
完整步骤见 docs/quickstart.md。
在 DeepSeek Harness 中使用（DSH 插件）
gzhflow 同时打包为 DSH 插件（package.json 声明 dsh.bundle），可一键安装：
# 全局注册 7 个 gzhflow_* 工具（6 个质检门 + 环境自检）并随包携带 gzhflow skill
dsh plugin --profile web add https://github.com/Andiii208/gzhflow
装完在任意会话说「用 gzhflow 写一篇关于 XX 的公众号文章」，或用 skill 工具加载 gzhflow。
想要「公众号主编」人设（会话级 persona + 环境自检引导）可另装 Agent 预设（opt-in）：
powershell -ExecutionPolicy Bypass -File dsh-preset/install.ps1 # Windows
bash dsh-preset/install.sh # macOS / Linux
详见 dsh-preset/README.md。
七阶段流程
| 阶段 | 作用 | 质量门 |
|---|
| ① 素材先行 | 先翻收件箱和对话存量，缺什么才问，只问一轮 | 意图三问 |
| ② 写作 | 读风格档案 + 范文锚，按文风路由写作 | ai_flavor_score.py + 自检四问 |
| ③ 去AI味 | 三环：结构手术 → 冷读重写 → 分视角评审 | ai_flavor_score.py 复检 |
| ④ 配图（可选） | 图源三问 → 风格路由 → 四段式编译 | check_image_prompt.py |
| ⑤ 排版 | 主题路由 → Markdown 转公众号 HTML | validate_gzh_html.py |
| ⑥ 发布 | 推草稿箱（个人号可用） | publish_draft.py --dry-run |
| ⑦ 复盘 | 记日志，每 5 篇回写四库 | — |
四库与状态机
单篇生产只是飞轮的一段弧。底下四个库在下持续沉淀，单篇流程在上取用并回写：
| 库 | 文件 | 变化速度 |
|---|
| 输入收件箱 | assets/inbox.md | 快变（日） |
| 范文锚 | assets/voice-samples/ | 慢变（月） |
| 风格档案 | assets/voice.md | 慢变（季度） |
| 教训库 | assets/lessons.md | 事件驱动 |
state.md 是跨会话状态机——多 Agent 之间切换时，靠它接续上下文，不重复提问。
references/ 里 38 份方法论按阶段路由见 references/INDEX.md。
目录结构
gzhflow/
├── AGENTS.md # 跨 Agent 入口（单一真源）
├── CLAUDE.md # Claude Code 桥接（@AGENTS.md）
├── state.md # 跨会话状态机（每次会话先读）
├── assets/ # 四库：inbox / voice / voice-samples / lessons / log
├── skills/gzhflow/ # 主编排 SKILL.md + 七阶段 prompts/
├── references/ # 方法论活文档
├── scripts/ # 纯 CLI 质检/排版/裁剪/推草稿
├── config/*.example # 配置模板（你的文风/主题/凭证）
├── examples/ # 去个人化示例 + 空白模板
└── docs/ # 上手/迁移/Agent 适配
背景
本项目是对作者此前 Hermes 专属个人公众号工作流（Andiii208/andiii-wechat-workflow）的抽象与泛化：保留其精华方法论（文风路由、去 AI 味手册、配图四件套引擎、设计推理层、质检门），剥离 Hermes 绑定与个人化内容，重构为适配主流 Agent 的范式框架。迁移详情见 docs/migration-guide.md。
License
MIT（见 LICENSE）；上游许可边界见 NOTICE.md。
