本文根據 addyosmani/agent-skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理,資料核對於 2026-10-11。所在倉庫 addyosmani/agent-skills 在 GitHub 約 10.4 萬 Star(同日數據)。技能內容會隨倉庫更新,以倉庫為準。
這個 Skill 做什麼
模型的知識有截止日期,而框架每年都在變:它很有把握寫出來的那段代碼,可能用的是兩個大版本之前的寫法。source-driven-development 的要求只有一句——凡是和具體框架相關的決定,都要有官方文檔作依據。description:讓每個實現決策都立足於官方文檔;在想先對照官方文檔核實做法再實現,或想要有權威出處、不含過時模式的代碼時使用。
流程四步:
- 識別技術棧和版本:讀項目的依賴文件,確認用到的框架和確切版本,並明確說出來;版本缺失或有歧義就問用戶,不許猜,因為版本決定了哪種寫法才是對的。
- 獲取官方文檔:抓的是所實現功能對應的那一頁,不是首頁,也不是整站。來源有明確的權威順序:官方文檔第一,官方網誌和更新日誌第二,網頁標準參考(如 MDN)第三,瀏覽器與運行時的兼容性數據第四。問答網站的回答、網誌教學(哪怕很有名)、AI 生成的文檔摘要,以及模型自己的訓練數據,都不能當作首要依據。官方來源之間互相矛盾時,要把分歧告訴用戶。
- 按文檔裏的模式實現。
- 標註出處,讓用戶可以自己去核對。
其中有一小節專講檢索安全:抓回來的文檔頁是不可信輸入,它只在「這個框架怎麼用」上有權威,無權決定智能體接下來做什麼;只提取接口定義、示例代碼、棄用警告和版本說明,其餘忽略。
技能也劃出了不必使用的情形:與版本無關的改動(改變量名、修錯別字、挪文件)、各版本通用的純邏輯,以及用戶明說要快不要核實的時候。
怎麼安裝
倉庫 README 給出了單獨安裝某個技能的寫法:
bash
npx skills add addyosmani/agent-skills --skill source-driven-development
想整套安裝,Claude Code 用 /plugin marketplace add addyosmani/agent-skills 加 /plugin install agent-skills@addy-agent-skills,Codex 用 codex plugin marketplace add addyosmani/agent-skills 加 codex plugin add agent-skills@agent-skills。README 提示,插件安裝遇到 SSH 權限報錯時改用倉庫的 HTTPS 地址。
倉庫整體介紹和其他安裝方式,詳見本站《addyosmani/agent-skills 是什麼、怎麼安裝:Addy Osmani 的 25 個生產級工程 Skills(/spec、/plan、/build)》。
怎麼用
- 「用 source-driven-development 的方式,給這個 Next.js 項目加表單提交,寫法以當前版本的官方文檔為準,給出連結」。
- 「這段數據獲取代碼是不是過時的寫法?對照官方文檔檢查」。
- 「搭一個認證的樣板,每個關鍵做法後面標明依據的是哪一頁文檔」。
適合誰 / 侷限
適合使用更新頻繁的框架、或者要寫會被全項目照抄的樣板代碼的團隊。侷限:需要智能體能聯網取文檔,離線環境裏無從談起;查文檔會多花時間和 token,小改動不划算;官方文檔本身也可能滯後或有錯,出處只保證可追溯,不保證絕對正確。
注意事項
- 許可:MIT。
- 會聯網抓取文檔頁面;不帶腳本。
- 核對它給的連結是否真的指向官方域名,以及引用的內容是否與頁面一致——標了出處不等於出處屬實。
0 條評論
還沒有評論,來搶沙發~