开发与工程

上下文工程指南

帮助编码代理在正确时间获取正确项目上下文,减少臆测并保持开发规范一致。

49/ 100
谨慎使用

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

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 107k
最近更新
13 天前
License
MIT
context-managementcoding-workflowrules-filesmcp-integration
+2requirements-clarificationverification

这个 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?

使用前请注意
  • 该评估仅基于提供的源文件,未执行技能、脚本、CI或安装流程。
  • MCP集成、外部文档和配置文件可能引入数据泄露或错误指令风险;使用前应明确授权范围并验证来源。
  • README中的仓库级CI和评估证据不能证明context-engineering技能本身的运行效果。
  • 发布者未通过FollowSkills企业精选注册表验证,身份按未知处理。
开始前你需要
Agent 需要具备
  • 本地文件系统
  • MCP Server

该技能随仓库中的 24 个技能一起分发。使用 Skills CLI 安装:npx skills add addyosmani/agent-skills。也可以先浏览:npx skills add addyosmani/agent-skills --list。仓库还提供 Codex 原生插件安装命令:codex plugin marketplace add addyosmani/agent-skills。

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

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

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • Use context engineering to prepare the project context before we modify the authentication module.

将技能目录安装到兼容 Agent Skills 的客户端后,在开始新会话、切换任务或代理质量下降时触发 context-engineering。示例:"Use context engineering to prepare the project context before we modify the authentication module." 随后要求代理先读取将修改的文件、相关测试和类似实现,并在发现冲突或缺失需求时暂停询问。

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

优点
  • 提供明确的上下文层级和加载顺序,覆盖规则文件、规格、源代码、错误输出和对话历史。
  • 包含可复用的上下文打包模板,便于控制范围和减少上下文洪泛。
  • 明确要求在冲突和缺失需求时暴露歧义,而不是静默猜测。
  • 包含可信度判断、反模式、验证清单和 MCP 集成建议。
局限
  • 技能本身主要提供指导文本,不显示自动创建规则文件或执行上下文加载的脚本。
  • 未提供该单项技能的测试套件、运行时指标或效果评估证据。
  • MCP 服务只是建议的增强集成,具体可用性取决于客户端和环境配置。
  • 规则文件名称和客户端集成方式因工具而异,采用前需要根据目标平台调整。

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

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

Skill FS 评分 Star 数 最近更新 License
上下文工程指南 本页 49 · 谨慎使用 ★ 107k 13 天前 MIT
Hermes 临时委派技能 49 · 谨慎使用 ★ 7.8k 12 天前 MIT
需求访谈助手 59 · 推荐 ★ 107k 13 天前 MIT
Handoff Plan(交接规划) 47 · 谨慎使用 ★ 64 10 天前 MIT
e2e Playground 验证技能 59 · 推荐 ★ 10k 12 天前 Apache-2.0

README 将整个 Agent Skills 集合与 Superpowers 以及 Matt Pocock's skills 列为可比较方案,但没有提供仅针对 context-engineering 单项技能的对比结论。

FollowSkills 如何评估这个 Skill?

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

技能明确要求避免提交.env和密钥、验证外部文档与配置、将指令式内容视为数据,并在需求不完整或冲突时停下询问;因此主要安全风险可见。扣分原因是未定义权限最小化、MCP/外部系统的数据流披露、外部副作用确认、依赖安全审查或回滚方案。

2可靠稳定8 / 20 · 2.0/5

内容结构一致,包含上下文层级、加载步骤、冲突处理和验证清单,正常路径可理解。扣分原因是未提供针对异常输入、工具不可用、上下文过长或规则文件失败的可诊断错误反馈;且本次仅静态阅读,按校准不超过10分。

3适用触发8 / 15 · 2.7/5

明确面向AI编码代理,并列出新会话、任务切换、质量下降等使用场景,涵盖多种规则文件和MCP示例。扣分原因是非适用边界、精确触发条件、输入输出契约以及中文和中国大陆网络环境适配均不充分。

4规范维护8 / 15 · 2.7/5

文档分层清晰,包含概览、使用时机、流程、反模式、验证和示例;仓库README提供安装方式,且提供MIT许可证和维护团队信息。扣分原因是该技能自身没有版本、变更记录、明确维护责任与更新路径,依赖和MCP可用性说明也不完整。

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

规则文件、选择性上下文、相关文件读取、冲突升级和验证步骤能直接指导代理改善上下文准备,核心任务具有实际可用性。扣分原因是没有该技能产出样例或效果证据,也未证明相对人工流程或其他技能的边际收益;静态校准限制最高为7分。

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

