Menu
設計文件 → 技術規格生成器 — 將任何設計文件轉換為 AI 可執行的技術實作規格
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
非技術領域專業知識集合，包含商業、金融、創意、專業服務、生活、方法論等 18 個領域
數位行銷策略、內容行銷與成效分析
產品管理：PRD撰寫、用戶故事、OKR設定、路線圖規劃
專案管理：敏捷開發、Scrum、甘特圖、風險管理、團隊協作
銷售技巧：B2B/B2C 銷售、客戶開發、電商營運、成交策略
商業策略：藍海策略、差異化、競爭優勢、價值創新、商業模式設計
| name | tech-spec-gen |
| version | 2.0.0 |
| description | 設計文件 → 技術規格生成器 — 將任何設計文件轉換為 AI 可執行的技術實作規格 |
| triggers | ["tech-spec","技術規格","spec-gen","implementation-spec","設計轉規格","design-to-spec"] |
| keywords | ["technical-specification","design-document","implementation","tasks","worktree","prd","gdd","frd"] |
| author | claude-domain-skills |
將 GDD/PRD/FRD 等設計文件轉換為 AI 可執行的技術規格
/tech-spec-gen [設計文件路徑] # 完整轉換
/tech-spec-gen [路徑] --type gdd # 指定文件類型
/tech-spec-gen module [模組名稱] # 單一模組轉換
/tech-spec-gen tasks # 顯示待實作任務
/tech-spec-gen worktree [task-id] # 為任務建立 worktree
| 設計文件特徵 | AI 需要的規格 |
|---|---|
| 敘事性描述 | 明確的輸入/輸出定義 |
| 概念性說明 | 可驗證的完成標準 (Given-When-Then) |
| 整體願景 | 獨立可執行的任務切分 |
| 靈活的解讀空間 | 技術決策的明確指引 |
| 類型 | 代碼 | 適用場景 |
|---|---|---|
| 遊戲設計文件 | gdd | 遊戲開發 |
| 產品需求文件 | prd | 產品開發 |
| 功能需求文件 | frd | 功能實作 |
| 系統設計文件 | sdd | 系統開發 |
| 通用設計文件 | generic | 自動解析 |
| 設計文件內容 | 技術規格對應 |
|---|---|
| 願景/目標 | 驗收標準 (Acceptance Criteria) |
| 功能描述 | 系統架構 + API 設計 |
| 業務規則/遊戲機制 | 資料模型 + 業務邏輯 |
| 數值/配置 | 常數定義 + 配置結構 |
| UI/UX 流程 | 狀態機 + 畫面規格 |
| 實體/角色/用戶 | Entity Schema + 行為定義 |
| 限制/約束 | 架構決策記錄 (ADR) |
Step 1: 文件解析 → 讀取文件、偵測類型、提取結構
↓ [確認點：文件類型]
Step 2: 技術分析 → 分析技術棧、識別模組、標記決策點
↓ [確認點：技術棧選擇]
Step 3: 架構設計 → 設計架構、定義模組邊界、設計資料模型
↓ [確認點：架構設計]
Step 4: 任務分解 → 依模組分解、建立依賴圖、估算複雜度
↓ [確認點：任務分解預覽]
Step 5: 規格產出 → 產生 tech-spec.md + tasks/*.md + ADR
| 類型 | 代碼 | 說明 |
|---|---|---|
| 基礎建設 | INFRA | 專案設定、環境配置 |
| 資料模型 | MODEL | 實體定義、Schema |
| 核心邏輯 | CORE | 業務邏輯、演算法 |
| API 層 | API | 介面定義、端點 |
| UI 元件 | UI | 畫面、互動 |
| 整合 | INTG | 模組整合、流程 |
| 測試 | TEST | 單元/整合測試 |
| 複雜度 | 特徵 |
|---|---|
| S | 單一檔案、邏輯簡單 |
| M | 多檔案、需要設計 |
| L | 多模組互動、需測試 |
| XL | 核心架構、複雜邏輯 |
Phase 1: Foundation → 專案初始化、核心資料模型、基礎配置
Phase 2: Core → 核心業務邏輯、主要 API、資料存取層
Phase 3: Features → 功能模組實作
Phase 4: Integration → 模組整合、流程串接、整合測試
Phase 5: Polish → UI 優化、效能調校、文件完善
# 1. 查看可用任務
/tech-spec-gen tasks
# 2. 為任務建立 worktree
/tech-spec-gen worktree T002
# → git worktree add ../[project]-T002 -b feature/T002-xxx
# 3. 在 worktree 中完成實作
# 4. 合併並清理
git checkout main && git merge feature/T002-xxx
git worktree remove ../[project]-T002
../[project]-[task-id]/
├── TASK-SPEC.md # 任務詳細規格
├── ACCEPTANCE.md # 驗收標準清單
└── .claude/context.md # AI Agent 上下文
docs/tech-spec/
├── tech-spec.md # 主規格文件
├── tasks/ # 任務規格
│ ├── README.md # 任務索引與依賴圖
│ ├── T001-xxx.md
│ └── ...
└── adr/ # 架構決策記錄
└── ADR-001-xxx.md
架構
資料模型
API 設計
任務分解
設計文件對應
| 問題 | 解決方案 |
|---|---|
| 任務粒度太大 | 分解為子任務（< 15 驗收標準） |
| 隱含假設 | 明確列出所有假設 |
| 循環依賴 | 重新設計模組邊界 |
| 驗收標準模糊 | 改為 Given-When-Then 格式 |
| 技術棧不明 | 加入技術決策流程 |
| GDD 章節 | 技術規格對應 |
|---|---|
| 設計支柱 | ADR (架構約束) |
| 核心玩法 | 系統架構 + 狀態機 |
| 遊戲機制 | API 設計 + 業務邏輯 |
| 數值設計 | 常數定義 |
| 角色設計 | Entity Schema |
| PRD 章節 | 技術規格對應 |
|---|---|
| 問題定義 | 驗收標準 |
| 用戶故事 | 功能模組 + API |
| 功能列表 | 任務分解 |
| 成功指標 | 效能驗收標準 |
| FRD 章節 | 技術規格對應 |
|---|---|
| 功能描述 | API 設計 |
| 業務規則 | 業務邏輯 + 驗證規則 |
| 數據要求 | 資料模型 |
| 例外處理 | 錯誤處理策略 |
extended/templates.mdextended/examples.md/game-planner 產生 GDD/galgame-master 創作內容| 版本 | 日期 | 變更 |
|---|---|---|
| 2.0.0 | 2026-01-15 | 通用化：支援 GDD/PRD/FRD/SDD/Generic |
| 1.0.0 | 2026-01-15 | 初版：GDD 專用轉換器 |