observability-and-instrumentation：讓正式環境的行為可以被查清楚
在功能開發時同步加入結構化 log、指標、trace 與以症狀為基礎的告警。
學完會知道
- 理解 observability-and-instrumentation 在開發流程裡負責的工作
- 判斷什麼情況適合使用 observability-and-instrumentation
- 完成通用 Skills CLI、Codex 或 Claude Code 安裝
開始前先準備
- 可使用支援 Agent Skills 的 coding agent
- 準備一個能實際驗證的小型開發任務
這個 Skill 在做什麼
在功能開發時同步加入結構化 log、指標、trace 與以症狀為基礎的告警。
為什麼有用
沒有 telemetry 的功能，上線後只能靠使用者描述和猜測除錯。這個 Skill 要求把 log、metrics 與 tracing 當成實作的一部分，也避免建立只會製造警報疲勞的告警。
適合什麼場景
- 新增服務、endpoint、背景工作或外部整合。
- 正式環境問題花太久才找到原因。
- 需要替延遲、錯誤率或資源飽和建立告警。
和站內相近內容的差別
Google Cloud Networking Observability Skill 聚焦 Google Cloud 網路工具。observability-and-instrumentation 是平台中立流程，從程式碼層定義 log、metrics、trace 與告警。
如何安裝
想先查看可選清單，可以執行：
npx skills add addyosmani/agent-skills --list只安裝這一個 Skill：
npx skills add addyosmani/agent-skills --skill observability-and-instrumentation安裝完整 24 個 Skills：
npx skills add addyosmani/agent-skills這個 Skill 會引用 references/observability-checklist.md。單獨安裝仍能執行主要流程，但 Skills CLI 不會帶入上游根目錄的共用 references。需要完整檢查表時，請安裝整套，或手動把這些檔案放到 Skill 能依原相對路徑讀取的位置。
手動安裝時，先 clone 上游 repo，再把整個 Skill 資料夾放進代理使用的 skills 目錄：
git clone https://github.com/addyosmani/agent-skills.git來源資料夾是 skills/observability-and-instrumentation/。如果上面列出共用 references，還要保留上游的相對路徑。
Codex
Codex CLI 0.122 以上可安裝整套原生外掛：
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills安裝後重新開啟 session。手動指定時輸入 @observability-and-instrumentation；也可以直接描述任務，讓 Codex 依 Skill 的 description 自動選用。
Claude Code
Claude Code 可從 marketplace 安裝：
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills此外掛也提供 /spec、/plan、/build、/test、/review、/code-simplify 與 /ship 等流程指令。這些指令會編排對應 Skills，不代表每個指令都只使用本頁這一個 Skill。
自動啟用還是手動指定
自動優先。正式環境功能應在實作時一起加入 telemetry。若要更換監控平台或設定告警門檻，則需手動提供營運需求。
在 Codex 手動呼叫的寫法：
@observability-and-instrumentation
請依這個 Skill 的原始流程處理目前任務，完成後列出驗證證據。