仓库提供真实CI工作流,能够静态支持全仓库技能格式、评估运行器和安装流程的可验证性。扣分原因是提供的测试夹具与context-engineering无关,未见覆盖该技能关键路径的专门测试或第三方复核;静态校准限制最高为5分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 2fbfa004a019 评估证据[1][2][3][4][5]

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

查看完整评分方法 →

常见问题

这个技能需要付费服务吗?
源材料只说明仓库采用 MIT 许可证,并未说明额外费用。MCP 服务是否产生费用取决于具体服务和配置,源材料未作说明。
它会自动修改项目文件吗?
SKILL.md 指导代理读取相关文件并创建规则文件,但没有提供自动执行这些操作的脚本或具体权限模型。
什么时候应该触发它?
适合开始新编码会话、切换代码库区域、代理输出质量下降、建立新项目上下文,或代理未遵循项目规范时使用。
它能解决所有代理错误吗?
不能。它主要改善上下文准备和歧义管理;源材料没有证明它能自动修复代码、测试失败或所有幻觉问题。

同仓库的其他 Skills

均来自 addyosmani/agent-skills

开发与工程

需求访谈助手

在规划或编码前,通过逐题访谈确认用户真正想解决的问题。

★ 107k FS 59 推荐 13 天前
开发与工程

规划与任务拆解

将明确需求拆分为有依赖顺序、可实现且可验证的工程任务。

★ 107k FS 54 谨慎使用 13 天前
开发与工程

Idea Refine 创意打磨

把模糊想法转化为经过验证、可执行的产品方向。

★ 107k FS 51 谨慎使用 13 天前
开发与工程

工程技能导航器

根据任务阶段发现并调用合适的工程工作流技能。

★ 107k FS 46 谨慎使用 13 天前
开发与工程

测试驱动开发工作流

用可执行的测试先证明需求,再以最小改动实现、重构并验证行为。

★ 107k FS 57 谨慎使用 13 天前
开发与工程

规范驱动开发

在编码前把模糊需求转化为可验证的开发规范。

★ 107k FS 55 谨慎使用 13 天前
设计与前端

生产级前端界面工程

帮助 AI 编码代理构建可访问、响应式且符合设计系统的生产级用户界面。

★ 107k FS 53 谨慎使用 13 天前
开发与工程

怀疑驱动开发

在非平凡决策落地前,用新上下文主动寻找错误。

★ 107k FS 52 谨慎使用 13 天前
开发与工程

增量实现

用可验证的小步迭代安全交付多文件工程变更。

★ 107k FS 52 谨慎使用 13 天前
自动化与运维

安全加固工程技能

帮助编码代理在处理不可信输入、身份验证、敏感数据和外部服务时建立系统化安全防线。

★ 107k FS 52 谨慎使用 13 天前
开发与工程

官方文档驱动开发

让框架与库的实现决策基于当前官方文档,而不是过时记忆。

★ 107k FS 51 谨慎使用 13 天前
开发与工程

浏览器 DevTools 测试

用真实浏览器运行数据验证、调试并测试网页应用。

★ 107k FS 59 推荐 13 天前
开发与工程

代码简化审查

在不改变行为的前提下,降低代码复杂度并提升可读性与可维护性。

★ 107k FS 57 谨慎使用 13 天前
开发与工程

Git 协作与版本发布规范

用可审查、可回滚的 Git 流程管理代码变更与版本发布。

★ 107k FS 54 谨慎使用 13 天前
开发与工程

性能优化工程技能

通过测量、定位和验证,系统解决前端、后端、查询与数据库性能瓶颈。

★ 107k FS 54 谨慎使用 13 天前
开发与工程

架构决策与工程文档助手

帮助工程团队记录决策依据、维护文档并保留长期代码上下文。

★ 107k FS 53 谨慎使用 13 天前
自动化与运维

生产可观测性工程

为生产代码建立日志、指标、追踪与告警,让系统行为可见且便于诊断。

★ 107k FS 53 谨慎使用 13 天前
开发与工程

稳定接口设计指南

帮助工程团队设计稳定、清晰且难以误用的 API 与模块接口。

★ 107k FS 50 谨慎使用 13 天前
开发与工程

合并前代码质量审查

在合并前从正确性、可读性、架构、安全性和性能五个维度审查代码变更。

★ 107k FS 49 谨慎使用 13 天前
开发与工程

系统化调试与错误恢复

用结构化流程定位根因,修复错误并防止复发。

★ 107k FS 49 谨慎使用 13 天前

相关 Skills