def prompt_design_principles():
    """提示詞設(shè)計原則"""
    principles = {
        "明確性": "指令要清晰、具體，避免模糊表述",
        "完整性": "提供足夠的背景信息和約束條件",
        "結(jié)構(gòu)化": "使用標題、列表等結(jié)構(gòu)組織內(nèi)容",
        "可驗證性": "要求 AI 提供可驗證的輸出",
        "迭代優(yōu)化": "根據(jù)反饋不斷優(yōu)化提示詞"
    }
    return principles

def project_init_prompt():
    """項目初始化提示詞"""
    prompt = """
    # 項目初始化指令
    
    請基于以下信息，完成項目的初始化工作：
    
    ## 項目信息
    - 項目名稱：[項目名稱]
    - 項目描述：[項目描述]
    - 技術(shù)棧：[前端技術(shù)棧] + [后端技術(shù)棧] + [數(shù)據(jù)庫]
    - 項目路徑：[項目路徑]
    
    ## 初始化要求
    1. 創(chuàng)建項目目錄結(jié)構(gòu)
    2. 初始化 Git 倉庫
    3. 創(chuàng)建基礎(chǔ)配置文件
    4. 設(shè)置開發(fā)環(huán)境
    5. 提供啟動指南
    
    ## 輸出要求
    - 列出創(chuàng)建的所有文件
    - 說明每個文件的作用
    - 提供完整的項目結(jié)構(gòu)
    """
    return prompt

def requirements_analysis_prompt():
    """需求分析提示詞"""
    prompt = """
    # 需求分析指令
    
    請分析以下需求文檔，并輸出結(jié)構(gòu)化的需求分析報告：
    
    ## 原始需求
    [粘貼需求文檔內(nèi)容]
    
    ## 分析要求
    1. **需求理解**：用一句話概括核心目標
    2. **功能識別**：列出所有功能點，按優(yōu)先級排序
    3. **技術(shù)難點**：識別技術(shù)難點和風險點
    4. **約束條件**：列出技術(shù)、時間、資源等約束
    5. **用戶畫像**：描述目標用戶特征
    
    ## 輸出格式
    請使用 Markdown 格式輸出，包含以下章節(jié)：
    - 需求概述
    - 功能清單（表格形式，包含名稱、描述、優(yōu)先級）
    - 技術(shù)難點分析
    - 約束條件
    - 用戶畫像
    """
    return prompt

def architecture_design_prompt():
    """技術(shù)架構(gòu)設(shè)計提示詞"""
    prompt = """
    # 技術(shù)架構(gòu)設(shè)計指令
    
    請基于以下需求，設(shè)計完整的技術(shù)架構(gòu)方案：
    
    ## 需求背景
    [簡要描述項目背景和目標]
    
    ## 功能需求
    [列出核心功能]
    
    ## 技術(shù)約束
    - 前端框架：[框架名稱]
    - 后端框架：[框架名稱]
    - 數(shù)據(jù)庫：[數(shù)據(jù)庫名稱]
    - 其他要求：[性能、安全、擴展性等]
    
    ## 設(shè)計要求
    1. **架構(gòu)風格**：選擇合適的架構(gòu)風格（如分層架構(gòu)、微服務(wù)等）
    2. **模塊劃分**：劃分系統(tǒng)模塊，說明職責
    3. **技術(shù)選型**：詳細說明技術(shù)選型及理由
    4. **關(guān)鍵設(shè)計**：
       - 數(shù)據(jù)庫設(shè)計（ER 圖描述）
       - API 設(shè)計（RESTful 規(guī)范）
       - 安全設(shè)計（認證、授權(quán)、防護）
       - 性能設(shè)計（緩存、異步處理）
    5. **部署方案**：描述部署架構(gòu)
    
    ## 輸出格式
    請使用 Markdown 格式輸出，包含架構(gòu)圖描述和詳細設(shè)計文檔。
    """
    return prompt

def code_generation_prompt():
    """代碼生成提示詞"""
    prompt = """
    # 代碼生成指令
    
    請基于以下設(shè)計文檔，生成完整的項目代碼：
    
    ## 設(shè)計文檔
    - 架構(gòu)設(shè)計：[架構(gòu)設(shè)計文檔內(nèi)容]
    - 數(shù)據(jù)庫設(shè)計：[數(shù)據(jù)庫設(shè)計文檔內(nèi)容]
    - API 設(shè)計：[API 設(shè)計文檔內(nèi)容]
    
    ## 技術(shù)棧
    - 前端：[前端技術(shù)棧]
    - 后端：[后端技術(shù)棧]
    - 數(shù)據(jù)庫：[數(shù)據(jù)庫名稱]
    
    ## 代碼要求
    1. **代碼結(jié)構(gòu)**：清晰的目錄結(jié)構(gòu)和模塊劃分
    2. **代碼質(zhì)量**：符合編碼規(guī)范，注釋完整
    3. **錯誤處理**：完善的異常處理和錯誤反饋
    4. **安全性**：防止 SQL 注入、XSS 等安全問題
    5. **可測試性**：代碼易于測試，包含單元測試
    
    ## 輸出要求
    - 按模塊逐步輸出代碼
    - 每個文件注明存放路徑
    - 提供配置文件和啟動指南
    - 包含必要的測試代碼
    """
    return prompt

