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

Zenn 教程介紹如何在 VSCode 的 Codex 擴展中配置和使用 Skills 功能,讓編程助手更好地理解項目上下文和編碼規範。

Skills 類似於 CLAUDE.md,爲 AI 編碼助手提供項目特定的指令和約束。文章詳細展示了配置方法和常用 Skill 模板。

對日常使用 Codex 進行開發的工程師能顯著提升 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 文件