Skill
security-best-practices:按语言与框架做安全审查
OpenAI 官方 Codex 技能:识别项目语言和框架,读取对应安全参考文档,写安全默认代码或出报告,未实测。
这是 openai/skills 仓库 curated 目录下的 Codex 技能。它先判断项目用到的语言和框架,再加载自带 references 里的对应文档,用来写默认更安全的代码、顺带发现大问题,或在你要求时输出带严重程度分级的安全报告。页面按官方文件整理,未实测,使用前请对照原文。
什么时候用
什么时候不用
工作方式与三种用法
SKILL.md 要求先找出项目里所有的语言和主要框架,前后端都要看,再到 references 目录找对应文档,文件名格式为 <语言>-<框架>-<技术栈>-security.md,并读完与之相关的全部文件。[2]
- 主要模式:此后按安全默认的方式写新代码。
- 次要模式:写代码时被动发现影响最大的问题并告诉你。
- 报告模式:你要求时,输出按严重程度和紧迫度分节的报告,再询问是否开始修复。
references 目录当前列出 Go、Express、jQuery、Next.js、React、Vue、Django、FastAPI、Flask 等对应文件。[5]
没有匹配的 references 文件时,SKILL.md 让模型凭已知的安全常识判断,必要时可联网查资料;要出报告则须告诉你缺少具体指引。[2]
依赖与前置条件
| 类别 | 官方写法 |
|---|---|
| 账号 | 官方未写明 |
| 命令行 | 官方未写明,技能本身没有脚本 |
| 权限 | 出报告时写入一份 markdown 报告文件,位置可由你指定;没有本地指引时可能联网查资料 |
| 费用 | 官方未写明 |
官方还要求:修复一次只处理一条发现,并遵循你已有的提交与测试流程,避免引入回归。[2]
安装、许可证与仓库状态
官方未提供本技能的安装命令。README 只逐字示例了另一个技能 gh-address-comments,并说明 curated 技能可在 Codex 里用 $skill-installer 按名称安装、装完需重启 Codex;这是通用说明,不当作本技能的官方命令。[4]
技能目录内的 LICENSE.txt 含完整的 Apache License 2.0 条款(201 行)。[3]
README 说明各技能的许可证以其目录内 LICENSE.txt 为准。[4]
固定版本的技能目录列表只有 LICENSE.txt、SKILL.md、agents、references,未见 NOTICE 文件,也没有 scripts 目录。[1]
README 开头标注该仓库已弃用,并指向 OpenAI Plugins 仓库。本条按固定版本的原文整理,后续是否移动、更新待确认。[4]
来源
以下均为官方页面,核验日期见各条;链接指向核验时的版本。
- OpenAI · security-best-practices
49f948f - OpenAI · SKILL.md
49f948f - OpenAI · LICENSE.txt
49f948f - OpenAI · README.md
49f948f - OpenAI · references
49f948f - OpenAI · agents/openai.yaml
49f948f