上下文工程指南
帮助编码代理在正确时间获取正确项目上下文，减少臆测并保持开发规范一致。
技能明确要求避免提交.env和密钥、验证外部文档与配置、将指令式内容视为数据，并在需求不完整或冲突时停下询问；因此主要安全风险可见。扣分原因是未定义权限最小化、MCP/外部系统的数据流披露、外部副作用确认、依赖安全审查或回滚方案。
内容结构一致，包含上下文层级、加载步骤、冲突处理和验证清单，正常路径可理解。扣分原因是未提供针对异常输入、工具不可用、上下文过长或规则文件失败的可诊断错误反馈；且本次仅静态阅读，按校准不超过10分。
明确面向AI编码代理，并列出新会话、任务切换、质量下降等使用场景，涵盖多种规则文件和MCP示例。扣分原因是非适用边界、精确触发条件、输入输出契约以及中文和中国大陆网络环境适配均不充分。
文档分层清晰，包含概览、使用时机、流程、反模式、验证和示例；仓库README提供安装方式，且提供MIT许可证和维护团队信息。扣分原因是该技能自身没有版本、变更记录、明确维护责任与更新路径，依赖和MCP可用性说明也不完整。
规则文件、选择性上下文、相关文件读取、冲突升级和验证步骤能直接指导代理改善上下文准备，核心任务具有实际可用性。扣分原因是没有该技能产出样例或效果证据，也未证明相对人工流程或其他技能的边际收益；静态校准限制最高为7分。
仓库提供真实CI工作流，能够静态支持全仓库技能格式、评估运行器和安装流程的可验证性。扣分原因是提供的测试夹具与context-engineering无关，未见覆盖该技能关键路径的专门测试或第三方复核；静态校准限制最高为5分。
- 该评估仅基于提供的源文件，未执行技能、脚本、CI或安装流程。
- MCP集成、外部文档和配置文件可能引入数据泄露或错误指令风险；使用前应明确授权范围并验证来源。
- README中的仓库级CI和评估证据不能证明context-engineering技能本身的运行效果。
- 发布者未通过FollowSkills企业精选注册表验证，身份按未知处理。
这个 Skill 能做什么，适合哪些场景？
Context Engineering 是一个面向 AI 编码代理的上下文管理工作流。它指导代理按持久性和任务相关性组织规则文件、规格文档、源代码、错误输出和对话历史。该技能还提供上下文打包策略、冲突处理、缺失需求处理、轻量计划和验证清单。适合需要让代理遵循项目约定、减少幻觉或在任务切换后恢复焦点的开发团队。
指导代理创建和维护 CLAUDE.md、AGENTS.md 或其他规则文件；按层级加载规格、相关源文件、测试文件、类型定义和错误输出；使用 Brain Dump、Selective Include 和 Hierarchical Summary 组织上下文；区分可信源代码与需要验证的配置、外部文档和用户内容；在上下文冲突或需求不完整时明确列出选项并请求决策；为多步骤任务输出轻量计划；可建议使用 Context7、Chrome DevTools、PostgreSQL、Filesystem 和 GitHub 等 MCP 服务；最后检查规则文件、实际 API 引用和上下文刷新情况。
- 刚开始编码会话、需要让代理了解技术栈、命令、约定和边界的开发者。
- 代理开始臆造 API、忽略项目风格或输出质量下降的团队。
- 在大型代码库中切换功能区域、只需加载相关规格和源文件的工程师。
- 为 AI 辅助开发新项目、需要建立持久规则文件和项目地图的团队。
- 遇到规格与现有代码冲突，或需求没有定义关键行为而不应擅自猜测的开发者。
这个 Skill 有哪些优点和局限？
- 提供明确的上下文层级和加载顺序，覆盖规则文件、规格、源代码、错误输出和对话历史。
- 包含可复用的上下文打包模板，便于控制范围和减少上下文洪泛。
- 明确要求在冲突和缺失需求时暴露歧义，而不是静默猜测。
- 包含可信度判断、反模式、验证清单和 MCP 集成建议。
- 技能本身主要提供指导文本，不显示自动创建规则文件或执行上下文加载的脚本。
- 未提供该单项技能的测试套件、运行时指标或效果评估证据。
- MCP 服务只是建议的增强集成，具体可用性取决于客户端和环境配置。
- 规则文件名称和客户端集成方式因工具而异，采用前需要根据目标平台调整。
如何安装这个 Skill？
该技能随仓库中的 24 个技能一起分发。使用 Skills CLI 安装：npx skills add addyosmani/agent-skills。也可以先浏览：npx skills add addyosmani/agent-skills --list。仓库还提供 Codex 原生插件安装命令：codex plugin marketplace add addyosmani/agent-skills。
如何使用这个 Skill？
将技能目录安装到兼容 Agent Skills 的客户端后，在开始新会话、切换任务或代理质量下降时触发 context-engineering。示例："Use context engineering to prepare the project context before we modify the authentication module." 随后要求代理先读取将修改的文件、相关测试和类似实现，并在发现冲突或缺失需求时暂停询问。
这个 Skill 与同类方案有什么区别？
README 将整个 Agent Skills 集合与 Superpowers 以及 Matt Pocock's skills 列为可比较方案，但没有提供仅针对 context-engineering 单项技能的对比结论。