Boring 專業開發實戰指南 (Professional Playbook)

目標：從「寫出會跑的程式碼」晉升為「交付生產等級、高彈性、零債務的系統架構」。

核心哲學：捷徑開發 (Prompt-First Workflow)

你要記住的不是 Tool 名稱，而是 工作場景 (Prompts)。在工作時，你只需輸入 / 或 Prompt 名稱，AI 就會自動組合工具執行。

第一階段：需求審度與架構共識

不要直接寫 Code。專業的第一步是確保 AI 真正理解複雜的業務邏輯。

啟動架構師計畫：使用 /vibe_start。
底層驅動：(完整 Spec-Driven 流程) speckit_constitution (原則) -> speckit_clarify (釐清) -> speckit_plan (計畫) -> speckit_checklist (驗收標準) -> speckit_analyze (一致性分析) -> evaluate_architecture。
強制解析架構：使用 /evaluate_architecture。
這能強制 AI 指出你需求中的設計缺陷（例如：缺少 Retry 機制、潛在的 O(N) 操作）。

💡 `/vibe_start` vs `/full_stack_dev`

/vibe_start (Architect Mode): 適合從 0 到 1 的新專案，重視需求釐清、規格制定與架構正確性。會經過完整的 Plan/Spec 流程。
/full_stack_dev (Hacker Mode): 適合需求明確、技術導向的開發。直接進入技術實作 (如 "用 Next.js 寫個登入頁")，速度快但架構檢查較少。

第二階段：建立原子操作防護網 (Safety Net)

在修改核心模組前，先建立一個「逃生艙」。

安全重構：使用 /safe_refactor。
底層驅動：boring_transaction_start -> (修改) -> boring_verify。
如果測試不通過，你可以接著用 /rollback 一鍵復原。
審查影子操作：使用 /shadow_review。
檢查所有被 Shadow Mode 攔截的危險操作。

第三階段：快速診斷與修復

利用自動化循環解決瑣碎問題。

自動修復：使用 /quick_fix。
底層驅動：boring_verify -> boring_auto_fix -> ruff format。
背景驗證：如果是大型專案，使用 /background_verify。
讓 AI 在背景跑測試，你繼續寫下一個功能。

第四階段：品質評估與 A/B 對比

交付前的最終洗禮。

執行安全掃描：使用 /security_scan。
自動檢測 Secrets 是否外洩，依賴包是否有 CVE 漏洞。
代碼評分：使用 /evaluate_code。
實作對比：使用 /compare_implementations。
將你的兩個方案路徑交給「AI 裁判」，讓它選出維護性最佳的版本。

專業 Prompt 捷徑表

想要做什麼	使用這個 Prompt	對應的 Tool 組合
新功能開發	`/vibe_start`	Speckit + Agent Plan
高風險改動	`/safe_refactor`	Transactions + Verify
修 Lint/格式	`/quick_fix`	Auto-fix + Ruff
程式碼查錯	`/debug_error`	Diagnose + Verify
安全檢查	`/security_scan`	Security (SAST/Secrets)
搜尋代碼	`/semantic_search`	RAG Search
全面品質稽核	`/audit_quality`	Health + Security + Verify
查看未來路徑	`/roadmap`	Task + Mermaid Gantt
系統狀態監控	`/system_status`	Status + Progress
架構視覺化	`/visualize`	Mermaid Diagrams
查看 AI 記憶	`/project_brain`	Brain Summary
智能提交	`/smart_commit`	boring_verify + boring_commit
專案健檢	`/vibe_check`	Vibe Score & Health
效能優化分析	`/optimize_performance`	Arch Evaluation
學習專案模式	`/learn_patterns`	boring_learn
建立評估標準	`/create_rubrics`	boring_create_rubrics
建立 RAG 索引	`/index_codebase`	boring_rag_index
清除短期記憶	`/reset_memory`	boring_forget_all
設定 IDE	`/setup_ide`	boring_setup_extensions
標記任務完成	`/mark_done`	boring_done

🔥 Vibe Coding 專屬工作流 (The Karpathy Style)

Vibe Coding 的精髓在於「Flow」。不要被細節卡住，用高層次指令控制 AI。

1. 視覺化導向 (`/visualize`)

不要讀代碼，看代碼。 - boring run "/visualize" -> 瞬間生成架構圖。 - 發現架構太亂？ -> boring run "/refactor"。

2. 智能提交 (`/smart_commit`)

寫完功能懶得寫 Commit Message？ - boring run "/smart_commit" - AI 會先執行 boring_verify 驗證品質 - 若無指定訊息，自動呼叫 boring_commit 從 task.md 提取已完成任務，生成 Conventional Commits 格式（如 feat(auth): add jwt support） - Flow 不中斷。

💡 架構說明：boring_commit 是底層 Tool，smart_commit 是組合流程 (Verify → Commit → Push)。

3. Vibe Check (`/vibe_check`)

覺得專案哪裡怪怪的？ - 讓 AI 給你的專案打分數。 - 它會檢查文件完整度、代碼髒亂度、是否符合它學到的 Pattern。 - 保持 Vibe Score > 90 分。

4. 自動導航 (`/roadmap`)

迷路了嗎？ - /roadmap 會讀取 task.md 並生成甘特圖。 - 告訴你「我們在哪裡」以及「下一步去哪裡」。

進階技巧：AI 知識庫管理 (Brain Management)

Boring 的核心大腦位於 .boring/brain/，這是你可以「打包帶走」的智慧。

1. 教會 AI 你的 Code Style (`/learn_patterns`)

當 AI 寫出的代碼不符合你的習慣時，不要只在這次對話中糾正它。 1. 手動修改代碼成你喜歡的樣子。 2. 執行 /learn_patterns。 3. AI 會分析你的修改，學會「喔！原來這個專案要這樣寫」。 4. 永久生效：以後它都會這樣寫。

2. 移植大腦到新專案 (Brain Portability)

想在新專案沿用舊專案的習慣？ 1. 複製 .boring/brain/patterns.json (代碼風格)。 2. 複製 .boring/brain/rubrics/ (評分標準)。 3. 貼到新專案的同名資料夾。 4. 完成：新專案的 AI 瞬間擁有 5 年資深工程師的經驗。

3. 跨專案知識共享 (Cross-Project Knowledge V10+)

Boring 支援全域知識庫。 - 你的修正與偏好會自動同步到 ~/.boring/brain/global_patterns.json。 - 開啟任何新專案時，Boring 都已經知道你的喜好。

專家案例：重構一個 API

1. 你: "/safe_refactor 導入 Redis 鎖機制"
2. Boring: (自動開啟 Transaction) -> (開始修改) -> (自動跑測試)
3. Boring: "❌ 測試失敗。已自動偵測錯誤，是否執行 `/quick_fix`？"
4. 你: "執行 /quick_fix"
5. Boring: (自動修復語法錯誤) -> (驗證通過)
6. 你: "/smart_commit"

“專業玩家不記 Tool，因為 Prompt 已經幫你準備好了所有戰術組合。”

Last updated: V14.0.0