CodeExpander Pro × AI 編程：實戰案例庫

提供可直接使用的配置範本和真實場景案例

文件目錄 · AI 與效率

📚 目錄

• AI 提示詞範本庫
• 程式碼片段庫
• 截圖工作流
• 剪貼簿管理場景
• 自動化腳本
• 跨項目復用

🤖 AI 提示詞範本庫

1. 程式碼生成提示詞

通用程式碼生成器

縮寫: ai-gen
分組: AI-Prompts/Code
環境: plain

---內容---
請用 %fillmenu&name=編程語言&options=Python,JavaScript,TypeScript,Rust,Go,Java% 實現以下功能：

**功能描述**:
%fillarea&name=詳細描述功能需求%

**技術要求**:
- %fillcheck&name=添加詳細注釋%
- %fillcheck&name=包含錯誤處理%
- %fillcheck&name=符合最佳實踐%
- %fillcheck&name=添加類型標註/類型提示%
- %fillcheck&name=包含使用示例%

**程式碼風格**: %fillmenu&name=風格&options=簡潔實用,詳盡注釋,企業級規範%
**額外要求**: %fillarea&name=其他特殊需求（可選）%

請提供完整的程式碼實現。

使用：在 ChatGPT/Claude 輸入 ai-gen + Tab，彈出表單填寫後一鍵生成完整提示詞。

測試用例生成器

縮寫: ai-test
---內容---
請爲以下程式碼生成完整的測試用例：

**程式碼內容**:
```%fillmenu&name=語言&options=Python,JavaScript,TypeScript,Java%
%cv%

測試框架: %fillmenu&name=框架&options=Jest,Pytest,JUnit,Vitest,Mocha%

技巧：`%cv%` 自動插入剪貼簿內容；先複製程式碼再觸發 `ai-test`。

---

### 2. 程式碼審查提示詞

安全審查、性能審查等可類似用 `%cv%` 帶入程式碼，配合 %fillcheck% 勾選審查維度。詳見 [FillIn 變數](/zh-TW/docs/reference/fillin)。

---

### 3. 文件生成提示詞

README 生成器、API 文件生成器：用 %filltext%、%fillarea%、%fillmenu% 填寫項目名、類型、語言、描述等，生成完整 prompt。

---

## 💻 程式碼片段庫

### 錯誤處理範本

**Python**（縮寫 try-py，環境 python）：
```python
try:
    %c%
except Exception as e:
    logger.error(f"Error: {e}")
    raise

JavaScript（縮寫 try-js）：try/catch + %c% 光標位。

日志、測試框架、API 路由

• 結構化日志：%filltext% 消息、%fillmenu% 級別，加 %c% 擴充字段。
• Jest/Pytest 範本：describe + test，%filltext% 測試組名/目標。
• Express/FastAPI 路由：%fillmenu% 方法、%filltext% 路徑與參數。

📸 截圖工作流

Bug 反饋截圖

1. 觸發截圖快速鍵 → 框選錯誤區域。
2. 紅色矩形框、箭頭、文字標註。
3. 複製 → 粘貼到 GitHub Issue/Jira。

技術文件配圖

截取程式碼或界面 → 漸變背景 + 圓角 + 陰影 → 編號圓圈 + 高亮 → 複製或保存。

程式碼對比

捲動截圖 Before/After，Pin 固定 Before，對 After 做綠色/黃色高亮標註。

📋 剪貼簿管理場景

• AI 對話歷史：複製 AI 回復自動進歷史，切換工具時打開剪貼簿視窗搜尋後粘貼；重要回復可收藏。
• 程式碼片段收集：複製程式碼 → 剪貼簿視窗 → 右鍵「創建片段」→ 填縮寫與分組，即可復用並同步。
• 多步驟操作：批次複製配置值，在剪貼簿視窗按順序點擊粘貼（環境變數、表單、程式碼遷移）。

🔧 自動化腳本

Git 工作流（Shell / JavaScript）

• 快速提交：git add . + commit -m “%filltext&name=提交消息%” + push。
• 創建功能分支：%filltext% 分支類型與功能名。
• 檢查狀態：JS 片段裡 execSync(‘git status —short’) 並 return 結果。

Docker、項目腳手架、資料處理

• docker-clean：container/image/volume prune。
• init-node / init-python：mkdir + 包管理 + .gitignore。
• json-format：剪貼簿 %cv% 或 {{clipboard}} 解析後 JSON.stringify(parsed, null, 2)。

🔄 跨項目復用

分組結構示例：項目A（前綴 pa-）、項目B（前綴 pb-）、Common（無前綴）。
ExpandIn：按項目目錄或應用限定生效範圍。
微服務場景：每個服務一組縮寫（如 us-dev、os-dev），共享腳本（k8s-status、k8s-logs）放 Common。

🎭 Prompt 變體管理

同一場景的 Prompt 通常需要多個版本（簡潔版/詳細版/嚴格版），用 %fillmenu% 在展開時彈出選擇，零切換成本。

程式碼審查變體選擇器

縮寫: ai-review
分組: AI-Prompts/Review
環境: plain

---內容---
%fillmenu&name=審查模式&opt=quick&opt=deep&opt=security%

<!-- 根據選擇展開不同 Prompt -->
{{if quick}}請快速審查以下程式碼，只指出最嚴重的問題：
{{elif deep}}請深度審查以下程式碼，包括架構、性能、可維護性與安全性：
{{elif security}}請以安全審計視角審查以下程式碼，重點關注 OWASP Top 10：{{end}}

```%cv&md=%```

觸發 ai-review → 彈窗選擇「quick / deep / security」→ 展開對應版本並自動包裹剪貼簿程式碼。

簡化版：單行菜單直接嵌入

只需要幾個關鍵詞差異時，直接在範本裡內嵌菜單：

請%fillmenu&name=動作&opt=重構&opt=優化性能&opt=添加單元測試&opt=轉換爲 TypeScript%以下程式碼：

%cv&md=%

縮寫：ai-action，展開後立即得到「請重構以下程式碼：…」或「請優化性能…」。

📋 多剪貼簿上下文組合器

場景：手邊有報錯信息、相關程式碼、配置檔案三段內容，需要組合成一條 AI 偵錯 Prompt。

操作步驟（需 CodeExpander ≥ 當前版本）：

1. 複製報錯信息 → 剪貼簿視窗自動記錄
2. 複製相關程式碼 → 同上
3. 打開剪貼簿視窗，點擊右下角 批次模式 按鈕（或快速鍵）
4. 勾選需要的歷史條目（支持 Shift 範圍選、Ctrl 多選）
5. 點擊底部工具欄的 🤖 組合爲 AI Prompt 按鈕，選擇範本：
   • 偵錯 / 錯誤分析：第一條自動包裹爲 Error 塊，其餘包裹爲 Code 塊，末尾添加偵錯請求
   • 程式碼審查：所有條目合並爲程式碼塊，附上審查請求
   • 簡單合並：以 --- 分隔拼接
6. 自動寫入剪貼簿 → 粘貼到 AI 工具即可

偵錯範本示例輸出（選中 2 條）：

## Error / Issue

TypeError: Cannot read properties of undefined (reading ‘map’) at processItems (app.ts:42)

## Related Code

const data = await fetchData() const items = data.results.map(…) // ← 此處崩潰

Please help me debug the issue above.

📊 效率提升對比

更多語法見 FillIn 變數、設定說明。
最後更新: 2026-01-29