快速入門教學
透過實作學習 Boring。5 分鐘常見工作流程教學。
📚 教學索引
| 教學 | 時間 | 技能水平 |
|---|---|---|
| 1. 你的第一個 Vibe 專案 | 5 分鐘 | 初學者 |
| 2. 一鍵修復所有錯誤 | 3 分鐘 | 初學者 |
| 3. 新增功能 | 10 分鐘 | 中級 |
| 4. AI 代碼審查 | 5 分鐘 | 中級 |
| 5. 設定品質閘道 | 10 分鐘 | 進階 |
| 6. 多代理開發 | 15 分鐘 | 進階 |
你的第一個 Vibe 專案
目標：從簡單描述建立可運行的應用。
步驟 1：開始對話
步驟 2：回答澄清問題
步驟 3：審查生成的計畫
Boring：這是我的計畫：
1. 建立專案結構
2. 設定 FastAPI 應用
3. 定義 User 和 Post 模型
4. 建立 CRUD 端點
5. 新增 SQLite 資料庫
要繼續嗎？
你：是的，請開始！
步驟 4：取得可運行的應用
完成！ 你現在有一個可運行的 FastAPI 應用。
一鍵修復所有錯誤
目標：一個命令清除所有 linting 和格式錯誤。
步驟 1：執行快速修復
步驟 2：見證魔法
完成！ 所有代碼品質問題都已修復。
新增功能
目標：為現有專案新增認證功能。
步驟 1：描述功能
步驟 2：AI 建立計畫
Boring：我將透過以下步驟新增認證：
1. 安裝依賴（pyjwt, passlib）
2. 建立 auth/models.py - User 模型
3. 建立 auth/utils.py - 密碼雜湊
4. 建立 auth/routes.py - 登入/註冊
5. 更新 main.py - 新增 auth 路由
要繼續嗎？
步驟 3：審查差異
Boring：這是我將變更的內容：
+ auth/models.py（新增）
+ auth/utils.py（新增）
+ auth/routes.py（新增）
~ main.py（修改）
~ requirements.txt（修改）
批准嗎？
你：是的，套用變更
完成！ 你的應用現在有認證功能了。
AI 代碼審查
目標：取得專家級代碼審查回饋。
步驟 1：請求審查
boring_evaluate(
target="src/main.py",
level="DIRECT",
criteria=["correctness", "security", "performance"]
)
步驟 2：審查回饋
Boring：src/main.py 代碼審查
總體評分：7.5/10
✅ 優點：
- 乾淨的函數簽名
- 良好的錯誤處理
⚠️ 問題：
1. 第 45 行有 SQL 注入風險
2. get_posts() 中有 N+1 查詢模式
3. 缺少輸入驗證
📝 建議：
- 使用參數化查詢
- 為 posts 新增 eager loading
- 新增 Pydantic 驗證
完成！ 你有可執行的回饋了。
設定品質閘道
目標：為 CI 管道新增自動化品質檢查。
步驟 1：本地安裝 hooks
步驟 2：建立 GitHub Actions 工作流程
# .github/workflows/quality-gates.yml
name: Quality Gates
on: [push, pull_request]
jobs:
verify:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
- run: pip install "boring-aicoding[all]"
- run: boring verify --level FULL
步驟 3：本地測試
完成！ 你的 repo 現在有品質閘道了。
多代理開發
目標：使用專門代理處理複雜任務。
步驟 1：啟動工作流程
步驟 2：代理協作
🧠 規劃代理：
建立實作計畫...
- WebSocket 伺服器設定
- 事件系統設計
- 客戶端整合
📝 編碼代理：
實作變更...
- src/websocket.py（新增）
- src/events.py（新增）
- src/main.py（修改）
🔍 審查代理：
審查變更...
- ✅ 無安全問題
- ⚠️ 考慮速率限制
- ✅ 測試通過
步驟 3：審查最終輸出
Boring：多代理工作流程完成！
建立的檔案：
- src/websocket.py
- src/events.py
修改的檔案：
- src/main.py
- requirements.txt
所有測試通過。準備部署。
完成！ 複雜功能透過 AI 協作實作完成。
教學 5：架構演進 (Deep Thinking)
目標：使用高階推理重構混亂的代碼。
1. 開始 Vibe Session：boring start
2. 請求深度分析：執行「使用深度思考模式分析整體架構並給出改進建議」
3. 審查多代理計畫：Boring 會根據分析提供精煉後的實作計畫。
教學 6：安全審計 (Critical Thinking)
目標：找出微妙的邏輯漏洞或安全風險。
1. 執行審計：boring run 「對驗證邏輯進行批判性思維審計」
2. 後續：使用 boring verify --level FULL 確認修復後的狀態。