微信公众号内容生产流水线

两条入口，后半段同一条命令链。用法见 references/usage-modes.md。首次配置读仓库 docs/setup.md。

边界

• 方式 2 必须有用户主题与思路；缺一项就追问，不联网另找题。只丢标题没有成稿时，不要走方式 1。
• 仓库默认系列是科技/AI。只有本机 config/local 启用 public-event 时，才走公共事件档案上游（dossier + brief，仍按 --source provided）。
• 只创建草稿，不公开发布。不得把 API 密钥、token 或素材 ID 写进文章和日志。
• 只用下列固定命令和 init 声明的工作区文件；不新建临时脚本、单篇渲染器或视觉审图循环。
• optional-skills/ 的完整说明仍按需加载；主流水线只复用其中的确定性脚本，不读取整份扩展 Skill。

执行原则

<PIPELINE> 是本 Skill 目录，<ROOT> 是项目根目录。每条命令的 JSON 输出都含下一步提示；路径一律取 init 返回的 job_contract.paths，不要自行拼接。

方式 2：init 后写 brief，begin 后写正文，humanize 强制一轮。方式 1：init --lane manuscript，放入成稿；去 AI 味默认关。其余步骤全部使用现成命令。

固定命令链

# 1. 初始化。注意：它会重建本账号 current 工作区。
python3 <PIPELINE>/scripts/pipeline_job.py init \
  --project-root <ROOT> --account <账号> --topic '<主题>' \
  [--lane brief|manuscript] [--humanize|--no-humanize]

# 2. 把主题、思路、边界和素材偏好写入 <work_dir>/user-brief.md。
#    公共事件档案同时写 <work_dir>/source-dossier.json，并先由上游校验。

# 3. 固化选题、读取近文轮换并锁定结构。
python3 <PIPELINE>/scripts/pipeline_job.py topic \
  --job <job.json> --value '<主题>' --source provided --event-focus '<一句话核心>'
python3 <PIPELINE>/scripts/pipeline_job.py history --job <job.json> --rotation
python3 <PIPELINE>/scripts/pipeline_job.py shape --job <job.json> --auto

# 4. 输出 writing_contract。写作前先读 writing-checklist.md，随后写 article.md；
#    建议另写一句不复述标题的 digest.txt。
python3 <PIPELINE>/scripts/pipeline_runtime.py begin --job <job.json>

# 5. 写作体检。按 problems 修到 status=ok；需要逐条修法时运行输出中的 report_command。
python3 <PIPELINE>/scripts/pipeline_runtime.py check --job <job.json>

# 6. Humanize：只改 article.md 一轮。
python3 <PIPELINE>/scripts/pipeline_job.py stage \
  --job <job.json> --name humanize --status running
python3 <PIPELINE>/scripts/pipeline_job.py stage \
  --job <job.json> --name humanize --status completed \
  --detail 'intensity=<strong|restrained>'

# 7. 先固定主题，再生成证据绑定的原生信息模块；随后处理可选正文图与封面。
python3 <PIPELINE>/scripts/pipeline_job.py choose-theme --job <job.json>
python3 <PIPELINE>/scripts/build_inline_visuals.py --job <job.json>
python3 <PIPELINE>/scripts/gen_inline_images.py \
  --article <article.md> --imgs-dir <imgs_dir> --seed <run_id> \
  --job <job.json> --record-stage
python3 <PIPELINE>/scripts/gen_cover_image.py --job <job.json> --record-stage

# 8. 终检并创建草稿。
python3 <PIPELINE>/scripts/pipeline_runtime.py prepare --job <job.json>
python3 <PIPELINE>/scripts/pipeline_runtime.py finish \
  --job <job.json> --config <ROOT>/wechat-accounts.json

方式 2 写作前必须完整读取 ../wechat-viral-writer/references/writing-checklist.md。需要 Humanize 时读取 ../humanizer-zh/SKILL.md 和 references/humanize-pass.md，就地覆盖 article.md，不要把改写说明写进正文。

三道门禁

Brief

正常模式至少需要：主题、思路或时间线、必须写到/避免写到的内容。公共事件档案模式还必须有已通过上游校验的 dossier；当天没有合格材料就跳过，不以传闻、模型记忆或普通热点代替。格式见 references/user-brief.md。

user-brief.md 必须在 init 之后写，因为 init 会重建工作区。

正文

以 begin 返回的 writing_contract 为权威，并遵守：

• 标题只有一个一级标题，≤32 字；主题明确，避免周报体和空洞悬念。
• 方式 2 纯正文 1500—4000 字，以 check 结果为准；方式 1 不卡字数和写作分。
• 忠实 brief、dossier 和来源边界；不编造数字、引语、案例、亲历、采访或内幕。
• 按锁定结构组织，但事实与 brief 的叙事顺序优先；每段可保留 1—3 个真实关键短语的 **强调**。
• 不硬塞清单。历史案件和人物稿优先事实线、机制与治理影响；正文不写关注、转发或在看引导。
• 方式 2 的 check、prepare、finish 跑写作体检，最终稿必须 score ≥75 且 blocking/high 为 0；不得用假细节刷分。

媒体与草稿

• 素材方式先服从用户 brief；没有指示时服从账号档案。用户图优先且不覆盖。
• 原生信息模块由 build_inline_visuals.py 生成或校验。公共事件最多一张“公开事实脉络”，全部文案必须来自最终正文；普通文章默认不加。无效计划自动降级为空。
• AI 正文图只走 gen_inline_images.py：已有图优先；Agent 可先用自带生图写入 imgs/；否则仅在有 AGNES_API_KEY 时脚本生成。公共事件强制跳过 AI 图。失败可 skipped。
• 封面只走 gen_cover_image.py：用户图优先；正式报道走准确标题 HTML；普通观点稿可脚本生图，再降级到 HTML、Pillow、账号默认素材。
• 主题由 choose-theme 按 run_id 稳定选择；检测到公共事件档案或正式报道时自动限定为 solemn-gray、news-wire、formal-brief。
• finish 默认创建草稿；只有开发验证才使用 --dry-run。不得直接调用独立发布命令绕过门禁。

幂等与完成判定

同一 run_id 成功后重复执行应返回原结果；新 run_id 可以在同一天创建新草稿。若 draft/add 已发出但未读到响应，结果为 uncertain 且 retry_safe=false：禁止自动重发，先人工核对草稿箱。明确的前置失败可在修复后只重跑 finish。

只有同时满足以下条件才能报告成功：

1. job.json.state == drafted；
2. stages.draft.status == completed；
3. draft-result.json 的账号、action == draft、run_id 一致；
4. draft_media_id 非空且不是测试占位符。

draft-result.json 只能由 finish 生成。最终报告主题、配图来源、排版主题、正文图数、账号、HTML 路径和草稿 ID，不展示密钥。

按需读取

通用热点雷达默认关闭，也不会自动选题。公共事件档案只在本机 local 配置启用，不等于恢复热点模式。