Communitygithub.com

上下文工程

检查上下文用量限制、监控剩余时间、优化令牌消耗、调试上下文故障。适用于询问上下文百分比、速率限制、用量警告、上下文优化、智能体架构、内存系统等场景。

上下文工程 是什么?

上下文工程技能专注于为大语言模型任务精心策划最小的高信号令牌集,目标是最大化推理质量同时最小化令牌消耗。该技能支持跨会话持久化、知识图谱、多智能体协调模式以及运行时意识等关键功能。它提供了四大核心策略:写入(外部保存上下文)、选择(仅拉取相关上下文)、压缩(减少令牌同时保留信息)和隔离(跨子智能体拆分工作)。此外,技能还包含了反模式指南、优化准则以及基于探测的评估方法。适用于所有主要平台(包括Claude Code、Cursor、Codex等),帮助开发者避免上下文退化、优化成本/延迟,并构建高效的LLM驱动的流水线。通过PostToolUse钩子自动注入用量感知,在70%和90%阈值时分别发出警告和关键提示。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry/tree/HEAD/skills/context-management/context-engineering-hoanghd218-landing-page-ai-kien-2

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

上下文工程 是做什么的?

上下文工程旨在为 LLM 任务精心策划最小的高信号令牌集。其目标是在最大化推理质量的同时最小化令牌使用量。

何时激活

  • 设计/调试智能体系统
  • 上下文限制制约性能
  • 优化成本/延迟
  • 构建多智能体协调
  • 实现记忆系统
  • 评估智能体性能
  • 开发 LLM 驱动的流水线

核心原则

  1. 上下文质量 > 数量 - 高信号令牌优于详尽内容
  2. 注意力是有限的 - U 形曲线偏向于开始/结束位置
  3. 渐进式披露 - 按需加载信息
  4. 隔离防止退化 - 跨子智能体划分工作
  5. 在优化之前进行测量 - 了解您的基线

重要提示:

  • 为简洁牺牲语法。
  • 在保持高质量的同时确保令牌效率。
  • 将这些规则传递给子智能体。

快速参考

主题何时使用参考
基础理解上下文结构、注意力机制context-fundamentals.md
退化调试故障、中间丢失、注入context-degradation.md
优化压缩、掩码、缓存、分区context-optimization.md
压缩长会话、摘要策略context-compression.md
记忆跨会话持久化、知识图谱memory-systems.md
多智能体协调模式、上下文隔离multi-agent-patterns.md
评估测试智能体、LLM 作为评判、指标evaluation.md
工具设计工具整合、描述工程tool-design.md
流水线项目开发、批处理project-development.md
运行时意识用量限制、上下文窗口监控runtime-awareness.md

关键指标

  • 令牌利用率:在 70% 时警告,在 80% 时触发优化
  • 令牌方差:解释了 80% 的智能体性能差异
  • 多智能体成本:约为单智能体基线的 15 倍
  • 压缩目标:减少 50-70%,质量损失小于 5%
  • 缓存命中目标:稳定工作负载下达到 70% 以上

四桶策略

  1. 写入:在外部保存上下文(草稿板、文件)
  2. 选择:仅拉取相关上下文(检索、过滤)
  3. 压缩:在保留信息的同时减少令牌(摘要)
  4. 隔离:跨子智能体拆分工作(分区)

反模式

  • 详尽上下文而非精心策划的上下文
  • 关键信息放在中间位置
  • 在达到限制之前没有压缩触发
  • 对可并行化的任务使用单个智能体
  • 工具缺乏清晰的描述

指南

  1. 将关键信息放在上下文的开头/结尾
  2. 在利用率达到 70-80% 时实施压缩
  3. 使用子智能体进行上下文隔离,而不是角色扮演
  4. 使用四问框架(什么、何时、输入、返回)设计工具
  5. 优化每任务的令牌数,而非每次请求的令牌数
  6. 通过基于探测的评估进行验证
  7. 在生产中监控 KV 缓存命中率
  8. 从最小化开始,仅在证明必要时增加复杂性

运行时意识

系统通过 PostToolUse 钩子自动注入用量感知:

<usage-awareness>
Claude 用量限制:5h=45%, 7d=32%
上下文窗口用量:67%
</usage-awareness>

阈值:

  • 70%:警告 - 考虑优化/压缩
  • 90%:关键 - 需要立即采取行动

数据来源:

  • 用量限制:Anthropic OAuth API (https://api.anthropic.com/api/oauth/usage)
  • 上下文窗口:状态行临时文件 (/tmp/ck-context-{session_id}.json)

脚本

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

majiayu000/claude-skill-registry

Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

majiayu000/claude-skill-registry

Create a hilarious and ultra-realistic video of an anthropomorphic animal acting like a human vlogger in a real-world setting.

majiayu000/claude-skill-registry

Speech-to-text transcription and translation via OpenAI Audio API -- models, response formats, timestamps, prompting, streaming, chunking, and diarization

majiayu000/claude-skill-registry

BlockRun works with Claude Code and Google Antigravity.

majiayu000/claude-skill-registry

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

majiayu000/claude-skill-registry

小省导购员数字人带货版即梦视频提示词生成系统,基于四大智能体协同(提示词生成师、质量管控师、知识库运维师、跨环节适配师),按照"主体+运动+场景+(镜头语言+光影+氛围)"公式输出中英文双版提示词,适配5s短视频。确保人物一致性、视觉连贯性、情绪连贯性,支持知识库智能复用和跨工具适配(Suno音乐、AI绘画),为数字人带货视频提供高质量提示词生成服务。

majiayu000/claude-skill-registry

Upload and manage files using Google Gemini File API via scripts/. Use for uploading images, audio, video, PDFs, and other files for use with Gemini models. Supports file upload, status checking, and file management. Triggers on "upload file", "file API", "upload image", "upload PDF", "upload video", "file management".

majiayu000/claude-skill-registry

CRITICAL: Use for MolyKit AI chat toolkit. Triggers on: BotClient, OpenAI, SSE streaming, AI chat, molykit, PlatformSend, spawn(), ThreadToken, cross-platform async, Chat widget, Messages, PromptInput, Avatar, LLM

majiayu000/claude-skill-registry

AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

相关技能