---
title: "GPT-5.5 prompting guide"
source_name: "Simon Willison's Weblog"
original_url: "https://simonwillison.net/2026/Apr/25/gpt-5-5-prompting-guide/#atom-everything"
canonical_url: "https://www.traeai.com/articles/73468db8-2a61-4745-9987-0763eeed2fe0"
content_type: "article"
language: "英文"
score: 9
tags: ["GPT-5.5","OpenAI","Prompt Engineering","AI"]
published_at: "2026-04-25T04:13:36+00:00"
created_at: "2026-04-25T06:00:10.048327+00:00"
---

# GPT-5.5 prompting guide

Canonical URL: https://www.traeai.com/articles/73468db8-2a61-4745-9987-0763eeed2fe0
Original source: https://simonwillison.net/2026/Apr/25/gpt-5-5-prompting-guide/#atom-everything

## Summary

OpenAI 发布了 GPT-5.5 的提示工程指南，强调新模型需重新调优而非直接复用旧提示。

## Key Takeaways

- GPT-5.5 需要从零开始优化提示，而非简单复用旧版本的配置。
- 推荐在多步任务中发送简短用户可见更新以提升体验。
- Codex 提供自动代码迁移工具以适配 GPT-5.5。

## Content

Title: GPT-5.5 prompting guide

URL Source: http://simonwillison.net/2026/Apr/25/gpt-5-5-prompting-guide/

Published Time: Sat, 25 Apr 2026 04:15:00 GMT

Markdown Content:
25th April 2026 - Link Blog

**[GPT-5.5 prompting guide](https://developers.openai.com/api/docs/guides/prompt-guidance?model=gpt-5.5)**. Now that GPT-5.5 is [available in the API](https://developers.openai.com/api/docs/models/gpt-5.5), OpenAI have released a wealth of useful tips on how best to prompt the new model.

Here's a neat trick they recommend for applications that might spend considerable time thinking before returning a user-visible response:

```
Before any tool calls for a multi-step task, send a short user-visible update that acknowledges the request and states the first step. Keep it to one or two sentences.
```

I've already noticed their Codex app doing this, and it does make longer running tasks feel less like the model has crashed.

OpenAI suggest running the following in Codex to upgrade your existing code using advice embedded in their `openai-docs` skill:

```
$openai-docs migrate this project to gpt-5.5
```

The upgrade guide the coding agent will follow [is this one](https://github.com/openai/skills/blob/724cd511c96593f642bddf13187217aa155d2554/skills/.curated/openai-docs/references/upgrade-guide.md#model-string--light-prompt-rewrite), which even includes light instructions on how to rewrite prompts to better fit the model.

Also relevant is the [Using GPT-5.5 guide](https://developers.openai.com/api/docs/guides/latest-model), which opens with this warning:

> To get the most out of GPT-5.5, treat it as a new model family to tune for, not a drop-in replacement for `gpt-5.2` or `gpt-5.4`. Begin migration with a fresh baseline instead of carrying over every instruction from an older prompt stack. Start with the smallest prompt that preserves the product contract, then tune reasoning effort, verbosity, tool descriptions, and output format against representative examples.

Interesting to see OpenAI recommend starting from scratch rather than trusting that existing prompts optimized for previous models will continue to work effectively with GPT-5.5.