如何與 AI 合作，我勸你善良：文件是 Agent 不走偏的起點
10 分鐘閱讀
AI 能把迭代速度拉高，卻不會自動知道專案的目標、限制與歷史；本文拆解文件如何成為人與 agent 共用的邊界、共享記憶與驗證介面，並介紹 doc-architect skill 的實務工作流。
AI Agent、Skill 與文件工程
從專案文件、Agent Skill 設計與評測，到用 CI 和 script-gated workflow 把 AI 協作變成可驗證的工程流程。
Agent Skill 不是 Prompt：從撰寫、評測到自我提煉的工程化方法
9 分鐘閱讀
深入拆解 Agent Skill 的觸發、工作流、資源與驗證設計，並以 eval、失敗分類、人工審核及版本治理建立可稽核的自我提煉與升級迴路。
Script-Gated Skills：當 Anthropic 說「刪掉 80% 系統提示」，哪些東西不能刪
13 分鐘閱讀
從一次把 SKILL.md 從 302 行砍到 159 行的真實重構出發，對照 Anthropic 的 Claude 5 context engineering 六條新規則，說明哪些規則該交給模型判斷、哪些不變量必須編進 script 與工具介面。
文件也需要 CI：從行數預算、術語裁決到 Fresh Session Test
16 分鐘閱讀
一次 doc-architect 重構加進整個 CONTEXT.md 模組，SKILL.md 卻從 225 行降到 216 行。拆解文件的三層機器保證——長度預算與棘輪、術語裁決的權限邊界、Fresh Session Test 的獨立驗收。