前言¶
長會話裏 Agent 開始亂用 API、忽略項目約定,往往不是模型突然變笨,而是上下文裏塞了太多無關信息,或關鍵約束根本沒進窗口。單靠每次對話裏口頭補充棧和規範,既難複用,也難在換任務、換目錄時保持一致。
下面介紹 SkillHub 上的 Contextengineering(座標 @user_3c6cb52e/context-engineering-lr-314c)。它把「在給 Agent 喂什麼、何時喂、如何組織」寫成可加載的 Skill 說明,讓 Agent 按同一套上下文層次來協作,而不是臨時拼湊提示詞。
這是什麼¶
Contextengineering 是社區來源(community)的 ai-agent 類 Skill,當前版本 1.0.0,發佈者爲 user_3c6cb52e,SkillHub 頁面作者展示名爲 Breeze。官方簡介爲:Contextengineering 專用技能,幫助 AI Agent 高效完成相關任務。
包內 SKILL.md 將定位寫得更具體:在正確的時間給 Agent 正確的信息;上下文是影響輸出質量的主要槓桿——太少容易幻覺,太多容易失焦。實踐上做的是刻意策展 Agent 所見內容、時機與結構(即 context engineering)。
元數據標明 requires_api_key=false,無需額外 API Key;許可證爲 MIT。SKILL.md 中聲明適配 Claude Code、Codex、Hermes Agent、OpenClaw、QClaw、WorkBuddy 等框架,並給出倉庫與主頁鏈接:https://github.com/1991513ccie-png。
SkillHub 統計(截至頁面與 API 元數據):評分約 100000,下載 1121 次。
核心功能¶
以下內容均來自已安裝包內的 SKILL.md(v1.0.0)。發佈包在「Rules Files」示例外帶有「爲兼容發佈已截斷」說明,下文只寫截斷前已出現的部分,不推測後續章節。
適用時機(When to Use)¶
Skill 建議在以下情況啓用或對照執行:
- 開啓新的編碼會話。
- Agent 輸出質量下降(錯誤模式、幻覺 API、不遵守約定)。
- 在代碼庫不同區域之間切換任務。
- 爲新項目配置 AI 輔助開發環境。
- Agent 未遵循項目規範。
上下文層次(The Context Hierarchy)¶
Skill 用從最持久到最瞬時的五層結構組織上下文:
┌─────────────────────────────────────┐
│ 1. Rules Files (CLAUDE.md, etc.) │ ← 始終加載,項目級
├─────────────────────────────────────┤
│ 2. Spec / Architecture Docs │ ← 按功能/會話加載
├─────────────────────────────────────┤
│ 3. Relevant Source Files │ ← 按任務加載
├─────────────────────────────────────┤
│ 4. Error Output / Test Results │ ← 按迭代加載
├─────────────────────────────────────┤
│ 5. Conversation History │ ← 累積,需壓縮
└─────────────────────────────────────┘
含義可以概括爲:項目級規則長期駐留;架構與規格按會話引入;源碼按任務收窄;錯誤與測試結果驅動迭代;對話歷史會膨脹,需要壓縮策略。
Level 1:Rules Files¶
Skill 將規則文件(如 CLAUDE.md)稱爲跨會話最高槓杆的上下文。文中給出 Claude Code 場景下的 CLAUDE.md 模板骨架,涵蓋:
- 項目名稱與 Tech Stack(示例含 React 18、TypeScript 5、Vite、Tailwind CSS 4、Node.js 22、Express、PostgreSQL、Prisma 等佔位)。
- Commands:
npm run build、npm test、npm run lint --fix、npm run dev、npx tsc --noEmit。 - Code Conventions:函數組件與 hooks、命名導出、測試與源碼同目錄、
cn()處理 className 等(發佈包在此處截斷,完整條目需以安裝後的文件或上游倉庫爲準)。
安裝與啓用¶
SkillHub 官方頁面給出的方式是:讓 AI 閱讀 SkillHub 安裝說明,並安裝座標 @user_3c6cb52e/context-engineering-lr-314c。
1. 安裝 SkillHub CLI(若尚未安裝)¶
先檢查是否已有 CLI:
command -v skillhub && skillhub --version
未安裝時,可按安裝文檔執行完整安裝(CLI + 默認 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需 CLI 時:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安裝 Contextengineering¶
安裝技能時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄,否則默認落在 ./skills/ 可能不會被識別。
skillhub install context-engineering-lr-314c --namespace user_3c6cb52e --dir <你的 skills 目錄>
常見路徑(來自 SkillHub 安裝文檔):
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝完成後,按你所用客戶端的要求刷新或重啓 Agent,使新 Skill 進入可用列表。
典型用法¶
Skill 本身不附帶獨立腳本;用法是讓 Agent 加載本 Skill 後按文檔執行上下文工程。可復現的起步方式如下。
方式 A:對話安裝(官方頁面推薦)
將下面意圖發給支持 Skill 的 Agent(需能訪問 SkillHub 安裝說明):
請根據 https://skillhub.cn/install/skillhub.md,安裝 @user_3c6cb52e/context-engineering-lr-314c。
方式 B:CLI 安裝後按層次落地
- 用上一節的
skillhub install裝入對應 skills 目錄。 - 在新會話開始時,要求 Agent 依據 Skill 中的 Context Hierarchy,先補齊 Level 1 規則文件(如
CLAUDE.md中的 Tech Stack、Commands、Conventions)。 - 在切換功能或子系統時,顯式加載 Level 2 規格/架構文檔;進入具體任務時再收窄到 Level 3 相關源碼。
- 調試迭代時把測試失敗與報錯輸出(Level 4)納入上下文,並規劃 Level 5 對話歷史的壓縮,避免窗口被歷史佔滿。
方式 C:對照「When to Use」做會話審計
當發現 Agent 開始幻覺 API 或違背約定時,讓 Agent 對照 Skill 中的五條觸發場景,檢查是否缺少持久規則、是否誤把整倉代碼塞進上下文、是否未壓縮長對話。
適用場景與注意¶
適合誰
- 用 Cursor、Claude Code、Codex 等做日常開發,希望把項目約定、命令、層次化上下文固化下來的人。
- 多模塊倉庫中頻繁切換任務,需要統一「先規則、後規格、再源碼」加載順序的團隊。
限制與注意
- 發佈包截斷:當前 SkillHub 下載的
SKILL.md在 Rules Files 示例中段截斷,Level 1 之後及更深層級的完整指引可能不完整;若需全文,可關注SKILL.md中寫的 GitHub 主頁https://github.com/1991513ccie-png是否與上游同步(本文未覈對倉庫內是否另有完整版)。 - 簡介較泛:商店頁與 frontmatter 描述偏概括,具體能力以包內
SKILL.md正文爲準。 - 同名 Skill 較多:SkillHub 上存在多個
context-engineering相關條目,安裝時務必使用命名空間user_3c6cb52e與 slugcontext-engineering-lr-314c,避免裝錯包。 - 目錄必須正確:
--dir必須對應當前 Agent 的 skills 路徑,否則安裝成功但 Agent 仍無法加載。
結尾¶
Contextengineering 把 context engineering 的核心主張——按層次策展 Agent 上下文——寫成 Agent 可遵循的 Skill:從持久規則文件到可壓縮的對話歷史,並給出會話質量下降時的對照清單。若你正在治理長會話裏的「上下文污染」,可以從 SkillHub 安裝該包,並優先落地 Level 1 規則文件。
- SkillHub 頁面:https://www.skillhub.cn/skills/user_3c6cb52e/context-engineering-lr-314c
- API 座標頁:https://api.skillhub.cn/user_3c6cb52e/context-engineering-lr-314c
- 安裝說明:https://skillhub.cn/install/skillhub.md