跳至主要内容

10|工程 SDLC 全流程 Skill 包(addyosmani/agent-skills)

🎯 一句話:把資深工程師遵循的整套 SDLC 流程與品質關卡——從訪談需求到上線監控——寫成 24 個 Skill,跨 9 種 Agent 工具通用。

  • Repo:https://github.com/addyosmani/agent-skills
  • 授權:MIT
  • 安裝:npx skills add addyosmani/agent-skills
  • 相容:Claude Code、Cursor、Gemini CLI、Antigravity、Windsurf、OpenCode、GitHub Copilot、Kiro IDE、Codex

作者背景

Addy Osmani 長期在 Web 效能與前端工程領域活躍,是《Learning JavaScript Design Patterns》等書的作者,也長年關注 Chrome、Web Vitals 一類的效能與工程實踐議題。這個背景清楚反映在收藏內容上:24 個 Skill 裡有專門的 frontend-ui-engineering(WCAG 2.1 AA 無障礙)、performance-optimization(Core Web Vitals)、browser-testing-with-devtools,以及一個獨立的 web-performance-auditor agent persona——效能與前端工程不是附帶功能,而是整套流程裡明確獨立出來的一塊。

這份作者背景是根據其公開身分與著作整理,並非直接取自 repo README——README 本身沒有寫「關於作者」的段落,特此註明來源區別。


這個收藏在解決什麼問題

多數 Skill 收藏是「一個 Skill 對一種任務」的散裝集合;這個 repo 反過來,是用 8 個 slash command 對齊軟體開發生命週期的 8 個階段,24 個 Skill 全部掛在這張流程圖上:

/spec /plan /build /test /review /webperf /code-simplify /ship

/build auto 尤其值得注意:它讓任務不需人工逐步確認就串起來執行,但仍然逐一測試驅動、逐一 commit——串起來的是流程的推進,不是省略掉品質關卡。


24 個 Skill,依 SDLC 階段分組

Meta(1)

Skill作用
using-agent-skills把手上的任務對應到正確的 Skill 流程——是這套收藏自己的路由器

Define 定義(3)

Skill作用
interview-me一次問一個問題,把需求問清楚
idea-refine把模糊的構想收斂成具體提案
spec-driven-development動手寫程式前先寫完整 PRD

Plan 規劃(1)

Skill作用
planning-and-task-breakdown把 spec 拆成可驗證、有順序的任務清單

Build 建構(7)

Skill作用
incremental-implementation薄的垂直切片,逐一測試、逐一 commit
test-driven-developmentRed-Green-Refactor,強調測試金字塔紀律
context-engineering在對的時機餵給 Agent 對的資訊
source-driven-development決策要以官方文件為依據,不臆測
doubt-driven-development高風險工作用對抗式的即時審查
frontend-ui-engineering元件、設計系統、WCAG 2.1 AA 無障礙
api-and-interface-designcontract-first 設計、Hyrum's Law、版本管理

Verify 驗證(2)

Skill作用
browser-testing-with-devtools即時檢查瀏覽器 runtime、效能剖析
debugging-and-error-recovery五步驟除錯分診流程

Review 審查(4)

Skill作用
code-review-and-quality五軸審查,附嚴重度標籤
code-simplification用 Chesterton's Fence 原則判斷該不該砍,聚焦清晰度
security-and-hardeningOWASP Top 10、認證模式、機密管理
performance-optimization先量測再優化,目標對齊 Core Web Vitals

Ship 上線(6)

Skill作用
git-workflow-and-versioningtrunk-based 開發、原子化 commit
ci-cd-and-automationShift Left、feature flag、品質關卡
deprecation-and-migration把程式碼當負債看待,遷移是強制流程
documentation-and-adrsArchitecture Decision Records,聚焦「為什麼」
observability-and-instrumentation結構化 log、RED 指標、OpenTelemetry
shipping-and-launch上線前檢查表、分階段推出、上線監控

4 個專家 persona(agents/)

code-reviewer(資深 Staff Engineer 視角)、test-engineer(QA)、security-auditor(漏洞/威脅視角)、web-performance-auditor(Core Web Vitals 分析)——把「用什麼身分審查」也顯式寫出來,而不是讓同一個通用 Agent 戴不同帽子含糊處理。


7 份參考檢查表(references/)

definition-of-donetesting-patternssecurity-checklistperformance-checklistaccessibility-checklistobservability-checklistorchestration-patterns——供 Skill 內文引用,避免每個 Skill 各自重複寫一份清單。


SKILL.md 的共同骨架

repo 裡每個 Skill 都遵守同一套結構:

Frontmatter(name/description/觸發詞)
→ Overview
→ When to Use
→ Process(逐步流程)
→ Rationalizations(Agent 常見的偷懶藉口 + 反駁)
→ Red Flags
→ Verification(要求具體證據:測試通過、build 成功、runtime 資料)

**「Verification 不可妥協」**是明講的設計原則——光是「看起來對」不夠,要有測試通過、build 成功這類具體證據。Rationalizations 這個區塊尤其少見:直接列出 Agent 可能找的藉口(例如「這個測試先跳過也沒差」)並附上反駁,等於把「怎麼不讓模型偷懶」寫進 Skill 本體。

repo 明確引用《Software Engineering at Google》作為哲學根源:Hyrum's Law、測試金字塔/碧昂絲原則、change-sizing 與審查規範、Chesterton's Fence、trunk-based development、Shift Left——這些概念不是空泛引用,而是逐一對應到上面某個具體 Skill。


值得抄的三件事

  1. 用 SDLC 階段當骨架,而不是任務類型——8 個 slash command 對齊 8 個開發階段,24 個 Skill 全部有明確歸屬,不會變成一堆互相不知道彼此存在的散件。
  2. Rationalizations 區塊:與其信任模型「應該會做對」,不如先列出它可能找的藉口並逐一反駁——這比單純寫「請確實測試」更有效。
  3. Verification 要具體、可檢查——測試通過、build 成功、runtime 資料,而不是「看起來沒問題」。