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 文件