sanshengai 中文长文写作系统
运行要求：Python 3.10+、Node.js 18+ 与 baoyu-skills；BGM/各 renderer 的凭证按 music.md / image-routing.md 配置，只从环境变量读取。
主入口：只承载「路由 + 触发边界 + 全局元指令 + 高频铁律」，各阶段细则一律 lazy-load 对应 reference。下文裸写的 xxx.md 一律指 references/xxx.md（profile/corpus/authors/ 与 profile/ 下的文件已标全路径）。
🔴 默认 = 全自动一路到草稿箱：新文章按 autopilot.md；作者已给确认定稿时直接按 release-runtime.md。失败只在当前命令修复，不 skip、不伪造状态。显式配置
podcast.wechat_embed: true时，公众号固定为「导读 → 主题曲卡 → 播客卡 → 正文」，两卡同级、同宽、上下排列；音频必须在草稿前生成。自动链止于微信草稿箱；原创、赞赏与正式发布由作者人工完成。
⚡ 朋友圈文案极速例外：用户只要一条已有文章的朋友圈推文/文案时，不进入文章流水线，不跑
status/finalize/ 归档 / 官网 / 搜索 / 生图，也不等待其他长任务。优先用当前对话已有标题与主旨，信息不足时最多读取该文article-meta.yaml与开头/结尾，直接返回可复制的三段文案。只有用户明确要保存文件时才运行python scripts/pipeline.py --dir <文章目录> moments-copy；目标耗时是秒级。
🗃️ 过程目录与永久归档是两个根：
SANSHENG_WRITE_DATA_DIR=@workspace/...只决定当前工作树里的写作过程目录；pipeline.py archive只登记作品库，不搬文件。全部写作、发布、社媒分发写者退出后，才运行pipeline.py --dir <文章目录> physical-archive --delete-source，把整篇目录交付到绝对路径SANSHENG_WRITE_ARCHIVE_DIR。命令先复制到同盘临时目录、逐文件核对大小与 SHA-256；目标同路径内容不同即中止，复验通过后才删除源目录。SANSHENG_WRITE_HANDOFF_DIR仅是人工上传临时包，禁止拿它当成品归档。
🟢 启动前必读（元指令，先于任何阶段）
进任一阶段第一件事按序读两份共享上下文，读完不再问已知信息（主题色/账号名/创作者背景），只追问本任务才变的参数（风格/受众/字数）：
- 品牌上下文
profile/context.md（品牌身份/人设/风格路由/对话约定）；未配置 profile 时回退仓内profile.example/context.md（中性默认，正常路径不是错误）；皆无则兜底本文件「品牌身份 fallback」节。 - 品牌织网（可选）
profile/brand-net.md（阵地地图/伏笔池/承诺台账）。存在时大纲阶段步骤 7.5 织网三问必答（联动已发文/推自有阵地/埋伏笔），答案落article-meta.yaml的weave:（细则进 outline.md 步骤 7.5）；归档把本篇许的愿登进 brand-net.md §四。文件不存在则跳过织网环节，不报错（织网是可选玩法）。
profile 目录由环境变量
SANSHENG_WRITE_PROFILE_DIR指定（未配置则回退仓内profile.example/），解析入口scripts/profile_config.py。多 worktree 可在.env写@workspace/...；pipeline 必须在文章目录确定后先bind_workspace(article_dir)，禁止把数据与 profile 静默解析到 main。多阶段任务：完成一阶段再读下一个，勿一次性全读。
🔁 恢复协议（元指令）
进任何 {数据目录}/{N}-{选题名}/ 目录第一件事跑 python "$SKILL/scripts/pipeline.py" status。state v2 保留 first_completed_at、更新 last_verified_at/attempt_count/artifact_digest；已完成上游产物发生变化时，当前与已完成下游自动标成 dirty，必须从最早 dirty 阶段重验。内容配置唯一真源是 article-meta.yaml，.state.json 只记流程状态。
**长任务心跳：**预计超过 60 秒的渲染、视觉 QA、BGM 或草稿事务，启动时先说明当前阶段与预计耗时；命令是阻塞式调用，返回前无法插播——命令返回后（或分批调用间隙）报告进度，进行中状态可查 素材/.render-attempt-*.json 与 .gen-log.jsonl 增量。同一文章目录只允许一个发布机械链写者，心跳不是重开同一命令的理由。
🔎 静态预检（写完正文就跑，别等被打回）
python "$SKILL/scripts/pipeline.py" preflight
一次跑完所有不依赖生图/排版/网络的静态检查：闸门锚点文件、标题公式门、外审产物、
H2 与 part_subtitles 对齐、加粗密度、开篇重点标识、文末 DEEP READ / SOURCES、
金句库来源标记、visual-plan.json 合法性。
🔴 为什么单列一条元指令：89 号实跑账本 —— verify_publish 反复 8 轮、
verify_layout 6 轮、format_layout 4 轮。逐条复盘，卡住的全是纯静态检查，
却散落在链条各处：开篇标识要等排版才报（迟 3 个阶段）、金句库来源标记要等
finalize 才报（迟 5 个阶段）。每迟报一个阶段 = 一次「回头改 → 重跑中间所有步骤」。
这条命令不花任何配额，写完正文跑一次，能省掉后面大半的返工。
快速路由（🔴 = 进该阶段前必读）
| 意图（含该行必要约束） | 读 |
|---|---|
| 新选题 / 写篇文章 / 聊方向 | outline.md |
展开正文 / 继续写 / 改稿（写前先跑 prep_writing.py 聚合 _prep-context.md 再走 7 步准备） |
writing.md + style-routes.md 对应章 + profile/corpus/authors/{X}.compact.md |
| 给几版开头盲选 / 挑开头 / 换开头（2-3 版钩子 A/B/C 盲选不给理由，autopilot 唯一法定停顿点） | writing.md §开头候选盲选 |
| 内容增强 / 素材不够尖（4 套策略，大纲后写作前） | content-enhance.md |
| 材料够不够 / 来源边界 / 现实写作能写到哪一步 | material-integrity.md |
| 丢录音 / 口述想法转文字 / 音频转写（转写 → 口述梳理 → 梳理稿当大纲主输入） | transcribe.md |
| 想标题（内联出 5 候选+排序） | title.md |
| 写作技法 / 开篇结尾 / 金句 | craft-techniques.md |
| 文体专属（教程/方法论清单/技术解读，仅这三类加载；文体三选一的选定在 outline Step 3） | writing-genres.md |
| 去 AI 味 / 磨稿 | polish-whitelist.md + anti-ai-filter.md |
冷读外审（磨稿后排版前派不同模型族 subagent，产 _stutter-list.md，与事实复核同窗口并行） |
semantic-review.md |
事实复核 / 数据版本价格核验（磨稿后排版前派无上下文 subagent，产 _fact-check.md，preflight 硬断言 exit 2） |
fact-check.md |
| 排版 / 转HTML / 导读栏 / 文末继续阅读与信息来源卡 | layout.md |
| 排版兼容 / 表格 / 卡片 / 平台过滤 | wechat-compat.md |
| 排版踩坑 / 样式异常（按需，日常 SOP 不读） | layout-reference.md |
| 🔴 改任何颜色/圆角前必读（视觉 SSOT，改一处全局生效） | design-tokens.md |
| 🔴 任何生图前必读；真人真事主动搜真实新闻照按 16:9 截取、禁 AI 生成人物肖像（新闻人物/重大事件同此） | image-routing.md |
🔴 生成封面 / 选风格（锁定 montage-evidence，自动选择/近3篇回避已失效；余 4 种仅 meta 显式 cover_style 激活） |
cover-styles.md |
| 生成音乐 / BGM / 主题曲（Lyria 自动生成、网页生成或复用既有成品） | music.md |
| 🔴 已有定稿 / 配图排版 / 发草稿 / 发布后收尾（唯一机械链） | release-runtime.md |
| 发布状态、凭证与人工边界说明 | publish.md |
| 永久归档文章目录 / 从当前工作树移出成品（所有写者退出后） | physical-archive.md |
| 只写已有文章的朋友圈推文/朋友圈文案（走上方极速例外） | publish.md §朋友圈极速路径 |
| 转图文 / 拆图文（低频能力；仅按篇显式要求时用；图片也是文章，先定唯一传播命题） | xhs-storyboard.md |
| 一稿多投 / 转小红书发微博 / 转播客 / 多渠道分发（可选模块，默认关闭且不随正式链接自动触发；小红书 3:4、微博 1:1 分别生图） | distribute.md |
| 全流程自动驾驶（并行只用于独立工作单元；定稿后的机械链串行） | autopilot.md + orchestration.md（派 fan-out/双复核时再按需读 agent-contracts.md 对应节，42KB 契约集不无条件加载） |
| 🔴 查铁律 / 确认约束（进入发布/排版/生图前必读） | iron-rules.md |
| 学某文排版（Agent 抓 URL 分析→排版参考库） | — |
| 我改了 / 学习我的修改（draft vs final diff 提 pattern 写 playbook.md） | learn-edits.md |
| 复核 skill / skill 自省进化 | skill-review.md |
子命令快捷入口： 写 选题/写 大纲→outline ｜ 写 正文/写 展开→writing ｜ 写 开头候选/盲选开头/挑开头→writing §开头候选盲选 ｜ 写 标题→title ｜ 写 音乐/写 BGM→music ｜ 写 排版→layout ｜ 写 发布→publish ｜ 写 图文/转图文→xhs-storyboard ｜ 写 分发/一稿多投/发微博/转播客→distribute ｜ 写 状态/写 进度→pipeline.py status ｜ 全流程/走一遍流程→autopilot ｜ 复核 skill/skill 自省/skill 复盘/skill 进化→skill-review
✍️ 写作核心七条（语义层正向规则 — 七个章节指针的目录，唯一 single-source）
🔴 本节只是指针目录、非可单独执行的「够用版」--摘要在场模型会跳过正文（已知失败模式）。写作期真正内化
_prep-context.md（prep_writing.py渲染，§〇 四原则置顶），磨稿期按每条指针进对应章节逐条打卡，别只看目录。 🟡 诚实边界：七条主要靠「写前喂料 + 写后语义审查」；exit 2硬门只拦正则/计数抓得到的表层指纹。audit_quant_signals对部分句式风险只发软提示，不能证明材料真实或因果成立；语义层靠异模型评审 + 事实复核，别当已机器全自动落地。
🔴 三条直球守则先于本节七条：① 简洁（每个字都得挣到位置）② 结论先行（资讯/成果：第一句下判；深度随笔：手册可 opt-out 第一句，核心判断须在第一个 H2 之前）③ 不用小说技法（不设悬念、不埋倒钩、不延迟揭示到文末）。①③ 任何风格路由不豁免；② 按开篇策略 + compact opt-out。正文细则 → writing.md §三条直球守则 / §规则冲突优先级；磨稿减法 → polish-whitelist.md；标题另有唯一公式（
分类标签 | 关键词锚点：一句由正文主干兑现的话，冒号后按「原话型 > 具象型 > 处境型 > 定位型（配额）」四选一）→ title.md §唯一公式。
- 材料先承重（每个核心 H2 映射真实材料，材料不足就补/缩/停）→ material-integrity.md
- 来源不过界（事实、自述、转述、推断、未知分开；顺序≠因果≠动机）→ material-integrity.md + fact-check.md
- 逐段有新增（事实/动作/例子/区分/后果至少推进一项）→ material-integrity.md + anti-ai-filter.md §3.1
- So What 按需兑现（后果没显现才追问，已经成立就停）→ anti-ai-filter.md §8.1
- 作者声来自知识路径（为什么知道、什么改变判断、哪里不确定，不强塞「我」）→ outline.md §1.5
- 可信细节会停笔（有来源的动作/物件/原话胜过精确幻觉，情绪成立就删解释尾巴）→ anti-ai-filter.md §2.3.5
- 句间引力（上句尾留钩子、下句头接住；顶真 + 旧信息在前新信息在后）→ 单一来源 writing.md §句间引力
特殊约定（每轮解析对话都用）
- 「」批注： 「」内是批注非正文--指令类直接执行，参考类作上下文。「素材」标记： 归入素材分拣表。「入囊」标记： 自动沉淀 profile 的选题储备文件对应分类作选题储备。
- 素材自动读取： 对话开始检查工作目录
素材/，有内容一并读；发现音频文件（mp3/m4a/wav 等）先跑scripts/transcribe_audio.py转写，再按 transcribe.md 做口述梳理（产<同名>.梳理.md） -- 大纲吃梳理稿，不直接拿转写稿写文章。事实验证： 需核实的事实/数据直接搜，不问创作者。 - 🔴 破折号统一
--： 给读者的文字里所有破折号用两个英文连字符--，禁全角。 - 🔴 铁律总纲 iron-rules.md： 硬约束一页索引，按 发布主链/视觉/排版/内容与归档/失败语义 五节组织（不可 skip 的 stage/生图后端与 QA 硬门/金句卡禁装饰引号/音乐卡位置/数据图防幻觉/文末 SOURCES 固定顺序/敏感议题用词防下架 等）。进入发布/排版/生图前必读。
🔄 skill 自省机制
contracts.py/format_layout.py/pipeline.py 把 v2 观察记录追加到 scripts/profile_config.py::observations_file() 解析出的 <profile>/flywheel/_skill-observations.jsonl（未配 profile 才回退仓根）。复核时同时统计原始尝试与每篇最新结果，避免重跑放大失败率；旁观者只诊断，改动由用户拍板。
排版模板 / 配置 / 发布脚本
- HTML 组件模板（导读栏/H2-PART/H3 时间线/Case/要点/金句卡/链接卡/深读/推荐/关注卡）在
templates/；排版进 layout.md 看工作流与组件清单、从templates/读代码。🔴 金句卡禁用“（部分平台渲乱码），出处行=发丝线 + 淡化右对齐。 article-meta.yaml： 每篇目录持久化参数（导读文案/H2 风格/封面关键词/weave/modifier_style，模板templates/article-meta.template.yaml），format_layout.py自动读、CLI 参数优先。- 定稿后运行时统一见 release-runtime.md（关键入口：
adopt-final→compile-visuals→render-visuals→visual-qa→seal visual→ BGM →podcast-pregen（显式嵌入时）→ 排版 →release-to-draft→handoff-assets导出浅层人工上传包 → 人工插入双音频并在微信预览试听首尾 →wechat-audio-check --confirm-audition→finalize）。若正式发布后草稿已被微信回收、draft/get返回40007，不得伪造草稿凭证；按 release-runtime.md 改用永久链接执行wechat-published-audio-check <wechat_url> --confirm-audition，优先走官方已发表内容 API；账号对该 API 返回48001时，严格降级为同一微信官方公开页与原官方草稿回执的证据链，生成独立补验凭证。视觉与发布的全部硬约束以 iron-rules.md §视觉/§发布主链（及各脚本非零退出）为准，本行不再抄写第三份；🔴 禁手改articles.md/works-dashboard.html。
运行时数据文件（语料池，勿整段复制进上下文）
- 统一作品库 SSOT： 实际路径只认
scripts/profile_config.py::works_file()（默认{数据目录}/works.yaml，可由SANSHENG_WRITE_WORKS_FILE重命名）；文章+视频每篇一条。写作/配图前先读近 3 篇做维度/收尾/风格去重；发布后archive写入。articles.md与works-dashboard.html是自动渲染视图（🔴 禁手改）；命令输出必须打印解析后的真实绝对路径，旧history.yaml已冻结。 prep_writing.py写作前自动聚合进_prep-context.md（不必手翻）： profile 语料池的 风格示例库 / 金句库（按主题）/ 反例对照库 / voice 语料（gate：>200 字≈2-3 段即注入）+profile/corpus/authors/{X}.compact.md（用户自备的作者风格手册；无自备手册时注入仓内原创的profile/corpus/voice-samples.md做基础人味兜底）。金句库路径只认profile_config.py::golden_lines_file()；已有库在别处时用SANSHENG_WRITE_GOLDEN_LINES_FILE直指，禁止复制第二份。- 按主题人工挑读（非自动）： 若 profile 自带精选样本库
profile/corpus/samples/{作者}/，写作前可按当前风格路由抽读 2-3 篇（无对应作者回退profile/corpus/voice-samples.md）。按需查 profile 里的品牌规范 / 选题储备文件。
过程输出与永久归档目录
{数据目录}/{N}-{选题名}/
├── 大纲.md ← 大纲 ├── 定稿.md ← 写作 ├── 定稿.html ← 排版 └── 素材/ ← 所有 AI 生成图片
{SANSHENG_WRITE_ARCHIVE_DIR}/{N}-{选题名}/
└── 全部流程完成后的永久成品；含 _physical-archive-receipt.json
编号按 {数据目录}/ 下已有最大序号递增。第一处是工作区过程目录，第二处才是长期存档；实体归档后默认不在两处保留重复副本。
品牌身份（fallback 兜底 — 正常优先读 profile/context.md）
⚠️ 仅当
profile/context.md与回退profile.example/context.md均不存在时以本节为准。
- 品牌名 / 账号名： 由 profile 提供（示例见
profile.example/context.md）｜ 主题色（primary）：#2F6F8F（中性 slate，改样式见 design-tokens.md；六套预置主题 slate/ink/sage/jade/amber/plum 见profile/brand.yaml） - 风格路由： 主路由为 profile 自备的作者风格手册（
profile/corpus/authors/*.compact.md）单选其一；可叠加 modifier 手册 0-1 个组合（不当主路由用）；文体三选一（深度文/教程文/方法论清单文，细则 outline Step 3）。完整清单与叠加机制见 style-routes.md（modifier 由prep_writing.py自动叠进 _prep-context）。无自备手册时回退profile/corpus/voice-samples.md。 - 品牌规范 / 创作者人设：
profile/context.md（中性示例见profile.example/）。
When NOT to Use（反向路由：交别的工具 / 不触发）
| 用户意图 | 应该用 | 不要用本 skill |
|---|---|---|
| 先把话题/背景查清、看各方怎么说（再决定写不写） | 你惯用的调研工具（多源+交叉验证+归纳） | 调研交调研工具；"值不值得写"由本 skill「写 选题」阶段做 |
| 单独打磨/锻造一个标题（无正文） | 本 skill「写 标题」（title.md） | 纯标题打磨归本 skill 内联锻造 |
| 已发布文章 数据复盘/涨粉/阅读量诊断 | 你的数据分析工具 | 本 skill 不处理已发布数据 |
| 已写好文章 转短视频口播/分镜 | 你的视频 skill | 本 skill 出文章不出视频脚本；定稿后转视频交视频工具，不越界写口播 |
| 通用中文写作（不需要品牌约束） | 原生写作即可 | 品牌约束会污染通用写作 |
| 英文内容 / 纯代码 / Git 同步 / 环境配置 | 默认流程 | 本 skill 专为中文长文设计 |
衔接规则 · 选题/找素材调研分流： 轻素材（核一事实/补一数字/查一名词/确认时间价格）→ 自己 WebSearch 直接搜，不起调研工具；深素材（有争议/多平台口碑/交叉验证去伪/国内外都看/成体系背景时间线，或用户说"查清楚/各方怎么说/是不是真的/交叉验证"）→ 委派你惯用的调研工具，写时手动引其事实底座与信源--不自动注入素材、不预填 meta。拿不准默认轻素材自己搜。
references 三级分层（按加载时机分层）
- L1 · 启动必读： 新文章读 autopilot；作者定稿后的机械工作只读 release-runtime；进入排版/生图/发布前读一页 iron-rules。真正每次开局无条件读的是
profile/context.md+ 可选profile/brand-net.md。 - L2 · 阶段按需（路由触发时加载）： 主流程各 reference（即上「快速路由」表所列，含实体归档
physical-archive.md）+profile/corpus/authors/*.compact.md（用户自备，数量不定，prep_writing.py 自动聚合）。 - L3 · 排障备查（低频/进阶/历史，日常不读）： layout-reference / visual-qa（接复核器 + 视觉闸三种静默失效）/ orchestration / agent-contracts / learn-edits / skill-review /
_archive/候补技法池.md（技法池候补备料，craft-techniques 主池不够时才翻）。