中文長文執筆系統
主入口:只承載「路由 + 觸發邊界 + 全域元指令 + 高頻鐵律」,各階段細則一律 lazy-load 對應 reference。下文裸寫的 xxx.md 一律指 references/xxx.md(profile/corpus/authors/ 與 profile/ 下的檔案已標全路徑)。
🔴 預設 = 全自動一路到草稿箱、不中途問:只要讓本 skill 寫文章(含普通「寫一篇 / 幫我寫…」,無需「全流程」口令),預設按 autopilot.md 跑完 大綱→內容增強→正文→標題→排版→配圖→BGM→發布草稿,禁止止步排版、禁止大綱後/排版後彈「1/2/3」選單,失敗按建議自糾、不得 skip 繞過。僅三種停:① 硬阻塞(封面反覆失敗 / 憑證 invalid / 自檢 Error 修不掉);② 開頭候選盲選(唯一法定創作停頓點,用戶不在場取預設續跑);③ 用戶明說「每步等我確認 / 逐步來」。
🟢 啟動前必讀(元指令,先於任何階段)
進任一階段第一件事按序讀兩份共享上下文,讀完不再問已知資訊(主題色/帳號名/創作者背景),只追問本任務才變的參數(風格/受眾/字數):
- 品牌上下文
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。多階段任務:完成一階段再讀下一個,勿一次性全讀。
🔁 恢復協議(元指令)
進任何 {資料目錄}/{N}-{選題名}/ 目錄第一件事跑 python "$SKILL/scripts/pipeline.py" status 取階段狀態與下一步;每階段完成後 verify <stage>/done <stage> 更新,中斷後 status 恢復。$SKILL = 本 skill 倉根(執行時自動解析絕對路徑);資料目錄由環境變數 SANSHENG_WRITE_DATA_DIR 指定(未設定則 <倉根>/data/)。
快速路由(🔴 = 進該階段前必讀)
| 意圖(含該行必要約束) | 讀 |
|---|---|
| 新選題 / 寫篇文章 / 聊方向 | 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 |
| 想標題(內聯出 5 候選+排序) | title.md |
| 寫作技法 / 開篇結尾 / 金句 | craft-techniques.md |
| 文體專屬(教程/方法論清單/技術解讀,僅這三類載入;文體三選一的選定在 outline Step 3) | writing-genres.md |
| 去 AI 味 / 磨稿 | 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 / 主題曲(MiniMax music-2.6-free) | music.md |
| 發布 / 發草稿 / 定稿後 | publish.md |
| 轉圖文 / 拆圖文 | xhs-storyboard.md |
全流程自動駕駛(orchestrator 預設 on=fan-out 並行 / off 回串行,pipeline.py orchestrator on/off 切換) | autopilot.md + orchestration.md + agent-contracts.md |
| 🔴 查鐵律 / 確認約束(進入發布/排版/生圖前必讀) | 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 | 寫 狀態/寫 進度→pipeline.py status | 全流程/走一遍流程→autopilot | 複核 skill/skill 自省/skill 復盤/skill 進化→skill-review
✍️ 寫作核心六條(語義層正向規則 — 六個章節指標的目錄,唯一 single-source)
🔴 本節只是指標目錄、非可單獨執行的「夠用版」--摘要在場模型會跳過正文(已知失敗模式)。寫作期真正內化
_prep-context.md(prep_writing.py渲染,§〇 三原則置頂),磨稿期按每條指標進對應章節逐條打卡,別只看目錄。 🟡 誠實邊界:六條只有「寫前餵料 + 寫後自覺」、無機器寫後校驗;exit 2硬門只攔正則/計數抓得到的表層指紋(套話黑名單、半形標點、整句加粗計數),語義人味正則無法強制、同模型自審照不出,唯靠換模型語義差分(semantic-review.md),別當已機器落地。
- So What 兌現(論點替讀者問「所以呢」並答)→ anti-ai-filter.md §8.1
- 類比落地(抽象判斷配日常類比)→ anti-ai-filter.md
- 反常細節錨(關鍵場景給反常到不像編的具體細節)→ anti-ai-filter.md §2.3.5
- 把自己寫笨(不立權威,自嘲換信任)→ anti-ai-filter.md §6.1
- 段落具體領頭(BLOT)(每段第一句給具體的人/事/畫面/數字)→ writing.md §密度法則 9
- 句間引力(上句尾留鉤子、下句頭接住;頂真 + 舊資訊在前新資訊在後)→ 單一來源 writing.md §句間引力
特殊約定(每輪解析對話都用)
- 「」批註: 「」內是批註非正文--指令類直接執行,參考類作上下文。「素材」標記: 歸入素材分揀表。「入囊」標記: 自動沉澱 profile 的選題儲備檔案對應分類作選題儲備。
- 素材自動讀取: 對話開始檢查工作目錄
素材/,有內容一併讀。事實驗證: 需核實的事實/數據直接搜,不問創作者。 - 🔴 破折號統一
--: 給讀者的文字裡所有破折號用兩個英文連字元--,禁全形。 - 🔴 鐵律總綱 iron-rules.md: 集中所有硬約束(排版→發布序列/金句卡禁裝飾引號/開篇策略分流/生圖後端/元件小圖/數據圖防幻覺/資訊來源格式/AUDIO-CARD 位置/知識圖位置/時間線 H3/文章導讀/敏感議題用詞防下架/不可 skip 的 stage/發布完整性)。進入發布/排版/生圖前必讀。
🔄 skill 自省機制
contracts.py/format_layout.py/pipeline.py 執行時把各 verify 門判定追加 $SKILL/_skill-observations.jsonl(零成本)。用戶說「複核 skill」(建議每 8-10 篇)走 skill-review.md 派旁觀者出報告;旁觀者只診斷,改動由用戶拍板。
排版模板 / 設定 / 發布腳本
- 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 參數優先。- 發布/後處理腳本(
pipeline.py+archive/format_layout.py契約門 /add_logo.js/compress_images.py/generate_article_bgm.py/generate_recommend_html.py)用法進 publish.md。硬約束:① ⚠️--check≠ 過發布契約門,驗收用format_layout.py --all --check;②archive須先done publish wechat_url=...否則缺連結直接退出;③ 🔴 禁手改articles.md(archive 自動生成的渲染檢視),一次性migrate_to_works.py帶防覆蓋欄、僅遷移手動跑一次。
執行時期資料檔案(語料池,勿整段複製進上下文)
- 統一 SSOT
{資料目錄}/works.yaml: 文章+影片每篇一條。寫作/配圖前先讀近 3 篇做維度/收尾/風格去重;發布後archive寫入。articles.md與作品庫看板.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 自帶精選樣本庫
profile/corpus/samples/{作者}/,寫作前可按當前風格路由抽讀 2-3 篇(無對應作者回退profile/corpus/voice-samples.md)。按需查 profile 裡的品牌規範 / 選題儲備檔案。
成品輸出目錄
{資料目錄}/{N}-{選題名}/
├── 大綱.md ← 大綱 ├── 定稿.md ← 寫作 ├── 定稿.html ← 排版 └── 素材/ ← 所有 AI 生成圖片
編號按 {資料目錄}/ 下已有最大序號遞增。
品牌身分(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 · 啟動必讀(跨階段不變數,2 個): iron-rules(進發布/排版/生圖前必展開)、autopilot(「寫篇文章」主路徑駕駛艙)。-- 真正「每次開局無條件讀」的是
profile/context.md+ 可選profile/brand-net.md(不屬 references,見上方啟動元指令)。 - L2 · 階段按需(路由觸發時載入): 主流程各 reference(即上「快速路由」表所列)+
profile/corpus/authors/*.compact.md(用戶自備,數量不定,prep_writing.py 自動聚合)。 - L3 · 排障備查(低頻/進階/歷史,日常不讀): layout-reference / orchestration / agent-contracts / learn-edits / skill-review /
_archive/候補技法池.md(技法池候補備料,craft-techniques 主池不夠時才翻)。