开发与工程

上下文工程基础

用注意力预算和上下文质量原则,理解并设计更可靠的智能体上下文。

55/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 18k
最近更新
16 天前
License
MIT
context-engineeringattention-mechanicscontext-windowsprogressive-disclosure
+2token-budgetingagent-architecture

这个 Skill 能做什么,适合哪些场景?

这是一个面向上下文工程入门与概念推理的 Agent Skill。它解释上下文窗口的组成、注意力机制、U 形注意力曲线,以及为什么高信号内容比更大的上下文更重要。它还介绍系统提示、工具定义、检索文档、消息历史和工具输出的组织原则。调试、压缩、优化和文件卸载等操作性任务应转交给仓库中的其他专门技能。

解释上下文由系统指令、工具定义、检索文档、消息历史和工具输出组成;用有限注意力预算、有效容量和位置敏感性分析上下文设计;提供系统提示分段、工具描述、文档分块、渐进式披露、消息历史整理和工具输出保留的原则;根据任务将操作性问题路由至 context-degradation、context-optimization、context-compression、filesystem-context 或 project-development。它不运行脚本、不调用外部服务,也不执行自动化测试。

适合
  • 刚接触上下文工程的开发者,需要先理解注意力预算和上下文窗口的基本模型。
  • 正在设计智能体系统的工程师,需要从第一性原理分析某项上下文取舍。
  • 编写上下文工程文档的技术作者,需要解释工具、历史记录和检索内容如何影响模型行为。
  • 需要判断是否应压缩长会话的团队,想先理解压缩的原因,再选择具体策略。

如何安装这个 Skill?

使用前请注意
  • 不要将示例脚本的字符比例估算用于硬性 token 限制;应替换为目标模型的真实 tokenizer。
  • ContextBuilder、消息截断和文件加载存在静默丢失或空结果风险,生产使用前应补充边界测试、显式错误反馈和输入路径约束。
  • 文档中的注意力曲线、工具 schema 膨胀和性能数字在所给材料中未提供充分的可复现证据。
  • 发布者身份未被 FollowSkills 企业登记库验证,维护责任和更新路径需要另行确认。

获取仓库后,将完整技能目录复制到目标 Agent Skills 目录;不要把 SKILL.md 展平成单个文件。例如:

mkdir -p .codex/skills
cp -R skills/context-fundamentals .codex/skills/

也可复制到 .claude/skills/、.cursor/skills/ 或 .agents/skills/。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/context-fundamentals" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

在支持 Agent Skills 的客户端中提出概念性问题,例如:Explain how the attention budget and the U-shaped attention curve should influence the design of my agent context. 仅在解释基础概念、进行上下文设计原则推理或编写背景文档时使用;若要执行具体压缩、优化或调试工作,应加载对应专门技能。

这个 Skill 有哪些优点和局限?

优点
  • 概念范围清晰,专注于上下文工程的基础模型。
  • 覆盖系统提示、工具定义、检索文档、消息历史和工具输出等主要上下文组成部分。
  • 提供渐进式披露、信号密度和位置感知等可迁移原则。
  • 采用仅含 name 和 description 的标准 SKILL.md 前置元数据,没有显示的平台专属扩展。
局限
  • 主要是概念指导,不提供可直接执行的实现脚本。
  • 没有为该技能列出自动化测试或量化验证结果。
  • 文档中的部分经验性数字和机制主张未在该技能内提供完整研究证据。
  • 操作性问题需要另外安装或加载仓库中的相关技能。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
上下文工程基础 本页 55 · 谨慎使用 ★ 18k 16 天前 MIT
Agent Skill 蓝图模板 40 · 不推荐 ★ 18k 16 天前 MIT
潜在简报 55 · 谨慎使用 ★ 18k 16 天前 MIT
Skill Creator(技能创建器) 70 · 高度推荐 ★ 2.2k 14 天前 MIT
上下文工程与智能体系统指南 44 · 不推荐 ★ 18k 16 天前 MIT

README 将上下文工程与提示工程区分开:提示工程主要关注指令设计,而本技能关注进入模型注意力预算的全部信息。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
55/ 100 五分制 2.8 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全17 / 25 · 3.4/5

该技能主要提供概念说明和本地 Python 示例,没有凭据访问、网络写入、破坏性默认操作或明显越权风险,因此基础信任较高。扣分原因是脚本会读取任意传入路径、文件不存在时静默返回空字符串,未说明敏感数据处理、路径隔离、用户确认或恢复机制;来源归属也仅以贡献者署名呈现,发布者身份未验证。

2可靠稳定7 / 20 · 1.8/5

SKILL.md、参考文档和脚本在核心概念上基本一致,且脚本无第三方依赖,正常路径可理解。扣分原因是静态证据不足,且存在可诊断性和一致性问题:消息截断的预算计算与消息开销处理不一致,ContextBuilder 可能直接丢弃超预算章节,文件加载失败静默返回空字符串,未见针对该技能脚本关键路径的专门测试。依据静态校准,不能超过10分。

3适用触发11 / 15 · 3.7/5

触发条件、适用场景和不适用的操作范围写得清楚,并明确路由到其他技能;内容平台无关,核心脚本可在本地 Python 环境运行。扣分原因是没有明确输入输出契约、版本兼容范围或更细的误触发边界;未提供中文示例或中文环境验证,但核心功能不依赖海外服务,因此未作网络可达性重扣。

4规范维护10 / 15 · 3.3/5

