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
羽毛球分组比赛记分
小程序二维码

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

Xiaoye