def risk_engine_prompt():
    """智能風控決策引擎提示詞"""
    prompt = """
    # 智能風控決策引擎平臺開發(fā)
    
    ## 技術(shù)棧要求
    - 前端：Vue 3 + Element Plus + Pinia + Vite
    - 后端：FastAPI + SQLAlchemy(async) + MySQL + Redis
    - 采用分層架構(gòu)（路由/服務(wù)/倉儲/模型）
    - 前后端分離，RESTful API，JWT 認證
    
    ## 階段 1：需求文檔確認
    列出功能清單與優(yōu)先級：
    
    | 優(yōu)先級 | 功能模塊 | 描述 |
    |-------|---------|------|
    | P0 | 登錄權(quán)限 | 用戶登錄、JWT 認證、權(quán)限控制 |
    | P0 | 用戶角色管理 | 角色定義、權(quán)限分配、用戶管理 |
    | P1 | 黑白名單管理 | 名單配置、規(guī)則匹配、實時生效 |
    | P1 | 風控特征管理 | 特征定義、計算規(guī)則、版本管理 |
    | P2 | 可視化規(guī)則配置 | 規(guī)則編輯器、條件組合、優(yōu)先級 |
    | P2 | 拖拽式?jīng)Q策流編排 | 流程設(shè)計、節(jié)點配置、條件分支 |
    | P2 | 評分卡模型 | 評分規(guī)則、權(quán)重配置、結(jié)果計算 |
    | P3 | 實時決策 API | 風險評估接口、決策結(jié)果返回 |
    | P3 | 大盤報表 | 數(shù)據(jù)可視化、趨勢分析、統(tǒng)計匯總 |
    | P3 | 決策日志追溯 | 操作記錄、決策詳情、審計追蹤 |
    | P4 | 模擬請求測試 | 測試工具、參數(shù)配置、結(jié)果對比 |
    
    明確 MVP 范圍（P0-P1）與后續(xù)擴展項（P2-P4）。
    
    ## 階段 2：技術(shù)棧與架構(gòu)設(shè)計
    輸出完整的技術(shù)架構(gòu)設(shè)計文檔，包含：
    - 系統(tǒng)架構(gòu)圖（前端、后端、數(shù)據(jù)庫、緩存）
    - 模塊劃分（認證、規(guī)則、決策、報表等）
    - 關(guān)鍵技術(shù)選型理由
    - API 設(shè)計規(guī)范
    - 安全設(shè)計方案
    
    ## 階段 3：數(shù)據(jù)庫表結(jié)構(gòu)設(shè)計
    按模塊設(shè)計表結(jié)構(gòu)，輸出：
    
    | 表名 | 用途 | 核心字段 |
    |------|------|---------|
    | users | 用戶信息 | id, username, password_hash, role_id |
    | roles | 角色信息 | id, name, permissions |
    | black_white_lists | 黑白名單 | id, type, value, description, status |
    | risk_features | 風控特征 | id, name, formula, version |
    | rules | 規(guī)則定義 | id, name, conditions, action, priority |
    | decision_flows | 決策流 | id, name, nodes, edges |
    | score_cards | 評分卡 | id, name, factors, weights |
    | decision_logs | 決策日志 | id, request_id, result, details, created_at |
    
    輸出完整的 SQLAlchemy 模型代碼預覽。
    
    ## 階段 4：技術(shù)方案與核心難點
    詳細說明以下技術(shù)方案：
    
    1. **決策流編排實現(xiàn)**：
       - 前端：使用 vue-flow 實現(xiàn)拖拽式流程設(shè)計
       - 后端：解析 DAG（有向無環(huán)圖）執(zhí)行決策流程
       - 支持的節(jié)點類型：開始、結(jié)束、條件判斷、規(guī)則執(zhí)行、評分計算、API 調(diào)用
    
    2. **評分卡模型計算**：
       - 權(quán)重配置：支持手動配置各因子權(quán)重
       - 計算邏輯：加權(quán)求和，支持非線性變換
       - 閾值劃分：根據(jù)分數(shù)劃分風險等級
    
    3. **規(guī)則引擎**：
       - 表達式解析：支持常見運算符和函數(shù)
       - 規(guī)則組合：AND/OR 條件組合
       - 優(yōu)先級處理：按優(yōu)先級順序執(zhí)行
    
    4. **實時決策 API 高并發(fā)設(shè)計**：
       - 請求緩存：Redis 緩存高頻請求
       - 異步處理：復雜計算異步執(zhí)行
       - 負載均衡：支持水平擴展
    
    ## 輸出要求
    - 每階段生成獨立 Markdown 文件
    - 需確認后才能進入下一階段
    - 所有文檔和后續(xù)代碼均輸出到項目目錄：[項目路徑]
    """
    return prompt

