agentic-knowledge-work

Imported from jimmy60504/agentic-knowledge-work (AGENTS.md). Install upstream with npx skills add jimmy60504/agentic-knowledge-work. Copyright stays with the author.

Agent 時代的知識工作

這個 repo 是「Agent 時代的知識工作」課程的 GitHub 入口，同時也是課程自己的示範專案： 它用課程教的方法維護——這份 AGENTS.md、kb/ 知識庫、工作紀錄.md。

開始前必讀

• skills/chinese-copy-style.md：中文文案的語氣規則與修改對照。寫任何給人看的中文之前先讀，寫完再對照一次。適用範圍：教材、投影片的畫面與講稿筆記、文稿、對話裡給使用者看的規劃表。動詞一律雙字，不用口語短句與金句口號。
• 這個 repo 的根目錄另有 CLAUDE.md，以 @ 匯入本檔與上述 skill，供 Claude Code 每次對話自動載入；Codex 讀本檔。兩份內容以本檔為準。

四個階段與資料夾

想法從發散到發布走四段，每段對應固定位置。判斷一個東西該放哪裡，看它處在哪一段，不看它有多長。

正本在 ssot/project-structure.md（含各位置為什麼存在、三處回存與版本紀錄）；下表是操作用複本，改結構先改正本。

橫向支撐三段的：

• 工作紀錄.md：除了待消化區，還有「已消化並整合」與各次定案，是決策的紀錄。

• AGENTS.md、skills/：定案後的工作方式與判斷標準，每次對話都讀。skills/ 一個主題一檔。

• ssot/：課程核心概念的唯一正本（目前是三個迴圈與專案資料夾結構，定義與圖同一檔）。其他地方只引用不改寫；要改先改這裡，附版本紀錄。已發布週次用當時版本，不回改。

• assets/：教材圖片，必須附來源與授權；assets/site/ 放網站圖示。

• archive/：根目錄的歷史封存，保存停止維護的舊稿與取捨紀錄，不發布。

升格規則

• 待消化 → kb：資料讀過、有來源、能寫出洞見，就成一檔。
• kb → drafts：使用者指定主題後才抽；drafts 裡每份要註明取自哪些 kb 檔與待消化項。
• drafts → lessons 與 slides：只在使用者說「整合」或「發布」之後。這一步等於對外交付，agent 不自行升格。
• 反向也成立：教材發現問題，退回 drafts 改結構，不在 lessons 上硬修。

工作模式

課程討論前先讀素材索引

• 開始課程選題、備課、改稿或討論新想法前，先讀取 kb/index.md，再依題目讀相關來源與當週 draft。
• kb/index.md 是跨週素材的唯一快速入口，記錄主題、可能用途、狀態與來源／取用位置；不是另一份講稿，也不複製完整筆記。
• 每週挑選素材進 draft 時更新取用位置；收斂後超出範圍或新長出的想法，補回原 KB 筆記或工作紀錄，再更新索引。已採用的素材可重用，不直接刪掉。
• 區分候選、部分採用、講師參考與暫不採用，留下暫緩理由；不因收納就自動排入週次或恢復棄案。
• 不再另建「第幾週移出素材」或在各 draft 維護完整候選池。當週 draft 只保留當次取捨與索引連結；歷史紀錄留在 archive 與工作紀錄。
• 索引同時追蹤各週採用與後續回顧：累加週次、章節、使用範圍，區分「已入 draft」與「已入正式教材」，不以最新位置覆蓋舊紀錄。回顧寫明延伸之處，未排定用途不擅自指定週次。
• 迭代形成完整且經使用者確認的概念，整理或更新至 ssot/，保留定義、推論、適用條件、限制、例子、來源與版本理由；索引連回正本。KB 保留證據與演變，draft 只保留當週的取用方式。
• 後續章節以 SSOT 為依據；新的定案先改正本，再同步編修中的 draft。已發布週次保留當時版本，不把尚未成熟的候選直接升格。

先發散，不急著整合

使用者常常不知道要寫什麼，會先問 agent 有沒有想法。這時：

1. 直接給想法，不要反問「你想要什麼」。空白頁最貴，先有東西可以反應。
2. 使用者對想法的反應（不對、太像、方向錯）比憑空想「對的」快得多，這是正常流程。
3. agent 提出的東西不直接寫進正式文件。 先進 工作紀錄.md 的「待消化」區或 kb/，照上面的升格規則往前走。
4. 使用者決定採用後，把待消化項移到「已消化並整合」，附一句理由。

