文档

security-best-practices

试用

按语言和框架给出针对性的安全实践建议,从安全默认写法到按严重程度排序的漏洞报告。

它能做什么

先识别项目涉及的所有语言和框架(前后端都要看),再从技能自带的 references 目录加载对应的安全参考文档,并检查是否有与框架无关的通用文档。之后可以按三种方式工作:直接写出安全默认的新代码;在改代码过程中顺带标记影响最大的问题;或按你的要求产出一份 markdown 报告,按严重程度分节、每条发现带编号、引用代码时标注行号。

什么时候用它

  • 新项目从第一次提交就想要安全默认写法
  • 对现有仓库出一份按严重程度排序的安全报告
  • 写代码途中被提示某个高危问题
  • 前后端框架都需要覆盖的全栈应用审查

技能文档

Security Best Practices

Overview

This skill provides a description of how to identify the language and frameworks used by the current context, and then to load information from this skill's references directory about the security best practices for this language and or frameworks.

This information, if present, can be used to write new secure by default code, or to passively detect major issues within existing code, or (if requested by the user) provide a vulnerability report and suggest fixes.

Workflow

The initial step for this skill is to identify ALL languages and ALL frameworks which you are being asked to use or already exist in the scope of the project you are working in. Focus on the primary core frameworks. Often you will want to identify both frontend and backend languages and frameworks.

Then check this skill's references directory to see if there are any relevant documentation for the language and or frameworks. Make sure you read ALL reference files which relate to the specific framework or language. The format of the filenames is ---security.md. You should also check if there is a -general--security.md which is agnostic to the framework you may be using.

If working on a web application which includes a frontend and a backend, make sure you have checked for reference documents for BOTH the frontend and backend!

If you are asked to make a web app which will include both a frontend and backend, but the frontend framework is not specified, also check out javascript-general-web-frontend-security.md. It is important that you understand how to secure both the frontend and backend.

If no relevant information is available in the skill's references directory, think a little bit about what you know about the language, the framework, and all well known security best practices for it. If you are unsure you can try to search online for documentation on security best practices.

From there it can operate in a few ways.

  1. The primary mode is to just use the information to write secure by default code from this point forward. This is useful for starting a new project or when writing new code.

  2. The secondary mode is to passively detect vulnerabilities while working in the project and writing code for the user. Critical or very important vulnerabilities or major issues going against security guidance can be flagged and the user can be told about them. This passive mode should focus on the largest impact vulnerabilities and secure defaults.

  3. The user can ask for a security report or to improve the security of the codebase. In this case a full report should be produced describe anyways the project fails to follow security best practices guidance. The report should be prioritized and have clear sections of severity and urgency. Then offer to start working on fixes for these issues. See #fixes below.

Workflow Decision Tree

  • If the language/framework is unclear, inspect the repo to determine it and list your evidence.
  • If matching guidance exists in references/, load only the relevant files and follow their instructions.
  • If no matching guidance exists, consider if you know any well known security best practices for the chosen language and or frameworks, but if asked to generate a report, let the user know that concrete guidance is not available (you can still generate the report or detect for sure critical vulnerabilities)

Overrides

While these references contain the security best practices for languages and frameworks, customers may have cases where they need to bypass or override these practices. Pay attention to specific rules and instructions in the project's documentation and prompt files which may require you to override certain best practices. When overriding a best practice, you MAY report it to the user, but do not fight with them. If a security best practice needs to be bypassed / ignored for some project specific reason, you can also suggest to add documentation about this to the project so it is clear why the best practice is not being followed and to follow that bypass in the future.

Report Format

When producing a report, you should write the report as a markdown file in security_best_practices_report.md or some other location if provided by the user. You can ask the user where they would like the report to be written to.

The report should have a short executive summary at the top.

The report should be clearly delineated into multiple sections based on severity of the vulnerability. The report should focus on the most critical findings as these have the highest impact for the user. All findings should be noted with an numeric ID to make them easier to reference.

For critical findings include a one sentence impact statement.

Once the report is written, also report it to the user directly, although you may be less verbose. You can offer to explain any of the findings or the reasons behind the security best practices guidance if the user wants more info on any findings.

Important: When referencing code in the report, make sure to find and include line numbers for the code you are referencing.

After you write the report file, summarize the findings to the user.

Also tell the user where the final report was written to

Fixes

If you produced a report, let the user read the report and ask to begin performing fixes.

If you passively found a critical finding, notify the user and ask if they would like you to fix this finding.

When producing fixes, focus on fixing a single finding at a time. The fixes should have concise clear comments explaining that the new code is based on the specific security best practice, and perhaps a very short reason why it would be dangerous to not do it in this way.

