Common Dev Prompt

Claude Code 開發工作流的通用 Prompt 集，幫助團隊快速建立 AI 協作規範。

這是什麼？

一系列可複用的 Prompt，用來教 Claude Code「怎麼幫你做事」。 直接複製 Prompt 到任何專案中貼上執行，AI 會自動掃描專案結構並產生：

• 指引文件（CLAUDE.md）— 讓 AI 理解你的專案架構與開發慣例
• Agent Skill（.claude/skills/）— 讓 AI 學會專案特有的協作技能
• Spec-before-Code 工作流 — 強制 AI 先寫規格、確認後才寫程式碼

文件說明

文件	用途	使用方式
1.依據過去的程式脈絡產生指引文件及AgentSkill.md	掃描現有程式碼，自動產生 CLAUDE.md 與 Agent Skill	整段貼到 Claude Code 執行
2.多專案Spec-before-Code工作流與AgentSkill導入指南.md	一鍵建立 Spec-before-Code 完整工作流（含目錄結構、範本、指令）	複製「一鍵導入」區塊，改一行描述即可

涵蓋的 Prompt

初始建立（挑一個執行即可）

Prompt	說明
一鍵導入 Spec-before-Code 工作流	自動掃描專案 → 產生 CLAUDE.md、rules、skills、commands、templates，只需改一行專案描述
產生 CLAUDE.md 指引文件	掃描專案結構與技術棧，產生 AI 指引文件
產生 Agent Skill	掃描程式碼脈絡，建立 AI 協作技能文件

日常開發

Prompt	說明
跨子專案功能開發	自動判斷影響範圍 → 建 Spec → 確認後開發
Bug 修復	分析根因 → 建 Spec → 確認後修復 → 記錄 Bug Log
分析程式碼建立慣例	分析命名、結構、pattern，在 rules/ 建立慣例規則

文件同步

Prompt	說明
新增 command 後更新文件	同步更新 README.md、CLAUDE.md、skills
sync-docs（/sync-docs）	掃描專案，補齊 README 與 CLAUDE.md 中缺少的內容
sync-skill（/sync-skill）	掃描專案，補齊 skills/ 中缺少的技能描述

如何使用

1. 到目標專案根目錄開啟 Claude Code
2. 選擇適合的 Prompt，複製貼上
3. AI 自動掃描專案結構並產生所有檔案

不需要手動填入資料夾名稱或技術棧，AI 會自動偵測。

設計理念：原則導向，不綁死流程

這些 Prompt 的設計遵循一個核心理念：像好的管理者一樣指導 AI — 定方向、設護欄，但不規定每一步怎麼走。

AI 模型持續升級，每一版都有新的能力與認知。如果 Prompt 寫得太死（固定步驟、硬編數字、強制格式），反而會限制 AI 的發揮，讓它無法運用自身最新的判斷力。

原則

做法	說明
定義目標與約束，不定義步驟	告訴 AI「要達成什麼」和「不能踩的線」，具體怎麼做讓它依情境判斷
設底線，不設天花板	護欄防止出錯，但不限制 AI 用更好的方式完成任務
描述原則，不描述流程	流程會過時，原則不會；讓 AI 根據當下情境自己規劃最佳路徑
用彈性描述取代硬數字	「有一定複雜度的改動」比「超過 3 行的改動」更能適應不同場景

實務上的意思

• Skill 的步驟是參考，不是強制 SOP — AI 可以依情境調整順序或省略不必要的步驟
• 模板的欄位分必要與選用 — AI 依改動規模決定文件深度，小改動不需要填滿每個欄位
• 工作流強調的是意圖（先想清楚再動手）而不是形式（一定要產出某種格式的文件）

寫 Prompt 跟帶團隊一樣：微管理出不了好成果，給方向和信任才行。

適用對象

任何使用 Claude Code 的開發團隊，無論是單一專案或多專案結構皆適用。