Communitygithub.com

chandrapratamalab/phantom-skill

透過互動式兩步驟工作流程,生成包含視覺化 Mermaid 圖表的完整產品與技術需求文件 (PRD-Project)。當用戶要求建立 PRD、規劃任何軟體/網頁/行動/AI/遊戲專案、撰寫規格或設計系統架構時使用。

phantom-skill 是什麼?

此技能旨在將任何專案想法轉換成一份開發者可直接使用的產品與技術需求文件 (PRD.md)。它採用兩步驟的互動式工作流程:首先,AI 會分析用戶提示,辨識專案類型(如 3D 動態網站、SaaS、行動應用、AI Agent、遊戲等),並提出 4 到 5 個高度相關的領域特定問題來釐清需求,同時提供快速選項以供用戶簡答。其次,根據用戶回應(或跳過問題的指令),自動生成一份結構化的 PRD 文件,包含七個必要章節:概述、需求、核心功能、用戶流程、架構、資料庫結構(根據專案類型自適應)和技術棧。該技能特別要求使用有效的 Mermaid 語法繪製流程圖與架構圖,確保規格具體可行,可直接用於開發者或 AI 編碼 Agent 的實作。支援 Claude Code、Cursor、Codex 等平台,適合所有需要正式文件化的專案啟動階段。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chandrapratamalab/phantom-skill/tree/HEAD/skills/prd-writer

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

通用 PRD 撰寫器

將任何專案想法轉換成一份完整的、開發者可立即使用的產品與技術需求文件 (PRD.md)。

工作流程

步驟 1:分析提示並提出動態釐清問題

請勿在第一次互動時就產生完整的 PRD,除非用戶明確表示「直接產生」/「跳過問題」或已提供完整細節。

  1. 辨識專案性質: 從用戶的提示中判斷他們正在建構什麼(例如,3D/動態網站、SaaS/網頁應用、行動應用、AI Agent/機器人、遊戲、CLI/外掛、或企業級系統)。
  2. 提出 4 到 5 個高度相關的問題: 嚴格針對該特定專案領域擬定問題:
    • 詢問核心目標/目標用戶以及預期的最終行為。
    • 詢問領域特定的機制(例如,動態頁面的 3D/卷軸互動;SaaS 的用戶角色與付款流程;機器人的觸發/API 流程;遊戲的遊戲迴圈)。
    • 詢問 MVP 範圍邊界和技術/函式庫偏好或裝置限制。
  3. 提供快速範例: 在每個問題後方附上簡短選項 (用括號),方便用戶快速回覆,並提醒他們:「請回覆您腦海中原則性的要點,或輸入 '直接產生' 讓我自動為您選擇最佳選項。」

步驟 2:產生七個章節的 PRD-Project

一旦用戶回答(或要求立即進行),將輸出儲存到 PRD.md(如果在程式碼工作區中),並按照以下精確的七章節結構呈現文件,根據專案類型動態調整技術內容:

# PRD-Project: [專案名稱]
## 需求文件

### 1. 概述
- **產品摘要:** 概念、解決的核心問題以及獨特價值主張。
- **目標受眾與人物誌:** 用戶角色、目標與痛點。
- **目標與成功指標:** 適合專案的衡量 KPI(例如,轉換率、FPS/載入速度、留存率或任務準確度)。

### 2. 需求
- **功能需求:** 按角色、模組或畫面區塊邏輯分組的核心能力。
- **非功能需求:** 效能基準、回應性、安全性、相容性與資源限制。
- **範圍外 (第一階段):** 初始版本刻意排除的功能。

### 3. 核心功能
對於每個功能/模組,請指定:
- **優先級:** P0 (必須有)、P1 (應該有)、P2 (可有可無)。
- **用戶故事:** 作為一個[角色],我想要[行為],以便[利益]。
- **驗收標準:** 具體、可測試的通過/失敗條件。
- **邊界情況與備援方案:** 處理錯誤、空狀態、弱裝置/不支援的瀏覽器或失敗請求。

### 4. 用戶流程
- **逐步旅程:** 從開始到結束的時序性用戶或系統互動路徑。
- **視覺流程圖:** 呈現一個乾淨的 `mermaid` 圖表 (`flowchart TD` 或 `sequenceDiagram`)。

### 5. 架構
- **系統與資料夾結構:** 高層級元件互動與建議的目錄佈局。
- **架構圖:** 呈現一個 `mermaid` 圖表,顯示 UI、邏輯、API、渲染迴圈或外部服務如何連接。
- **核心模組 / 端點:** 關鍵路由、控制器或事件處理程序的表格。

### 6. 資料庫結構(適應專案類型)
- **如果是後端 / 持久化應用:** 提供 Mermaid `erDiagram` 與表格結構(欄位、型別、主鍵/外鍵約束、關聯)。
- **如果是純前端 / 靜態 / 3D / CLI / 工具:** 定義本地狀態結構、設定 JSON 結構、資產清單或表單/事件酬載結構,而非 SQL 表格。

### 7. 技術棧
根據用戶的限制,推薦最佳工具並附上簡短理由(前端/UI、邏輯/後端、資料/資產、部署)。

圖表與品質規則

  • 僅使用有效的 Mermaid: 始終將包含空格、括號或符號的節點標籤用雙引號包裹(例如,A["英雄區塊 (3D 檢視)"] --> B["卷軸觸發"]),以便圖表能無語法錯誤地正確渲染。
  • 杜絕廢話: 保持規格具體、可行,並能立即供開發者或 AI 編碼 Agent 直接實作。

相關技能