文档采用渐进式结构,包含 frontmatter、激活条件、路由、示例、陷阱、参考文件、脚本说明、创建日期、更新时间、作者、版本和 MIT 许可。扣分原因是没有明确维护负责人、变更日志或更新流程,外部研究引用缺少具体可审计出处,安装和故障排查说明也不完整。

5有效结果6 / 15 · 2.0/5

该技能能够直接提供上下文、注意力、渐进披露和信号密度等概念框架,并附带可复用的上下文管理脚本,核心教育价值明确。扣分原因是这是概念型技能,实际结果正确性和比较优势没有在选定技能路径上得到执行验证;示例脚本的近似分词、截断和静默失败行为可能需要用户修订。依据静态校准,不能超过7分。

6证据核验4 / 10 · 2.0/5

脚本、参考文档和元数据均可静态审计,仓库还提供通用 CI、验证脚本和部分测试证据。扣分原因是这些 CI 和测试主要覆盖仓库工具或其他示例,并未覆盖 context-fundamentals 脚本的关键路径;核心注意力和性能主张在所给材料中缺少可复现的第三方证据。依据静态校准,不能超过5分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 c578e85e40fe 评估证据[1][2][3][4][5][6][7][8][9][10]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能会自动修改我的智能体或提示吗?
不会。它提供解释、推理框架和技能路由,不运行代码,也不直接修改系统。
使用它需要网络、MCP 或额外依赖吗?
该 SKILL.md 没有显示网络调用、MCP 服务或运行时依赖。
它适合处理长会话压缩吗?
它适合解释为什么需要压缩;具体的会话压缩策略应转交 context-compression。
它适合所有上下文相关任务吗?
不适合。它定位为概念基础;注意力故障、令牌优化、文件卸载和项目形态决策分别由其他技能负责。

同仓库的其他 Skills

均来自 muratcankoylan/Agent-Skills-for-Context-Engineering

开发与工程

Agent Skill 蓝图模板

为上下文工程技能提供可复用的结构、边界和质量检查框架。

★ 18k FS 40 不推荐 16 天前
开发与工程

潜在简报

通过任务引导的 KV 缓存压缩,在可控运行时高效共享编排器与工作器之间的上下文状态。

★ 18k FS 55 谨慎使用 16 天前
开发与工程

上下文工程与智能体系统指南

帮助团队设计、优化和评估具备可靠上下文管理能力的生产级智能体系统。

★ 18k FS 44 不推荐 16 天前
开发与工程

Agent 评估方法

为智能体流水线建立可重复的评估、回归检测与质量门禁。

★ 18k FS 46 谨慎使用 16 天前
开发与工程

上下文效率优化

通过缓存、遮蔽、压缩与分区降低上下文成本,同时保护回答质量。

★ 18k FS 44 不推荐 16 天前
效率与协作

数字大脑个人操作系统

用结构化文件和 AI 管理内容、关系、知识与目标。

★ 18k FS 38 不推荐 16 天前
开发与工程

多智能体架构模式

帮助你设计具备上下文隔离、协调协议和可靠交接机制的多智能体系统。

★ 18k FS 55 谨慎使用 16 天前
开发与工程

上下文压缩策略

在长期代理会话中压缩上下文,同时保留文件变更、决策和后续行动。

★ 18k FS 50 谨慎使用 16 天前
开发与工程

自我改进循环

让智能体系统在受控评估中迭代自身的上下文、工作流与代码。

★ 18k FS 58 推荐 16 天前
开发与工程

上下文退化诊断

定位并缓解长上下文中的注意力丢失、污染、干扰、混淆与冲突。

★ 18k FS 51 谨慎使用 16 天前
开发与工程

项目级智能体开发方法论

帮助你判断是否该用大语言模型,并设计可迭代、可解析、可控成本的智能体项目流水线。

★ 18k FS 50 谨慎使用 16 天前
开发与工程

BDI 心智状态建模

把 RDF 上下文转化为可解释的信念、愿望与意图链。

★ 18k FS 49 谨慎使用 16 天前
开发与工程

文件系统上下文工程

将大型、持久或共享的代理上下文移入文件,按需检索以减少上下文压力。

★ 18k FS 45 不推荐 16 天前
开发与工程

长程智能体提示设计

为长期自主运行和并行多智能体任务设计可验证、抗近似交付的启动提示。

★ 18k FS 57 谨慎使用 16 天前
开发与工程

自主智能体控制台

为自主智能体设计可控、可恢复、可审计的运行框架。

★ 18k FS 49 谨慎使用 16 天前
开发与工程

推理轨迹优化器

通过分析智能体的推理轨迹,定位上下文、工具和指令问题,并迭代优化提示词。

★ 18k FS 38 不推荐 16 天前
开发与工程

高级 LLM 评测

为 LLM 输出构建可审计、可校准并能缓解评测偏差的自动化评估流程。

★ 18k FS 56 谨慎使用 16 天前
开发与工程

持久语义记忆架构

帮助智能体设计可扩展、可检索且能处理时间变化的持久记忆系统。

★ 18k FS 53 谨慎使用 16 天前
开发与工程

智能体工具设计指南

帮助你设计清晰、可路由、可恢复的智能体工具接口。

★ 18k FS 51 谨慎使用 16 天前
开发与工程

严谨研究代理

为多步骤研究建立验证、故障恢复与来源追踪流程。

★ 18k FS 45 不推荐 16 天前

相关 Skills