Always consider if the changes you want to make will impact the functionality of the user's code. Consider if the changes may cause regressions with how the project works currently. It is often the case that insecure code is relied on for other reasons (and this is why insecure code lives on for so long). Avoid breaking the user's project as this may make them not want to apply security fixes in the future. It is better to write a well thought out, well informed by the rest of the project, fix, then a quick slapdash change.

Always follow any normal change or commit flow the user has configured. If making git commits, provide clear commit messages explaining this is to align with security best practices. Try to avoid bunching a number of unrelated findings into a single commit.

Always follow any normal testing flows the user has configured (if any) to confirm that your changes are not introducing regressions. Consider the second order impacts the changes may have and inform the user before making them if there are any.

General Security Advice

Below is a few bits of secure coding advice that applies to almost any language or framework.

Avoid Using Incrementing IDs for Public IDs of Resources

When assigning an ID for some resource, which will then be used by exposed to the internet, avoid using small auto-incrementing IDs. Use longer, random UUID4 or random hex string instead. This will prevent users from learning the quantity of a resource and being able to guess resource IDs.

A note on TLS

While TLS is important for production deployments, most development work will be with TLS disabled or provided by some out-of-scope TLS proxy. Due to this, be very careful about not reporting lack of TLS as a security issue. Also be very careful around use of "secure" cookies. They should only be set if the application will actually be over TLS. If they are set on non-TLS applications (such as when deployed for local dev or testing), it will break the application. You can provide a env or other flag to override setting secure as a way to keep it off until on a TLS production deployment. Additionally avoid recommending HSTS. It is dangerous to use without full understanding of the lasting impacts (can cause major outages and user lockout) and it is not generally recommended for the scope of projects being reviewed by codex.

常见问题

支持哪些语言?
面向 Python、JavaScript/TypeScript 和 Go。具体框架能否覆盖取决于 references 目录里有没有对应文档;找不到匹配文档时会退回通用知识,并且在你要报告时明确告知没有具体依据。
会不会把缺少 TLS 当成漏洞报出来?
这方面刻意保守。开发环境通常不开 TLS 或由外部代理处理,所以一般不把缺少 TLS 列为问题;在非 TLS 应用上设置 secure cookie 反而会把应用弄坏。也不建议使用 HSTS。
修复是怎么做的?
先让你读报告,然后一次只修一条,并在注释里写明依据的是哪条安全实践。改动前会评估是否影响现有功能、是否引入回归,遵循你项目已有的提交和测试流程,也不会把不相关的多条发现塞进同一个提交。
项目有意不遵守某条最佳实践怎么办?
以项目自身的文档和 prompt 文件为准。它可以提示你存在覆盖,但不会和你争;也可以建议把绕过的原因写进文档,方便以后一致地沿用。

相关技能

执行 Git 操作(提交、分支、合并、变基、冲突解决与恢复)时强制套用安全规则。

作者 Iván539 次安装31 星标

把零散的想法按三个阶段推进成一份完整文档:收集上下文、逐节撰写、读者测试。

作者 Anthropic197.6k 星标

pptx

官方

用 pptxgenjs 脚本、XML 编辑和校验流程创建、修改和读取 .pptx / .potx 演示文稿。

作者 Anthropic197.6k 星标

xlsx

官方

生成、修改并校验 Excel 工作簿,公式可重算、数字格式正确、不留下公式错误。

作者 Anthropic197.6k 星标

基于 OpenAI 官方开发者文档回答构建问题,给出引用并遵循固定的取源顺序。

作者 OpenAI28.8k 星标

gh-fix-ci

官方

Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions; use `gh` to inspect checks and logs, summarize failure context, draft a fix plan, and implement only after exp

作者 OpenAI28.8k 星标

OpenAI 的更多技能

浏览全部技能

搭建、重构和排查由 MCP 服务器加 widget 界面组成的 ChatGPT Apps SDK 项目。

作者 OpenAI28.8k 星标

把代码或描述里的页面转成 Figma 画板,直接复用已发布设计系统的组件、变量和样式。

作者 OpenAI28.8k 星标

把代码库里的设计体系按阶段搬进 Figma,每个阶段都停下来等你确认。

作者 OpenAI28.8k 星标

figma-use

官方

通过 Figma 插件 API 执行 JavaScript,在 Figma 文件里创建、修改和读取节点。

作者 OpenAI28.8k 星标

hatch-pet

官方

把概念、品牌线索或参考图做成通过校验的 Codex 宠物图集,附 QA 对照表和 pet.json 打包。

作者 OpenAI28.8k 星标

imagegen

官方

在项目里用内置 image_gen 工具生成或编辑位图,需要时再走显式指定的 CLI 回退路径。

作者 OpenAI28.8k 星标