依任務選模型與分工

目標是節省強模型 token，並用 sub-agent 多工縮短時間。已授權主責 agent 自行分工及選模型，不需每次詢問。

• 依當時可用模型的能力與成本選型，不綁型號：雜事用輕量模型，局部整合用通用模型，複雜判斷用強模型；推理強度也按需要選。
• 可獨立的工作交給 sub-agent 並行，只提供必要背景、範圍與驗收要求，避免重複工作或同時改同一區段；很短的小事直接做。
• 主責不一定最強；任何模型遇到超出能力的問題，都可請較強模型協助，解開後把例行工作交回。缺資料或權限先處理缺口，不反覆換模型猜。
• 主責負責整合與適度驗收，兼顧交辦、查核及返工成本，不把省下的 token 又花在重做上。

收納素材

使用者丟連結、引文、觀察時：

1. 存成 kb/ 一則筆記：來源、重點、洞見、課程用途（候選，未定）。回答「有哪些可查事實／這份外部資料說什麼」放 reference/；回答「為什麼這樣主張」放 arguments/；回答「怎麼做、照什麼規則」放 tools/。有洞見段落的資料筆記仍可留在 reference/。
2. 跟既有 kb 筆記有關就用 [[檔名]] 連起來。
3. 不要為每個小想法開新檔；相近主題補進既有筆記。

脈絡保存

每個階段的結論落成檔案並 commit，讓討論脈絡可以帶到下一次對話。commit 訊息寫「為什麼」。 使用者與 agent 的互動模式本身也是課程素材——觀察到可教學的工作流時先提出，確認後記進工作紀錄。

寫正式教材

• lessons/*.qmd 只輸出文章版：把投影片與口頭講解補寫成可獨立閱讀的內容。
• 正文以 ## 表示主要章節、### 表示小節。強調句用 ####，避免進入右側大綱。
• 教材寫成工具無關：只給任務與素材，不綁特定 agent 的指令。
• 文案語氣照 skills/chinese-copy-style.md：平實、簡短，不用金句口號，動詞用工整的書面詞。使用者修正語句時，把修改前後補進該檔的「修改對照」。
• 教材與 draft 的圖片、引文與來源呈現依 skills/teaching-visuals-and-citations.md。
• 投影片以 agent 產 .pptx 為主。材料存 kb/；採用的論點與故事線整理進主 draft 文章，棄案及理由另存 draft，不必另維護獨立論點檔。
• 排投影片前先出 ghost deck，且以使用者原話當底，做法照 skills/ghost-deck-from-own-words.md；投影片原則見 kb/tools/slide-design-principles-argument-to-slides.md。

課程核心

• 課程不是教 agent，也不是教做簡報：每週先講一件知識工作本來怎麼做（要素、標準、常見失敗），再拆解流程，分辨哪些環節交給 agent、哪些必須人把關。簡報是第一個練習對象。
• Agent 是放大器，放大的是人本來就會的東西；判斷力來自懂那件事，不會做的人審不出 agent 的產出哪裡有問題。判斷是最貴、不能外包的環節。
• 每週固定節奏：本行怎麼做 → 拆解流程 → agent 做、依標準檢視 → 找出通順卻沒有判斷的段落（slop）→ 把標準寫入自己的 AGENTS.md 或 skill。學員的 repo 就是自己標準的集合。
• 骨架仍是收集 → 整理 → 蒸餾 → 表達；發散用 vibe，收斂用結構。
• 選模型講成配置題（模型等級、推理強度、額度），不推銷；建議學員訂閱最低方案，教材仍寫成工具無關。
• 已定進度只到第四週；第五週之後依署內需求滾動排課，不預先展開。

維護原則

• 保持文字化：教案、筆記、教材都用 Markdown 或 Quarto Markdown。
• 保持安全：不提交密碼、API key、署內真實資料、PPTX、Word；圖片放 assets/ 並附來源。
• 保持可迭代：小步更新、每次對應明確目的。
• 與第一門課（AI Agent 開發與維運）方法同源，但敘事獨立；提到共通處一句帶過即可，不要做平行對照表。