context-engineering

context-engineering 技能總覽

什麼是 context-engineering

context-engineering 技能能幫你在對的時間，把對的專案脈絡交給 AI agent，讓輸出更準確、更一致，也更少憑空猜測。它特別適合在 codebase 裡做 AI 輔助工作、重新啟動一個 session，或修正因為脈絡太弱或太雜而造成的品質漂移。

這個技能適合誰

如果你要的是一套實用的脈絡設定流程，而不只是泛用 prompt，context-engineering 技能就很合適。它特別適合工程師、repo 維護者，以及需要 agent 遵守慣例、跟隨本地模式，並停止在架構、API 或檔案結構上亂猜的進階使用者。

為什麼它重要

多數 agent 失敗，根源都在於脈絡缺失或脈絡排序不良。這個技能聚焦在 context hierarchy，讓 agent 先看到穩定的專案規則，再看到任務相關的證據。當你想要的是可重複的系統，而不是臨時調 prompt，context-engineering guide 就特別有價值。

它有什麼不同

這不是一本廣泛的 prompt 寫作指南。context-engineering 技能的重點在於脈絡的選擇、排序與重用：哪些內容應該放在 rules files，哪些屬於 feature docs，哪些要從 source files 取得，又哪些需要從 test output 或 errors 重新更新。

如何使用 context-engineering 技能

先安裝 context-engineering

請使用 repo 的 skill installer，讓 context-engineering install 這一步直接連到官方套件來源，而不是複製貼上的 prompt 片段。repository 中提供的基礎指令是：
npx skills add addyosmani/agent-skills --skill context-engineering

先從正確的檔案開始

先讀 SKILL.md，如果 repo tree 裡有連結的參考文件，再沿著那些連結往下看。對這個技能來說，實際上的閱讀路徑通常是：
SKILL.md → 它指向的任何 repo-level guidance → context hierarchy 那一節 → rules files 和 task scoping 那一節。

把模糊目標變成可用輸入

context-engineering usage 的模式，最適合你一次告訴 agent 三件事：任務、程式碼範圍、限制。比如不要只說「幫我設定 context」，而是說「替 React app 設定 context，優先沿用現有慣例，並把 rules 維持在適合重複 session 的小範圍內。」這樣技能才能有足夠訊號，選出耐久的 context，而不是吵雜的歷史紀錄。

有意識地使用 hierarchy

context-engineering for Context Engineering 的核心概念，是把 context 從穩定到暫時分層放入：project rules、feature docs、相關 source，最後才是 errors 或 test results。實務上，這代表你不該把所有東西一次塞進同一個 prompt。先給 agent 最少量、但足以證明當前慣例的檔案，再在第一輪回應之後補上迭代證據。

context-engineering 技能 FAQ

context-engineering 只是 prompt 模板嗎？

不是。context-engineering skill 更有價值的地方，在於它是一套決定脈絡該放哪裡的工作流程。單純的 prompt 也許可以要求相同結果，但它無法提供同樣可重複的 rules、source selection 和 session reset 結構。

什麼情況下不該用？

如果你的任務很小、獨立完成，或者根本不依賴 repository 慣例，就不需要用 context-engineering。如果 agent 只需要一個檔案，或只需要一個直接答案，建立完整的 context hierarchy 可能反而多此一舉。

對新手友善嗎？

友善，但前提是你已經知道問題出在 context quality，而不是 model capability。當你能指出 agent 漏掉的是 rules、architecture、相關檔案，還是最近的 error output 時，這個技能最容易上手。

它適用於每個 repository 嗎？

不一定。它最適合用在慣例重要、agent 出錯成本又高的活躍 codebase。若 repo 結構很少、也沒有反覆出現的 pattern，context-engineering guide 還是有幫助，但效益會小一些。

如何改進 context-engineering 技能

提供更強的原始素材

最大的改善通常來自更好的輸入選擇。請提供一小組能清楚展現你想要遵循的真實 pattern 的檔案，再加上任何應該壓過猜測的 rule file 或 architecture note。這比把整個 repository 大量倒進去更有效。

針對失敗模式講清楚

如果 agent 在漂移，請直接說明漂移的型態：API 風格錯了、忽略資料夾慣例、過度修改、或漏掉測試預期。context-engineering 技能在你點出具體壞掉的行為時，比你只說「context 再好一點」更能發揮作用。

用證據迭代，不要重複要求

第一輪輸出之後，把真正重要的精確錯誤、lint failure、test result，或不一致之處回饋回去。這會讓 context-engineering usage 更有效，因為下一輪可以把正確的暫時性 context 往前提，而不是把同一個請求換句話說一次。

讓 rules 保持持久且有範圍

最好的結果來自小而清楚的 rules：不容易被誤讀，也容易一直載入。如果 rule 太大，整個設定會被稀釋；如果太小，又幫不上下一次 session。請用 context-engineering 把長期存在的專案規範，和一次性的任務細節分開。