# 角色設定
你是一名擁有10年經(jīng)驗的資深{編程語言}開發(fā)工程師，精通{技術(shù)棧}，代碼風格簡潔、高效、可維護，嚴格遵循PEP8/Google代碼規(guī)范。

# 任務描述
請幫我{具體任務描述，越詳細越好}。

# 上下文信息
- 項目使用的技術(shù)棧：{技術(shù)棧列表}
- 現(xiàn)有代碼結(jié)構(gòu)：{簡要說明現(xiàn)有代碼結(jié)構(gòu)或粘貼相關代碼片段}
- 輸入輸出要求：{明確輸入?yún)?shù)和輸出結(jié)果}

# 約束條件
1. 必須使用{指定庫/框架}，不要使用其他第三方庫
2. 代碼必須包含詳細的注釋和文檔字符串
3. 必須處理所有可能的異常情況
4. 性能要求：{如"函數(shù)執(zhí)行時間不能超過100ms"}
5. 安全要求：{如"必須防止SQL注入/XSS攻擊"}

# 輸出格式
- 先簡要說明實現(xiàn)思路
- 然后輸出完整的代碼
- 最后說明使用方法和注意事項

第一步：分析需求，列出實現(xiàn)這個功能需要的3個核心模塊
第二步：為每個模塊設計接口和數(shù)據(jù)結(jié)構(gòu)
第三步：實現(xiàn)第一個模塊的代碼
第四步：實現(xiàn)第二個模塊的代碼
...

你是一名后端架構(gòu)師，負責設計高并發(fā)、高可用的分布式系統(tǒng)。
你是一名安全工程師，擅長發(fā)現(xiàn)和修復代碼中的安全漏洞。
你是一名性能優(yōu)化專家，能夠?qū)⒋a的運行速度提升10倍以上。

我希望你按照以下風格編寫代碼：
示例1：
def add(a, b):
    """計算兩個數(shù)的和
    
    Args:
        a: 第一個數(shù)
        b: 第二個數(shù)
        
    Returns:
        兩個數(shù)的和
    """
    return a + b

請按照相同的風格編寫一個乘法函數(shù)。

不要使用遞歸實現(xiàn)，因為遞歸深度過大會導致棧溢出
不要使用全局變量
不要寫過于復雜的一行代碼，要保證可讀性

codex plan "創(chuàng)建一個完整的個人博客系統(tǒng)，使用Python FastAPI作為后端，Vue 3作為前端，MySQL作為數(shù)據(jù)庫。要求包含用戶認證、文章管理、評論管理、標簽管理等功能。"

personal-blog/
├── backend/
│   ├── app/
│   │   ├── __init__.py
│   │   ├── main.py
│   │   ├── api/
│   │   ├── models/
│   │   ├── schemas/
│   │   ├── services/
│   │   └── utils/
│   ├── requirements.txt
│   ├── .env
│   └── README.md
├── frontend/
│   ├── src/
│   ├── public/
│   ├── package.json
│   └── README.md
├── docker-compose.yml
└── README.md

# 生成后端配置文件
codex run "根據(jù)上面的項目結(jié)構(gòu)，生成backend目錄下的requirements.txt、.env和main.py文件。要求使用SQLAlchemy作為ORM，Pydantic作為數(shù)據(jù)驗證，JWT作為認證方式。"
# 生成數(shù)據(jù)庫模型
codex run "生成用戶、文章、評論、標簽四個模型的代碼，放在backend/app/models目錄下。要求包含必要的字段和關系。"
# 生成API接口
codex run "生成用戶認證相關的API接口，包括注冊、登錄、獲取用戶信息等，放在backend/app/api/auth.py目錄下。"

# 進入項目根目錄
cd your-project
# 初始化Codex項目
codex init

# 基于現(xiàn)有項目添加新功能
codex run "在用戶模型中添加一個'頭像'字段，并更新對應的API接口和數(shù)據(jù)庫遷移腳本。"
# 查找項目中的bug
codex run "分析項目中的登錄功能，找出可能存在的安全漏洞。"

# 生成單元測試
codex run "為用戶認證API接口編寫單元測試，使用pytest框架，覆蓋所有正常和異常情況。"
# 生成API文檔
codex run "根據(jù)現(xiàn)有的API接口代碼，生成完整的API文檔，使用Markdown格式。"
# 生成項目README
codex run "為這個項目生成一個詳細的README.md文件，包含項目介紹、技術(shù)棧、安裝部署步驟、使用說明和貢獻指南。"

codex run "我運行以下代碼時出現(xiàn)了錯誤，請幫我分析原因并修復：
代碼：
{你的代碼}
錯誤信息：
{完整的錯誤堆棧信息}
"

第一步：分析錯誤堆棧信息，定位可能出錯的位置
第二步：解釋錯誤產(chǎn)生的原因
第三步：提供至少兩種解決方案
第四步：修改后的完整代碼

codex run "重構(gòu)以下代碼，消除代碼異味，提高可讀性和可維護性：\n\n{代碼片段}"

codex run "將以下代碼重構(gòu)為使用單例模式：\n\n{代碼片段}"

codex run "優(yōu)化以下代碼的性能，盡可能減少時間和空間復雜度：\n\n{代碼片段}\n\n說明優(yōu)化前后的性能對比。"

codex run "按照PEP8規(guī)范格式化以下Python代碼：\n\n{代碼片段}"

codex run "掃描以下代碼中的安全漏洞，包括SQL注入、XSS攻擊、CSRF攻擊、命令注入等，并提供修復方案：\n\n{代碼片段}"

#!/bin/bash
# 獲取暫存的Python文件
FILES=$(git diff --cached --name-only --diff-filter=ACM | grep '\.py$')
if [ -n "$FILES" ]; then
    echo "正在使用Codex審查代碼..."
    for FILE in $FILES; do
        echo "審查文件: $FILE"
        codex run "審查以下Python代碼的質(zhì)量，找出可能的bug、代碼異味和安全問題，并提供改進建議：\n\n$(cat $FILE)"
    done
    # 詢問是否繼續(xù)提交
    read -p "是否繼續(xù)提交？(y/n) " -n 1 -r
    echo
    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
        echo "提交已取消"
        exit 1
    fi
fi
exit 0

chmod +x .git/hooks/pre-commit

# 保存為generate-pr-description.ps1
param(
    [string]$baseBranch="main",
    [string]$headBranch=$(git rev-parse --abbrev-ref HEAD)
)
# 獲取提交記錄
$commits=$(git log --oneline $baseBranch..$headBranch)
# 使用Codex生成PR描述
codex run "根據(jù)以下Git提交記錄，生成一個詳細的Pull Request描述，包含變更內(nèi)容、變更原因和測試方法：\n\n$commits"

.\generate-pr-description.ps1

codex run "根據(jù)以下兩個模型的差異，生成Alembic數(shù)據(jù)庫遷移腳本：
舊模型：
{舊模型代碼}
新模型：
{新模型代碼}
"

# config.toml
[models]
default = "gpt-5.5-codex"
temperature = 0.3  # 代碼生成推薦0.2-0.5
max_tokens = 4096
top_p = 1
frequency_penalty = 0
presence_penalty = 0