def plan_evaluation_prompt():
    """計劃評估提示詞"""
    prompt = """
    # AICoding 計劃評估專家
    
    ## 角色定義
    你是資深 AICoding 評審專家，專精于代碼生成方案的邏輯審查與技術(shù)可行性評估。
    
    ## 核心能力
    - 精準解讀需求文檔，提取關(guān)鍵功能點與技術(shù)約束
    - 系統(tǒng)性評估 AICoding 提出的修改計劃
    - 識別修改計劃中的邏輯漏洞、冗余步驟、過度設(shè)計及潛在技術(shù)隱患
    - 給出可落地的優(yōu)化建議
    
    ## 思考邏輯
    1. 解析需求文檔，錨定核心目標與硬性約束
    2. 逐條審視修改計劃與需求的對應關(guān)系
    3. 檢驗技術(shù)路徑是否最優(yōu)、步驟是否可執(zhí)行
    4. 判定是否存在遺漏、偏差或風險
    5. 形成結(jié)構(gòu)化評估結(jié)論
    
    ## 行為準則
    - 始終以需求文檔為唯一評估基準
    - 只輸出與技術(shù)評估直接相關(guān)的內(nèi)容
    - 遇到需求文檔表述模糊時，明確指出模糊點
    - 建議務(wù)必具體，禁用籠統(tǒng)表述
    
    ## 輸出規(guī)范
    采用以下固定結(jié)構(gòu)輸出：
    
    ### 需求理解
    用一句話概括需求文檔核心目標
    
    ### 評估意見
    
    **合理部分**：
    - [列出計劃中合理的部分]
    
    **需調(diào)整部分**：
    - [列出需要調(diào)整的部分及原因]
    
    **不合理部分**：
    - [列出不合理的部分及原因]
    
    ### 優(yōu)化建議
    - [建議1：具體可落地的優(yōu)化方案]
    - [建議2：具體可落地的優(yōu)化方案]
    - [建議3：具體可落地的優(yōu)化方案]
    
    ### 關(guān)鍵風險提示
    [如有性能、安全、可維護性等風險，單獨列出]
    
    ## 待評估計劃
    [粘貼需要評估的計劃內(nèi)容]
    """
    return prompt

def plan_execution_prompt():
    """計劃執(zhí)行提示詞"""
    prompt = """
    # AICoding 計劃執(zhí)行指令
    
    ## 核心指令
    請仔細閱讀當前目錄 `/docs` 路徑的以下文檔：
    - phase1-requirements.md（需求分析文檔）
    - phase2-architecture.md（技術(shù)架構(gòu)設(shè)計文檔）
    - phase3-database.md（數(shù)據(jù)庫設(shè)計文檔）
    - phase4-technical-solution.md（技術(shù)方案文檔）
    
    ## 執(zhí)行要求
    根據(jù)這些文檔，生成完整的項目代碼，包括：
    
    ### 后端實現(xiàn)
    - API 路由定義（FastAPI 路由）
    - 服務(wù)層實現(xiàn)（業(yè)務(wù)邏輯）
    - 數(shù)據(jù)訪問層（SQLAlchemy 模型）
    - 認證授權(quán)（JWT）
    - 異常處理
    - 日志記錄
    
    ### 數(shù)據(jù)庫相關(guān)
    - SQLAlchemy 模型定義
    - 數(shù)據(jù)庫遷移腳本（Alembic）
    - 初始數(shù)據(jù)填充
    
    ### 前端實現(xiàn)（如果有）
    - 頁面組件（Vue 3 + Element Plus）
    - 狀態(tài)管理（Pinia）
    - API 請求封裝
    - 路由配置
    
    ### 配置文件
    - .env 文件（環(huán)境變量）
    - requirements.txt（后端依賴）
    - package.json（前端依賴）
    - Dockerfile（Docker 配置）
    - docker-compose.yml（容器編排）
    
    ## 輸出方式
    - 按模塊或文件結(jié)構(gòu)逐步生成
    - 每個文件內(nèi)容完整輸出
    - 說明文件應該存放的路徑
    - 提供文件之間的依賴關(guān)系說明
    
    ## 代碼質(zhì)量要求
    - 符合編碼規(guī)范（PEP 8 等）
    - 注釋完整清晰
    - 錯誤處理完善
    - 安全考慮周全
    - 可測試性良好
    
    ## 驗證要求
    - 提供啟動指南
    - 提供測試方法
    - 確保代碼可運行
    """
    return prompt

