前言¶
寫一整本多章節教材時,常見的做法是讓模型從第一章一路寫到最後一章。問題不在寫得慢,而在寫崩:各章的教學目標、評估方式和內容深度對不上,前面定的目標後面沒人呼應,寫到一半中斷後更是沒法接着寫,只能從頭再來。
教材寫作流水線針對的就是這個場景。下面介紹它的定位、能力、安裝方式和典型用法。
這是什麼¶
教材寫作流水線是一套基於通用 SKILL.md 格式的 Agent Skill,由社區發佈者 user_6733bad6 維護,版本 0.7.0,分類爲 content-creation,來源標記爲 community。它把整本教材的寫作拆成五個階段,按 UbD(理解爲逆向設計)的順序調度:先確定目標和評估,再組織內容,而不是從內容往前堆。
它解決的問題是:整本教材的目標對齊、寫作過程中的中斷恢復,以及寫作與習題生成的分工。
核心功能¶
- 五階段調度。整個寫作過程按 UbD 逆向設計分成五個階段推進,階段之間的順序由 Skill 控制,不靠人在對話裏反覆提醒。
- 階段 2、階段 3 雙 gate 作者確認。這兩個階段設了確認門檻,需要作者確認後才進入下一階段,避免目標和評估方案沒定就往下寫內容。
.progress.json落盤與續寫。進度寫入.progress.json,中斷後可以從落盤的進度繼續,不用從頭開始。- 基於已有素材開工。支持基於已有的 Word 文檔、講義素材規劃整本教材,也支持修訂項目中只改指定章節。
- 與三個子 Skill 分工。教材大綱、單章寫作、習題生成分別由 textbook-outline、textbook-chapter、textbook-exercises 承擔,本 Skill 負責把它們串成一條流水線。
安裝與啓用¶
四個 Skill 必須放在同一個 skills 目錄下,缺一個流水線就跑不起來:
skills/
├── textbook/ # 本 Skill,主流程
├── textbook-outline/ # 教材大綱
├── textbook-chapter/ # 單章寫作
└── textbook-exercises/ # 習題生成
放置好之後,在對話裏用觸發語喚起即可,例如「寫教材」、「把講義做成教材」、「修訂這本教材的第三章」。該 Skill 的標籤爲 requires_api_key=false,不需要額外配置 API Key。
官方地址:https://api.skillhub.cn/user_6733bad6/textbook,SkillHub 頁面顯示評分 100000,下載 1011 次。
典型用法¶
新建一個項目,把素材(Word 文檔或講義)和需求一起給到 Agent,觸發語用「把講義做成教材」。Agent 會先跑階段 1,進入階段 2、3 時停下來等作者確認;確認後繼續推進,期間進度不斷寫入 .progress.json。
如果是修訂已有教材,直接指明章節,例如「修訂這本教材的第三章」,流程只針對該章重新走一遍階段調度,不會重寫全書。
中途對話中斷也不要緊,重新發起後 Skill 讀取 .progress.json 接着寫,不需要重新交代背景。
適用場景與注意¶
適合的場景:寫一整本多章節教材、寫含習題的成體系課程講義、基於已有 Word 文檔或講義規劃整本教材、修訂項目中指定章節的改寫。
不適合的場景:只寫單篇教程(不需要這套流程)、只寫一章(用 textbook-chapter)、只出習題(用 textbook-exercises)。這三種情況用主流程屬於殺雞用牛刀,環節也對不上。
需要注意的坑:
- 四個 Skill 必須同目錄,少一個主流程會在調度到對應環節時斷掉。
- 階段 2、3 的確認是人工 gate,作者不確認就不會往下走,不能指望全程無人值守跑完。
.progress.json是續寫的唯一依據,刪掉它就等於丟掉進度,需要從頭再來。- 該 Skill 與具體的模型平臺無綁定,按通用 SKILL.md 格式加載,具體加載方式取決於你使用的 Agent 環境。
結尾¶
教材寫作流水線的價值在於把「寫一整本教材」這件容易失控的事變成可調度、可中斷、可續寫的流程:階段順序有 UbD 兜底,關鍵節點有作者確認,進度有文件留存。如果工作內容是成體系的教材或講義寫作,值得裝一套試跑;只寫單篇或單章的話,用對應的子 Skill 就夠了。
官方地址:https://api.skillhub.cn/user_6733bad6/textbook