VSCode 的 Codex 扩展中使用 Skills 的方法

Zenn 教程介绍如何在 VSCode 的 Codex 扩展中配置和使用 Skills 功能，让编程助手更好地理解项目上下文和编码规范。

Skills 类似于 CLAUDE.md，为 AI 编码助手提供项目特定的指令和约束。文章详细展示了配置方法和常用 Skill 模板。

对日常使用 Codex 进行开发的工程师能显著提升 AI 辅助效率。

Skills 的核心理念是为 AI Coding 助手提供项目特定的上下文，让生成的代码直接符合项目规范。作者的对比测试显示，配置 Skills 后代码修改量减少了 50-70%。这种「教 AI 理解你的项目」的方式是 Vibe Coding 能够在真实项目中落地的关键。对日常使用 AI 编程助手的开发者来说是必读的效率提升指南。

Codex 是 OpenAI 推出的 VSCode AI 编程助手扩展，Skills 功能让它更好地理解你的项目。

什么是 Skills

Skills 是一组预定义的指令文件，告诉 Codex 关于你项目的特定信息：使用的框架、编码规范、目录结构、测试要求等。类似于 Anthropic 生态中的 CLAUDE.md。

配置方法

在项目根目录创建 `.codex/skills/` 目录，每个 Skill 是一个 markdown 文件：

.codex/
skills/
project.md     # 项目概述和架构
coding.md      # 编码规范
testing.md     # 测试要求
deployment.md  # 部署流程

常用 Skill 模板

project.md：描述项目的技术栈、目录结构、核心模块和依赖关系。

coding.md：定义代码风格（缩进、命名、注释）、错误处理模式、日志格式等。

testing.md：规定测试框架、覆盖率要求、Mock 策略和测试文件组织。

效果对比

作者对比了有/无 Skills 的情况：

无 Skills：Codex 经常生成不符合项目规范的代码，需要手动调整
有 Skills：生成的代码直接符合项目约定，减少 50-70% 的手动修改

最佳实践

保持 Skills 文件精简（<500行总计）
包含具体的代码示例（而不仅是文字描述）
定期更新以反映项目演进
团队共享统一的 Skills 文件

行业趋势关联

项目级上下文配置正在成为 AI Coding 的标准做法——Anthropic 的 CLAUDE.md、OpenAI 的 Codex Skills、Cursor 的 rules 都在做同样的事。这是 Vibe Coding 从「玩具」走向「生产力工具」的关键一步。MCP 协议也在朝这个方向发展，旨在为 AI Agent 提供标准化的项目上下文接口。

深度分析与行业展望

从更宏观的视角来看，这一发展体现了AI技术从实验室走向产业化应用的加速趋势。行业分析师普遍认为，2026年将是AI商业化的关键转折年。在技术层面，大模型的推理效率持续提升，部署成本不断下降，使得更多中小企业能够接入先进的AI能力。在市场层面，企业对AI投资的回报预期正在从长期战略转向短期可量化收益。

然而，AI的快速普及也带来了新的挑战：数据隐私保护的复杂化、AI决策透明度的需求增加、以及跨境AI治理协调的困难。多国监管机构正在密切关注相关动态，试图在促进创新与防范风险之间寻找平衡。对于投资者而言，识别真正具有可持续竞争优势的AI企业变得越来越重要。

从产业链角度分析，上游基础设施层正在经历整合与重构，头部企业通过垂直整合不断扩大竞争壁垒。中游平台层的开源生态日益繁荣，降低了AI应用的开发门槛。下游应用层则呈现百花齐放的态势，金融、医疗、教育、制造等传统行业的AI渗透率正在加速提升。

此外，人才竞争已成为AI产业发展的关键瓶颈。全球顶尖AI研究人员的争夺战日趋激烈，各国政府纷纷出台吸引AI人才的优惠政策。产学研协同创新模式正在全球范围内推广，有望加速AI技术的产业化转化。