القائمة
把模糊的功能想法逼成具體的 PRD。一次問完所有關鍵問題，存成 md 檔讓使用者 填答，迭代到對齊後產出 PRD draft，再交給 create-plan 寫詳細計畫。當使用者 說「grill me」、「拷問」、「釐清需求」、「想做 X 但很模糊」、「幫我把想法 變具體」、「pre-PRD」時觸發。**只做需求對齊，不寫程式、不寫 plan**。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | grill-me |
| description | 把模糊的功能想法逼成具體的 PRD。一次問完所有關鍵問題，存成 md 檔讓使用者 填答，迭代到對齊後產出 PRD draft，再交給 create-plan 寫詳細計畫。當使用者 說「grill me」、「拷問」、「釐清需求」、「想做 X 但很模糊」、「幫我把想法 變具體」、「pre-PRD」時觸發。**只做需求對齊，不寫程式、不寫 plan**。 |
| allowed-tools | Read, Write, Edit, Bash |
把模糊的功能想法逼成具體的 PRD。批次提問、md 迭代，直到對齊後交給 /create-plan。
收到 seed 後：
接受 1–2 句的模糊想法作為 seed。
若使用者一開始給長篇規格（>3 句），要求濃縮：
「這個描述很詳細，但 grill 的價值在於從零逼出破綻——請把想法縮成一句話， 讓我從最基本的角度開始問。」
從 seed 語意生成 slug（英文小寫、hyphen 分隔、≤4 個字）。
路徑判斷：
thoughts/ 目錄存在：寫到 thoughts/shared/grill/YYYY-MM-DD-<slug>.mdgrill/YYYY-MM-DD-<slug>.md（在當前工作目錄下建立）用 date +%Y-%m-%d 取得今天日期。
套用 md Template，填入：
寫入後在 chat 告知路徑：
「已建立
<path>，請在每題A:下方填入答案，填完後回到 chat 說「答完了」。」
等待使用者填答。不要在這個階段追問。
使用者填完後會說「答完了」或執行 /grill-me review <md path>。
讀取 md 檔，逐題評估答案的「具體程度」：
具體的判斷標準：
若 ≥1 題答案仍模糊：
## Round N Questions 下追加新一輪問題（只問模糊的那幾題的 follow-up）status: awaiting-answers，rounds: N若全部答案夠具體：
## PRD Draft 區塊（套用 PRD Draft Template）status: ready-for-planPRD Draft 填好後，在 chat 說：
「PRD 已寫入
<path>，狀態為ready-for-plan。 下一步：/create-plan <path>」
以下 5 題每次 Round 1 都問，不可省略：
依 seed 內容決定是否追加以下問題（每條最多加 1 題）：
| seed 出現關鍵詞 | 追加問題 |
|---|---|
| 資料、DB、ETL、bigquery、表、欄位 | 資料來源、量級、是否需要回溯歷史？ |
| UI、頁面、介面、按鈕、表單 | edge case：空狀態、權限視圖、異常輸入分別怎麼處理？ |
| API、Cloud Run、外部服務、webhook | rate limit、認證方式、配額上限、retry 策略？ |
| 部署、上線、release、rollout | rollout 策略、回滾觸發條件、是否需要 feature flag？ |
若上述都不符合：不加題（最多 7 題總量：5 核心 + 2 動態）。
每次建立新 grill md 時使用此格式：
---
seed: "<原始 seed 文字>"
created: <YYYY-MM-DD>
status: awaiting-answers # awaiting-answers | reviewing | ready-for-plan
rounds: 1
---
# Grill: <slug>
## Seed
<原始 seed，1–2 句>
## Round 1 Questions
### Q1: 誰會用 / 誰刻意不服務？
// FEEDBACK:
### Q2: 失敗或降級時怎麼辦？
// FEEDBACK:
### Q3: 怎麼知道成功？怎麼知道失敗？
// FEEDBACK:
### Q4: 為什麼不用現成方案？為什麼不直接不做？
// FEEDBACK:
### Q5: 明確 out of scope 是什麼？
// FEEDBACK:
<!-- 動態加題（若有）放在這裡 -->
## PRD Draft
<!-- status = ready-for-plan 時填 -->
## Notes
<!-- 自由區，使用者可寫雜記 -->
當所有問題對齊後，填入 ## PRD Draft 區塊（≤30 行）：
## PRD Draft
### Problem
<2–3 句>
### Users
- In: <誰用>
- Out: <誰不服務>
### Success Metrics
- <指標 1>
- <指標 2>
### In Scope (v1)
- <項目 1>
- <項目 2>
### Out of Scope
- <項目>
### Open Risks
- <風險>
### Design Concept
<一段話描述這東西是什麼，作為 create-plan 的入口>
/create-plan 的工作/create-plan —— 讓使用者手動執行，不自動串接Document codebase as-is via parallel sub-agents. Use when researching how code works, mapping architecture, or answering questions about existing systems. Auto-detects thoughts/ directory — if present, integrates historical context and syncs; if absent, skips those steps.
Create the Questions artifact before codebase research, design, planning, or implementation. Use for feature tickets, architecture changes, unclear code work, CRISPY/QRSPI Questions phase, or when the agent needs to define code-answerable unknowns and human questions before researching or planning.
Create a concise Design Concept artifact after questions and codebase research are available. Use for CRISPY/QRSPI Design phase, architecture alignment, feature design discussion, or turning current-state research into a small human-reviewable proposed shape before detailed planning.
Create an interface-first Structure Outline before detailed planning or implementation. Use for CRISPY/QRSPI Structure Outline phase, vertical planning, method signatures, type contracts, API/component boundaries, or converting an accepted design concept into end-to-end slices with verification checkpoints.
Create comprehensive handoff documents for transferring work to another agent session. Use when the user requests to create a handoff, end a session, or document work-in-progress for future continuation.
Create detailed implementation plans through interactive research and iteration. Use when starting a new feature or ticket that needs a comprehensive technical plan. Saves plans to the repo-appropriate plans location and emits Personal Knowledge events when applicable.