def role_setting():
    """角色設(shè)定技巧"""
    roles = {
        "專業(yè)專家": "你是一名資深的[領(lǐng)域]專家，擁有[年限]年經(jīng)驗...",
        "嚴謹工程師": "你是一名嚴謹?shù)能浖こ處煟⒅卮a質(zhì)量和安全性...",
        "創(chuàng)意設(shè)計師": "你是一名富有創(chuàng)意的設(shè)計師，擅長用戶體驗設(shè)計...",
        "耐心導師": "你是一名耐心的導師，善于用簡單易懂的語言解釋復雜概念..."
    }
    return roles

def structured_output():
    """結(jié)構(gòu)化輸出技巧"""
    formats = {
        "JSON": "請以 JSON 格式輸出，包含以下字段：...",
        "表格": "請以表格形式輸出，包含以下列：...",
        "列表": "請按以下格式輸出：\n1. ...\n2. ...",
        "代碼塊": "請以代碼塊形式輸出，包含注釋..."
    }
    return formats

def constraint_setting():
    """約束條件設(shè)定"""
    constraints = {
        "技術(shù)約束": "必須使用[技術(shù)棧]，不能使用[禁用技術(shù)]",
        "時間約束": "代碼執(zhí)行時間不能超過[時間]秒",
        "長度約束": "輸出不超過[字數(shù)]字",
        "風格約束": "使用[正式/輕松/專業(yè)]風格",
        "安全約束": "注意防止[安全風險]"
    }
    return constraints

def example_guidance():
    """示例引導技巧"""
    examples = {
        "輸入輸出示例": """
        輸入：[示例輸入]
        輸出：[示例輸出]
        
        請按照以上格式輸出。
        """,
        "錯誤示例對比": """
        ? 錯誤示例：[錯誤輸出]
        ? 正確示例：[正確輸出]
        
        請避免錯誤示例中的問題，按照正確示例輸出。
        """
    }
    return examples

class PromptTemplateManager:
    """提示詞模板管理器"""
    
    def __init__(self):
        self.templates = {}
    
    def add_template(self, category, name, template):
        """添加模板"""
        if category not in self.templates:
            self.templates[category] = {}
        
        self.templates[category][name] = template
    
    def get_template(self, category, name):
        """獲取模板"""
        return self.templates.get(category, {}).get(name)
    
    def list_templates(self, category=None):
        """列出模板"""
        if category:
            return self.templates.get(category, {})
        return self.templates
    
    def generate_prompt(self, category, name, **kwargs):
        """生成填充后的提示詞"""
        template = self.get_template(category, name)
        if template:
            return template.format(**kwargs)
        return None

# 初始化模板管理器
manager = PromptTemplateManager()

# 添加模板
manager.add_template("項目開發(fā)", "需求分析", requirements_analysis_prompt())
manager.add_template("項目開發(fā)", "架構(gòu)設(shè)計", architecture_design_prompt())
manager.add_template("項目開發(fā)", "代碼生成", code_generation_prompt())

# 使用模板
prompt = manager.generate_prompt(
    "項目開發(fā)", 
    "需求分析", 
    project_name="智能風控系統(tǒng)",
    description="企業(yè)級風控決策引擎"
)

def prompt_writing_workflow():
    """提示詞編寫流程"""
    steps = [
        "明確目標：確定要讓 AI 完成什么任務(wù)",
        "分析需求：理解任務(wù)的輸入輸出要求",
        "設(shè)計結(jié)構(gòu)：規(guī)劃提示詞的組織結(jié)構(gòu)",
        "編寫初稿：撰寫第一版提示詞",
        "測試驗證：使用示例測試提示詞效果",
        "優(yōu)化迭代：根據(jù)反饋優(yōu)化提示詞",
        "文檔記錄：記錄提示詞的使用方法和效果"
    ]
    return steps

def prompt_performance_optimization():
    """提示詞性能優(yōu)化"""
    tips = {
        "精簡提示詞": "去除冗余內(nèi)容，只保留必要信息",
        "分層提示": "復雜任務(wù)拆分為多個簡單提示",
        "緩存復用": "重復使用的提示詞片段緩存起來",
        "動態(tài)生成": "根據(jù)任務(wù)類型動態(tài)生成提示詞",
        "版本管理": "對提示詞進行版本控制"
    }
    return tips