sdd-speckit

name	sdd-speckit
description	Spec Kit SDD 操作指引精靈。當使用者意圖使用 Spec Kit、提及 SDD 開發並選擇 Spec Kit、 或要求以規格驅動開發方式定義功能規格時觸發。 以選單方式呈現所有步驟，引導使用者完成從初始化到實作的完整流程， 並將每步操作記錄保存為 log 檔案。
version	1.0.5
author	lazyjerry

Spec Kit 操作指引精靈

引導使用者完成 Spec Kit SDD 工作流程：從安裝、治理原則到功能規格、計畫、實作。

啟動流程

1. 環境檢查

執行以下終端指令確認 Spec Kit 是否已安裝：

specify version

檢測並更新套件（建議每次啟動先執行）：

uv tool upgrade specify-cli
specify version

⚠️ 尚未偵測到 Spec Kit CLI（specify）。請先安裝：

  1. 安裝 uv（如尚未安裝）：
     curl -LsSf https://astral.sh/uv/install.sh | sh

  2. 安裝 Spec Kit：
     uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

需要 Python 3.11 以上版本與 Git。
安裝完成後請重新啟動此精靈。

2. 詢問工作目錄

確認使用者的目標專案目錄：

請問要在哪個專案目錄執行 Spec Kit？
（輸入路徑，或按 Enter 使用目前工作區）

3. 顯示步驟選單

請讀取 references/menu.md 並原樣顯示，作為互動選單。

4. 執行步驟

依使用者選擇按需讀取對應小檔：

• Step 0: references/steps/step-0-init.md
• Step 1: references/steps/step-1-constitution.md
• Step 2: references/steps/step-2-specify.md
• Step 3: references/steps/step-3-clarify.md
• Step 4: references/steps/step-4-plan.md
• Step 5: references/steps/step-5-tasks.md
• Step 6: references/steps/step-6-analyze.md
• Step 7: references/steps/step-7-implement.md
• C: references/commands.md

取得選定步驟的完整指引後，依照該步驟：

1. 顯示步驟說明：該步驟的目的與注意事項
2. 提供提示詞模板：可直接使用的 slash command 或提示
3. 引導使用者輸入：收集必要資訊（如技術棧、功能描述等）
4. 協助執行：根據步驟類型，執行 CLI 指令或提供 AI 提示詞
5. 記錄到 log：將使用者輸入與執行結果寫入 log 檔案

5. 步驟完成後

• 更新 log 檔案
• 顯示下一步建議
• 回到步驟選單

Log 機制

Log 檔案位置與命名

<專案根目錄>/sdd-logs/speckit-<YYYY-MM-DD>-<功能名稱>.md

• 首次啟動時建立 sdd-logs/ 目錄（如不存在）
• 功能名稱在 Step 2 描述規格時確定；Step 0～1 使用 init 作為暫時名稱
• 同一功能的所有步驟記錄在同一檔案中

Log 檔案初始化模板

首次建立時，請使用 references/log-format.md 的「Log 檔案初始化模板」。

每步驟追加格式

每完成一個步驟，請使用 references/log-format.md 的「每步驟追加格式」。

關鍵規則

#	規則	說明
1	先讀再做	每次執行步驟前，先讀取對應的小檔（references/menu.md、references/log-format.md、references/steps/step-*.md、references/commands.md）
2	忠實記錄	使用者的每次輸入都必須記錄到 log
3	不跳步驟	選單讓使用者自由選擇，但提醒建議順序
4	what 優先	Step 2 專注描述「做什麼」與「為什麼」，不提技術細節
5	範圍控制	實作階段提醒使用者「請專注在 tasks.md 列出的項目」
6	選用步驟	Step 3（clarify）與 Step 6（analyze）為選用，但建議執行
7	錯誤處理	CLI 指令失敗時，建議執行 specify check 檢查環境