Andiii208/gzhflow

一套可复用、跨主流 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。