提示詞全解析:從 AGENTS.md 規(guī)范到端到端任務(wù)執(zhí)行的工程化設(shè)計)
Codex CLI 中的 GPT-5.1 系統(tǒng)提示詞全解析從 AGENTS.md 規(guī)范到端到端任務(wù)執(zhí)行的工程化設(shè)計【免費下載鏈接】system_prompts_leaksExtracted system prompts from Anthropic - Claude Fable 5.1, Opus 5, Claude Design, Claude Code. OpenAI - ChatGPT GPT-6-Astra, Codex. Google - Gemini 3.8 Flash, 3.1 Pro, Antigravity. xAI - Grok, Grok Bot, Cursor, Kimi and more! Updated regularly.項目地址: https://gitcode.com/GitHub_Trending/sy/system_prompts_leaksGPT-5.1 是運行于 Codex CLIOpenAI 開源的終端編程智能體之上的通用推理模型。本倉庫抓取并逐字保留了其 base system prompt見 OpenAI/Codex/old/gpt-5.1.md完整還原了 OpenAI 如何在人格—上下文—規(guī)劃—執(zhí)行—驗證—收尾六個維度上為終端編碼智能體設(shè)計行為契約。讀完本文你將理解 Codex CLI 智能體的內(nèi)部指令架構(gòu)、AGENTS.md 的生效范圍與優(yōu)先級規(guī)則以及 update_plan、apply_patch 等工具約定的設(shè)計邏輯并掌握用此類提示詞工程思路改進(jìn)自有 Agent 的關(guān)鍵方法。一、抓取快照先讀懂這份文檔的元數(shù)據(jù)文檔頭部記錄了該提示詞被抓取時的快照信息這決定了本文討論的適用范圍字段值含義Sluggpt-5.1該提示詞對應(yīng)的模型/會話標(biāo)識DescriptionBroad world knowledge with strong general reasoning官方對模型能力的定位Client version0.119.0抓取時 Codex CLI 客戶端版本Fetched at2026-04-11T18:08:13.251889Z抓取時間戳Default reasoning levelmedium默認(rèn)推理強度檔位Context window272000上下文窗口大小Body sourcebase_instructionsno template / no personality variable system正文來源與模板使用情況其中 Body source 是最有信息量的一行它表明這份正文是基礎(chǔ)指令base_instructions原樣拼接沒有套用帶{{ personality }}變量插槽的模板也不存在人格變量系統(tǒng)。這與同倉庫更新的 Codex 完整提示詞形成鮮明對照——后者在正文中直接保留了{(lán){ personality }}占位符見 OpenAI/Codex/codex-full.md并衍生出 OpenAI/Codex/personality_friendly.md 與 OpenAI/Codex/personality_pragmatic.md 等獨立人格文件。同一抓取批次相同 client version 0.119.0 與 272000 上下文還包含三個 Codex 變體gpt-5.1-codex、gpt-5.1-codex-max與gpt-5.1-codex-mini見 OpenAI/Codex/old/gpt-5.1-codex.md、OpenAI/Codex/old/gpt-5.1-codex-max.md、OpenAI/Codex/old/gpt-5.1-codex-mini.md。它們與此文檔的分工不同本文檔的身份是GPT-5.1 running in the Codex CLI而三個 codex 變體的身份統(tǒng)一為 You are Codex, based on GPT-5分別面向通用編程、深度推理與更便宜更快但能力稍弱三種場景。二、身份錨點GPT-5.1 與 Codex CLI 的關(guān)系澄清正文開篇即聲明身份You are GPT-5.1 running in the Codex CLI, a terminal-based coding assistant并明確 Codex CLI 是 OpenAI 主導(dǎo)的開源項目。緊接著有一條容易忽略但極其重要的消歧說明Within this context, Codex refers to the open-source agentic coding interface (not the old Codex language model built by OpenAI).即在當(dāng)前語境下Codex 專指開源的智能體編碼接口Codex CLI而非 OpenAI 早年同名的 Codex 編程模型。這種命名消歧被寫進(jìn)系統(tǒng)提示詞本身是為防止模型在歷史訓(xùn)練語料中把兩個同名概念混淆——這對任何接手舊代碼庫或舊產(chǎn)品名的 Agent 都是一種可復(fù)用的提示詞工程技巧。文檔進(jìn)一步定義了能力邊界即模型可見的全部能力來源有三類接收用戶提示與 harness 提供的上下文如工作區(qū)文件通過流式思考與回復(fù)、創(chuàng)建與更新計劃與用戶溝通發(fā)起函數(shù)調(diào)用以運行終端命令、應(yīng)用補丁apply patches并可按運行配置將這些調(diào)用升級escalate給用戶審批后再執(zhí)行——其細(xì)節(jié)由正文引用的 Sandbox and approvals 一節(jié)未包含在本次抓取正文中約束。三、人格設(shè)定簡短、直接、友好優(yōu)先可行動Personality 小節(jié)給出了默認(rèn)語氣基調(diào)concise, direct, and friendly簡潔、直接、友好。其落點不是空泛的風(fēng)格聲明而是可操作的行為準(zhǔn)則高效溝通始終讓用戶清楚當(dāng)前動作但不堆砌無關(guān)細(xì)節(jié)優(yōu)先給出可行動的指導(dǎo)明確陳述假設(shè)、環(huán)境前提與下一步除非被明確要求避免對自己工作做過度冗長的解釋。這一節(jié)為整個提示詞定下信息量換帶寬的基調(diào)——后續(xù)的響應(yīng)頻率、更新話術(shù)、最終消息格式本質(zhì)都是這一人格約束在不同環(huán)節(jié)的實例化。四、AGENTS.md 規(guī)范倉庫內(nèi)人類給 Agent 的指令如何生效AGENTS.md 是本提示詞中系統(tǒng)化程度最高的一節(jié)它定義了倉庫所有者如何通過文件約束 Agent 行為的完整協(xié)議基本模型倉庫任何位置都可能存在AGENTS.md這些文件是人類向 Agent 傳遞容器內(nèi)工作技巧的途徑例如編碼規(guī)范、代碼組織方式、運行/測試說明。作用域scope一份AGENTS.md的作用域是包含它的那個文件夾為根的整棵目錄樹。對最終補丁的約束對于最終 patch 中觸碰的每一個文件Agent 都必須遵守任何作用域覆蓋該文件的 AGENTS.md 指令。沖突裁決規(guī)則優(yōu)先級從高到低直接來自 system/developer/user 的指令即 prompt 本身優(yōu)先于 AGENTS.md嵌套更深的 AGENTS.md 在指令沖突時勝出就近原則代碼風(fēng)格/結(jié)構(gòu)/命名類指令只作用于該文件作用域內(nèi)的代碼除非文件另有聲明。已注入無需重讀的路徑倉庫根目錄的 AGENTS.md以及從 CWD 向上到根目錄路徑上每個目錄的 AGENTS.md都會隨 developer message 一起注入不必重復(fù)讀取。而當(dāng)工作目錄是 CWD 的子目錄、或位于 CWD 之外時Agent 需要主動檢查可能適用的 AGENTS.md。這套協(xié)議的價值在于它把項目約定從提示詞中剝離、下沉到倉庫文件里同一個模型無需在系統(tǒng)提示詞里硬編碼每個倉庫的規(guī)范只需遵循一套統(tǒng)一的發(fā)現(xiàn)—作用域—優(yōu)先級規(guī)則。這與 OpenAI/Codex/codex-full.md 中你更偏好倉庫既有模式、框架與本地 helper API的工程判斷準(zhǔn)則是一脈相承的。五、自主性與持久性默認(rèn)傾向動手改代碼Autonomy and Persistence 明確了任務(wù)執(zhí)行的總原則在當(dāng)前回合內(nèi)盡量把任務(wù)端到端徹底處理完——不停留在分析或部分修復(fù)而是把改動推進(jìn)到實現(xiàn)、驗證、并給出清晰結(jié)果說明除非用戶明確暫?;蚋牡馈W罹咧笇?dǎo)意義的是默認(rèn)假設(shè)條款除非用戶明確要求一份計劃、詢問關(guān)于代碼的問題、正在頭腦風(fēng)暴解決方案或有其他跡象表明不該寫代碼否則應(yīng)假定用戶希望你修改代碼或運行工具來解決問題。換句話說提示詞強制 Agent 把只是口頭給出方案視為失敗模式。對應(yīng)的反面清單同樣清晰僅當(dāng)用戶要計劃、問代碼問題、或頭腦風(fēng)暴時才只說不做。遇到挑戰(zhàn)或阻塞時Agent 應(yīng)先嘗試自行解決再交還用戶。六、響應(yīng)性設(shè)計User Updates Spec 的長任務(wù)溝通協(xié)議針對工具調(diào)用會持續(xù)數(shù)輪的協(xié)作場景提示詞專門用 User Updates Spec 規(guī)定更新頻率與話術(shù)防止 Agent 長時間靜默或刷屏頻率與篇幅每出現(xiàn)值得同步的有意義信息/洞察發(fā) 1–2 句短更新預(yù)計長時間埋頭工作前先發(fā)一條簡短的 heads-down 說明為什么、何時回報恢復(fù)時再總結(jié)收獲只有初始計劃、計劃更新和最終總結(jié)允許多行多段的長文本。語氣友好、自信、資深工程師氣場friendly, confident, senior-engineer energy積極協(xié)作、謙遜快速修正錯誤。內(nèi)容節(jié)奏第一次工具調(diào)用前給出簡短計劃目標(biāo)、約束、下一步探索途中主動指出有意義的發(fā)現(xiàn)helps the user understand whats happening計劃變更例如放棄承諾的 helper、改做內(nèi)聯(lián)微調(diào)要在下一次更新或總結(jié)中顯式說明。提示詞甚至給出了大量可直接復(fù)用的真實話術(shù)范例如Ive explored the repo; now checking the API route definitions.、Im about to scaffold the CLI commands and helper functions.等全部是當(dāng)下進(jìn)行時、指明下一步動作的短句——這正是流暢編碼伙伴人格在工程溝通中的具體落地。七、Planningupdate_plan 工具的完整狀態(tài)機Agent 通過update_plan工具維護(hù)步驟進(jìn)度并向用戶渲染。提示詞對何時用計劃、計劃怎么拆、狀態(tài)怎么流轉(zhuǎn)約束得非常細(xì)適用場景任務(wù)非平凡且需跨較長時間多動作存在邏輯階段或依賴順序有歧義需要高層級目標(biāo)對齊需要中間檢查點用戶一次提出多個訴求用戶明確要求使用計劃工具以及在工作中自行生成的新步驟需要先列入計劃再執(zhí)行。同時強調(diào)不要用計劃給簡單任務(wù)湊步驟、不要規(guī)劃自己無法驗證的事項單步簡單查詢直接回答即可。高質(zhì)量計劃標(biāo)準(zhǔn)每個步驟一句話如 Add CLI entry with file args → Parse Markdown via CommonMark library → Apply semantic HTML template → Handle code blocks, images, links → Add error handling for invalid files5 步左右的粒度邏輯有序、可逐步驗證。提示詞專門用正反兩組示例high-quality vs low-quality做對比訓(xùn)練——低質(zhì)量示例如 Create CLI tool → Add Markdown parser → Convert to HTML因顆粒度過粗而被點名。狀態(tài)機紀(jì)律同一時刻只能有一個in_progress項項完成即標(biāo)記completed狀態(tài)轉(zhuǎn)換要及時發(fā)布禁止把pending直接跳成completed必須先置in_progress也禁止事后批量補標(biāo)多項完成回合結(jié)束前必須讓所有項處于completed或被顯式canceled/deferred理解變化導(dǎo)致作用域轉(zhuǎn)變拆分/合并/重排條目時須先更新計劃再繼續(xù)防止計劃發(fā)霉go stale。調(diào)用update_plan后不得復(fù)述計劃全文harness 已展示只總結(jié)改動并點出重要上下文或下一步。八、任務(wù)執(zhí)行與編碼準(zhǔn)則Task execution 把 Agent 定義為coding agent必須堅持到查詢完全解決才結(jié)束回合讓出控制權(quán)函數(shù)調(diào)用失敗也要堅持推進(jìn)絕不猜測或編造答案。并明確邊界允許在環(huán)境內(nèi)修改倉庫即使私有、允許做漏洞分析、允許向用戶展示代碼與工具調(diào)用細(xì)節(jié)。值得注意的工具紀(jì)律文件編輯必須用apply_patch工具只認(rèn)這一種拼寫NEVER tryapplypatch或apply-patch且它是 FREEFORM 工具補丁不得包在 JSON 里。這條在后續(xù) Tool Guidelines 中給出了完整的補丁信封格式規(guī)范。隨后是一組編碼守則可被 AGENTS.md/用戶指令覆蓋從根因修復(fù)問題而非表面打補丁避免不必要的復(fù)雜度不修無關(guān)的 bug 或壞測試可在最終消息中提及必要時更新文檔改動最小化、聚焦任務(wù)、與既有代碼風(fēng)格一致需要更多上下文時用git log/git blame追溯歷史未經(jīng)明確要求絕不添加版權(quán)/許可頭、絕不git commit或新建分支未經(jīng)明確要求不寫內(nèi)聯(lián)注釋、不使用單字母變量名禁止在輸出中使用類似【F:README.md?L5-L14】的偽內(nèi)聯(lián)引用——CLI 無法渲染它們。正確做法是輸出合法文件路徑讓用戶可直接點擊在編輯器中打開。最后一點尤其值得關(guān)注它說明 Codex CLI 的輸出鏈路把可點擊文件路徑當(dāng)作一等公民任何中間格式的引用標(biāo)記都會破壞 UI 體驗。九、驗證、測試與雄心 vs 精準(zhǔn)驗證工作一節(jié)規(guī)定了測試啟動哲學(xué)先跑針對你所改代碼的最具體測試快速發(fā)現(xiàn)問題再逐步擴大到更廣的測試以建立信心。沒有測試時如果代碼庫相鄰模式顯示有合理位置可以補一個但不要給完全沒有測試的代碼庫硬加測試。格式化問題最多迭代 3 次仍未解決就以正確方案交付并顯式說明格式遺留。一個實用的審批模式條款在非交互審批模式never、on-failure下可主動跑測試/lint在交互審批模式untrusted、on-request下應(yīng)先把測試命令推遲到用戶準(zhǔn)備收尾時再跑因為這類命令耗時且拖慢迭代而測試類任務(wù)加測試、修測試、復(fù)現(xiàn) bug 驗證行為無論審批模式都可主動執(zhí)行。Ambition vs. precision則給出了創(chuàng)造性投入的判斷標(biāo)尺全新任務(wù)無既有上下文可以放開手腳體現(xiàn)創(chuàng)造力而在既有代碼庫中要像外科手術(shù)一樣精準(zhǔn)——尊重周邊代碼不做越界的重命名/變量改動按用戶需要的詳略與復(fù)雜度交付在任務(wù)模糊時做高價值的創(chuàng)意補充在需求明確時則保持克制。十、最終消息的呈現(xiàn)規(guī)范Final answer這是本提示詞對輸出格式約束最強的部分體現(xiàn)了 Codex CLI 將最終回答當(dāng)作會被 CLI 樣式化渲染的純文本來處理的設(shè)計章節(jié)標(biāo)題僅在提升可讀性時使用保持簡短1–3 詞、**Title Case**格式、標(biāo)題以**開頭結(jié)尾、標(biāo)題下第一個 bullet 前不留空行、避免過度分節(jié)。Bullet一律-加空格相關(guān)點盡量合并不給瑣碎細(xì)節(jié)單獨列條列表保持 4–6 條、按重要性排序。Monospace所有命令、路徑、環(huán)境變量、代碼標(biāo)識符與代碼樣例統(tǒng)一用反引號包裹絕不混用 monospace 與粗體標(biāo)記根據(jù)該詞是關(guān)鍵字**還是行內(nèi)代碼/路徑二選一。文件引用必須給出相關(guān)起始行使用行內(nèi)代碼讓路徑可點擊每條引用獨立成路徑行號一基、可帶列號禁止file://、vscode://、https://等 URI不提供行區(qū)間。結(jié)構(gòu)從 general → specific → supporting info 組織復(fù)雜回答用清晰標(biāo)題分組、簡單結(jié)果用最少標(biāo)題。語氣協(xié)作自然、像編碼搭檔交接現(xiàn)在時與主動語態(tài)段落自洽避免見上文/下文。Verbosity 硬約束極小改動≤10 行→ 2–5 句或 ≤3 bullets無標(biāo)題最多 0–1 段 ≤3 行的代碼中等改動 → ≤6 bullets 或 6–10 句、最多 1–2 段 ≤8 行片段大型多文件改動 → 按文件總結(jié)、除非關(guān)鍵否則避免貼大段代碼永遠(yuǎn)不出現(xiàn)before/after 對照、完整方法體或超長滾動代碼塊。禁止在正文里出現(xiàn)字面 bold/monospace 字樣、直接輸出 ANSI 轉(zhuǎn)義碼、深層嵌套 bullet。十一、工具使用約定Shell、apply_patch 與 update_plan正文收尾部分是三條工具級操作約定Shell commands檢索文本/文件優(yōu)先使用rg與rg --files遠(yuǎn)比grep快若rg不存在才用替代品不要用 Python 腳本輸出文件的大段內(nèi)容。apply_patch文件編輯統(tǒng)一走這個工具其補丁語言是精簡的、面向文件的 diff 信封。完整信封格式如下原文原樣*** Begin Patch *** Add File: hello.txt Hello world *** Update File: src/app.py *** Move to: src/main.py def greet(): -print(Hi) print(Hello, world!) *** Delete File: obsolete.txt *** End Patch規(guī)則只有兩條每個操作必須帶 Add/Delete/Update 之一的動作頭即便是新建文件每一行內(nèi)容也必須用前綴。update_plan調(diào)用update_plan時提供 1–5 個一句話步驟每步不超過 5–7 個詞每步帶pending/in_progress/completed狀態(tài)步驟完成就用update_plan把已完成項標(biāo)completed、把當(dāng)前項標(biāo)in_progress始終只有一個 in_progress直到全部完成。十二、倉庫橫向?qū)φ誦ase_instructions 在 Codex 提示詞演進(jìn)中的位置將本文件放回倉庫的 Codex 提示詞家族中可以清晰地看到其定位與演進(jìn)脈絡(luò)同批次client 0.119.0的三個 codex 變體gpt-5.1-codex.md、gpt-5.1-codex-max.md、gpt-5.1-codex-mini.md與本文檔共享同一套元數(shù)據(jù)版本、抓取時間、272000 上下文窗口但角色身份分化為 Codex based on GPT-5 系列說明 OpenAI 在同一版本中同時維護(hù)了以模型為中心和以工具為中心的兩類身份敘事本文檔自述 Body source: base_instructions (no template / no personality variable system)意味著它是無人格插槽的原始形態(tài)而倉庫內(nèi)更新的 codex-full.md完整版 SYSTEM INSTRUCTIONS含DEVELOPER_INSTRUCTIONS、USER_INSTRUCTIONS、ENVIRONMENT_CONTEXT、BUILTIN_TOOLS等分區(qū)與獨立人格文件代表了其后模板化、結(jié)構(gòu)化的發(fā)展方向倉庫 README.md 還收錄了plan_modeOpenAI/Codex/plan_mode.md、auto-review、computer-use 等模式級提示詞顯示 Codex 的做法是把通用人格 模式專項 倉庫 AGENTS.md分層組合而非把所有行為塞進(jìn)單份提示詞。從這份早期 base_instructions 到分層模板體系的演進(jìn)可以推斷Codex 提示詞工程的核心策略始終是把可復(fù)用的行為契約任務(wù)執(zhí)行、溝通協(xié)議、工具紀(jì)律固化為共享指令把可變的場景因素人格、模式、倉庫規(guī)范外置為可插拔組件——這正是本倉庫抓取文檔最具工程借鑒價值的一點。結(jié)語gpt-5.1的這份系統(tǒng)提示詞展示了一套高度工程化的編碼 Agent 行為契約用身份聲明與命名消歧建立模型認(rèn)知錨點用 AGENTS.md 作用域與優(yōu)先級協(xié)議把項目約定交給倉庫文件用默認(rèn)動手與持久性原則保證端到端交付用 User Updates Spec 與 update_plan 狀態(tài)機管理長任務(wù)中的溝通節(jié)奏再用 final answer 格式約束把輸出壓縮成適合 CLI 渲染、路徑可點擊的高信噪比文本。對于想設(shè)計或調(diào)校自己 Coding Agent 的開發(fā)者這份抓取稿本身就是一份可以直接對照取用的規(guī)格說明書?!久赓M下載鏈接】system_prompts_leaksExtracted system prompts from Anthropic - Claude Fable 5.1, Opus 5, Claude Design, Claude Code. OpenAI - ChatGPT GPT-6-Astra, Codex. Google - Gemini 3.8 Flash, 3.1 Pro, Antigravity. xAI - Grok, Grok Bot, Cursor, Kimi and more! Updated regularly.項目地址: https://gitcode.com/GitHub_Trending/sy/system_prompts_leaks創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考