Contextengineering:用 Skill 把 Agent 上下文當成工程問題

前言

長會話裏 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 建議在以下情況啓用或對照執行:

  1. 開啓新的編碼會話。
  2. Agent 輸出質量下降(錯誤模式、幻覺 API、不遵守約定)。
  3. 在代碼庫不同區域之間切換任務。
  4. 爲新項目配置 AI 輔助開發環境。
  5. 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 安裝後按層次落地

  1. 用上一節的 skillhub install 裝入對應 skills 目錄。
  2. 在新會話開始時,要求 Agent 依據 Skill 中的 Context Hierarchy,先補齊 Level 1 規則文件(如 CLAUDE.md 中的 Tech Stack、Commands、Conventions)。
  3. 在切換功能或子系統時,顯式加載 Level 2 規格/架構文檔;進入具體任務時再收窄到 Level 3 相關源碼。
  4. 調試迭代時把測試失敗與報錯輸出(Level 4)納入上下文,並規劃 Level 5 對話歷史的壓縮,避免窗口被歷史佔滿。

方式 C:對照「When to Use」做會話審計

當發現 Agent 開始幻覺 API 或違背約定時,讓 Agent 對照 Skill 中的五條觸發場景,檢查是否缺少持久規則、是否誤把整倉代碼塞進上下文、是否未壓縮長對話。

適用場景與注意

適合誰

  • 用 Cursor、Claude Code、Codex 等做日常開發,希望把項目約定、命令、層次化上下文固化下來的人。
  • 多模塊倉庫中頻繁切換任務,需要統一「先規則、後規格、再源碼」加載順序的團隊。

限制與注意

  1. 發佈包截斷:當前 SkillHub 下載的 SKILL.md 在 Rules Files 示例中段截斷,Level 1 之後及更深層級的完整指引可能不完整;若需全文,可關注 SKILL.md 中寫的 GitHub 主頁 https://github.com/1991513ccie-png 是否與上游同步(本文未覈對倉庫內是否另有完整版)。
  2. 簡介較泛:商店頁與 frontmatter 描述偏概括,具體能力以包內 SKILL.md 正文爲準。
  3. 同名 Skill 較多:SkillHub 上存在多個 context-engineering 相關條目,安裝時務必使用命名空間 user_3c6cb52e 與 slug context-engineering-lr-314c,避免裝錯包。
  4. 目錄必須正確:--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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