Communitygithub.com

Grill Me — 透過系統性詰問達成共同理解

反覆面試使用者關於計畫或設計,直到達成共同理解,並解決決策樹的每個分支。當使用者想要壓力測試計畫、被質詢設計或提到「考驗我」時使用。

Grill Me — 透過系統性詰問達成共同理解 是什麼?

這個技能的核心目的是在 AI 代理與使用者之間建立「共同理解」,透過系統性的詰問過程,挖掘計畫中所有隱含的假設、未陳述的限制與模糊的決策。它要求代理遵循八大主要指令,包括:所有問題必須透過「AskUserQuestion」工具提出、在相同領域內批量提問(最多 4 個)、優先提供推薦選項、先探索程式碼庫再提問、按依賴順序解決決策、維護結構化決策記錄、不遺漏任何假設,以及專注於具體行為與資料流。 技能支援的平台包括 Claude Code、Cursor 等具備「AskUserQuestion」工具的 AI 代理。整個流程從靜態閱讀計畫、探索程式碼庫、檢查 Git 歷史與專案檔案開始,然後呈現摘要給使用者確認。接著,代理會根據「interrogation-domains.md」定義的領域(如意圖、架構、錯誤處理等),按相關性排序逐一深入每個領域的決策點,批量提問並記錄。最後,代理會呈現完整的決策表格,標記未解決或延後項目,並詢問是否需要重新檢視任何領域。 當「AskUserQuestion」工具不可用時,技能提供純文字格式的備援方案。使用預覽功能(程式碼片段、架構圖等)可幫助使用者在單選選項中直觀比較。整個過程強調「具體性」與「可驗證性」,避免抽象概念,確保在實作開始前達成零未審查假設的狀態。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cdcoonce/Portfolio_Website/tree/HEAD/.claude/skills/grill-me

在你喜歡的 AI 中提問

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

說明文件

Grill Me — 透過系統性詰問達成共同理解 是做什麼的?

哲學

詰問的目的是在代理與使用者之間建立共同理解。每個計畫都包含隱含的假設、未陳述的限制與模糊的決策。詰問會逐一走過決策樹的每個分支,直到雙方完全一致。

目標是在實作開始前,達到零未審查假設的狀態。

首要指令

  1. 每個問題都使用 AskUserQuestion。 所有詰問問題都必須透過 AskUserQuestion 工具提出。絕不能以純文字輸出問題。
  2. 領域內批量提問。 在相同詰問領域內,最多將 4 個相關問題組成單一 AskUserQuestion 呼叫。絕不能在不同領域的問題中混合使用單一呼叫。
  3. 以你的建議為先。 你的推薦答案永遠是第一個選項,並在標籤上附加 (建議)。
  4. 先探索,再提問。 如果問題可以透過閱讀程式碼庫、文件或檢查現有模式來回答,就應先做這些事,而不是提問。僅針對需要使用者判斷的決策提出問題。
  5. 按順序解決依賴關係。 有些決策依賴於其他決策。識別依賴鏈,並先解決上游決策。
  6. 使用結構化記錄追蹤一切。 以結構化表格形式維護決策記錄。對於每個已解決的問題,記錄:領域、主題(標題)、選取的選項標籤,以及如果選擇「其他」時的任意自訂文字。在對話脈絡中呈現記錄 — 不使用檔案 I/O。
  7. 不讓任何假設存活。 如果某件事是隱含但未明說的,就將它浮現出來。如果某件事似乎很明顯,就加以確認。共同理解意味著明確的同意,而不是舒適的沉默。
  8. 保持具體。 將問題圍繞在具體行為、資料流和使用者可見的結果上 — 而不是抽象概念。

詰問前設定

在提出任何問題之前,靜態建立脈絡:

  1. 閱讀使用者想要被詰問的計畫或設計文件
  2. 探索程式碼庫,了解現有模式、限制與相關程式碼
  3. 檢查最近的 Git 歷史,了解目前工作的脈絡
  4. 閱讀 project.md 和 CLAUDE.md,了解專案慣例

然後呈現一份你目前所理解內容的簡短摘要,並按詰問領域組織。這讓使用者在深入逐分支提問之前,有機會修正主要的誤解。

詰問領域

依據 references/interrogation-domains.md 中定義的領域來處理。根據計畫調整順序 — 從計畫核心所在的領域開始,並向外擴展。跳過明顯不相關的領域。

詰問流程

1. 閱讀並總結你對計畫的理解
2. 使用者確認或修正摘要
3. 對於每個詰問領域(按相關性排序):
   a. 識別此領域中的所有決策點與假設
   b. 將相關決策點分組,最多 4 個問題為一批
   c. 對於每批,呼叫單一 AskUserQuestion 呼叫
      (每個問題的建議選項放在第一位)。記錄所有選取的選項。
   d. 在解決領域中的所有點之後,總結所做的決策
      將該領域的決策以結構化表格形式呈現為行。
4. 在所有領域涵蓋完畢後:
   - 以結構化表格形式呈現完整的決策記錄:
     | # | 領域 | 主題 | 決策 | 備註 |
     |---|------|------|------|------|
     | 1 | 意圖 | 目標 | 其他 | 內部儀表板供營運團隊使用,非客戶面向 |
   - 標記所有未解決或延後的項目
   - 詢問是否需要重新檢視任何領域

問題格式

每個問題都必須透過 AskUserQuestion 工具提出。每個呼叫的結構如下:

{
  "question": "當 Oura API 回傳 429 時,我們該如何處理速率限制?",
  "header": "速率限制",
  "options": [
    {
      "label": "指數退避 (建議)",
      "description": "以指數退避重試 (1 秒、2 秒、4 秒)。優雅處理暫時性限制,且與 src/api_client.py 中已有的重試模式相符。"
    },
    {
      "label": "排入下輪執行",
      "description": "跳過請求,並將其加入下一個排程執行。較簡單,但會將資料延後一個週期。"
    }
  ],
  "multiSelect": false
}

依賴於: 在 question 文字中說明此問題建構於哪些先前的決策,如果獨立則註明「無依賴」。

批次提問範例

{
  "questions": [
    {
      "question": "主要的部署目標是什麼?",
      "header": "部署",
      "options": [
        {
          "label": "Docker + ECS (建議)",
          "description": "與現有基礎設施相符。部署管道已存在。"
        },
        {
          "label": "Kubernetes",
          "description": "更靈活,但需要新的基礎設施設定。"
        },
        {
          "label": "無伺服器",
          "description": "較低的營運負擔,但有冷啟動延遲的顧慮。"
        }
      ],
      "multiSelect": false
    },
    {
      "question": "我們應該包含哪些監控方式?",
      "header": "監控",
      "options": [
        {
          "label": "結構化日誌 (建議)",
          "description": "JSON 日誌送至 CloudWatch。可搜尋並可設定警示。"
        },
        {
          "label": "APM 追蹤",
          "description": "分散式追蹤,以便觀察請求流程。"
        },
        {
          "label": "自訂指標",
          "description": "在 Datadog 中的業務特定計數器與量規。"
        }
      ],
      "multiSelect": true
    }
  ]
}

使用預覽

當使用者需要視覺比較具體成品(如程式碼片段、架構圖、資料庫綱要形狀或設定範例)時,請在選項上使用 preview 欄位。預覽內容會以 Markdown 格式呈現在等寬字型方框內,並提供並排比較。

何時使用預覽:

  • 比較兩個程式碼模式或實作
  • 顯示不同的資料庫綱要形狀或資料結構
  • 使用 ASCII 圖表呈現架構替代方案

限制: 預覽僅限單選 (multiSelect: false)。如果需要多選,請省略預覽,改用描述。

預覽範例:

{
  "question": "我們應該為資料管道使用哪種模式?",
  "header": "管道",
  "options": [
    {
      "label": "生成器管道 (建議)",
      "description": "惰性求值,對大型資料集節省記憶體。",
      "preview": "def pipeline(source):\n    for record in source:\n        cleaned = clean(record)\n        validated = validate(cleaned)\n        yield validated"
    },
    {
      "label": "批次管道",
      "description": "一次處理所有記錄。較簡單,但記憶體使用量較高。",
      "preview": "def pipeline(source):\n    records = list(source)\n    cleaned = [clean(r) for r in records]\n    validated = [validate(r) for r in cleaned]\n    return validated"
    }
  ],
  "multiSelect": false
}

提問規則

  • 每個問題都使用 AskUserQuestion。 沒有例外。
  • 第一個選項 = 建議。 第一個選項的標籤始終附加 (建議)。
  • 批量相關問題。 將同一領域內最多 4 個相關問題組成一個 AskUserQuestion 呼叫。跨領域問題必須分開呼叫。
  • 尊重工具限制。 每個問題 2-4 個選項。標題最多 12 個字元。當選項並非互斥時,使用 multiSelect: true(例如「我們應該使用哪些測試方法?」或「哪些領域需要涵蓋?」)。
  • 過濾選項。 當有效選擇超過 4 個時,根據程式碼庫脈絡呈現最相關的 3 個。使用者為未列出的項目選擇「其他」。
  • 具體明確。「我們該如何處理錯誤?」太過模糊。「當 Oura API 回傳 429 時,我們應該以退避方式重試,還是排入下一輪執行?」更具體。
  • 展示你的依據。 如果你的建議是基於你在程式碼庫中發現的內容,請引用檔案與行號。
  • 接受答案。 當使用者做出決定後,記錄下來並繼續前進。除非後續的決策與先前的決策產生衝突,否則不要重新爭論。

備援方案(無 AskUserQuestion 可用時)

如果執行環境中不提供 AskUserQuestion,請改用此文字格式:

[標題] — [主題]

[問題的清晰陳述]

建議: [你的建議與原因]

替代方案:

  • (A) [選項] — [權衡]
  • (B) [選項] — [權衡]

何時停止

當下列條件滿足時,詰問即完成:

  • 每個相關的詰問領域都已涵蓋
  • 所有決策分支都已解決或明確延後
  • 使用者確認達成共同理解

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

cdcoonce/Portfolio_Website

Git commit workflow with enforced conventional commit style. Use when Claude needs to stage and commit changes, craft commit messages, or the user asks to commit, make a commit, or save their work. Ensures consistent commit message format, proper scoping, and atomic commits across the project.

cdcoonce/Portfolio_Website

AI-powered code quality analysis for Python, Markdown, and Mermaid diagrams. Use this skill when: (1) reviewing code for quality issues, (2) checking Python files for PEP8 violations, unused code, missing type hints, docstring problems, complexity issues, or potential runtime errors, (3) validating Markdown documentation for broken links, heading structure, or formatting issues, (4) validating Mermaid diagram syntax, (5) the user asks for a "code review" or "quality check", (6) analyzing code snippets pasted in conversation, or (7) suggesting and applying fixes for code quality issues.

cdcoonce/Portfolio_Website

Deploy the portfolio chat agent Lambda function to AWS. Use when the user asks to deploy, redeploy, push to Lambda, update the chat agent, or after updating context files or lambda_function.py. Rebuilds the knowledge base, packages dependencies, and deploys to AWS Lambda.

cdcoonce/Portfolio_Website

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

cdcoonce/Portfolio_Website

Orchestrate the full GitHub-issues-driven development lifecycle. 7-phase pipeline from brainstorm through PR with state tracking and cross-conversation resume. Use when user says "dev cycle", "development workflow", "full development pipeline", or invokes /dev-cycle.

cdcoonce/Portfolio_Website

Production Python coding standards with automatic version detection (3.10-3.13). Use when writing, reviewing, or refactoring Python to ensure adherence to modern type syntax, LBYL exception handling, pathlib operations, ABC-based interfaces, and production-tested patterns. Not Dagster-specific - applies to any Python project.

cdcoonce/Portfolio_Website

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

cdcoonce/Portfolio_Website

GitHub CLI (gh) integration for managing issues, pull requests, branches,

cdcoonce/Portfolio_Website

Explore a codebase to find opportunities for architectural improvement, focusing on making the codebase more testable by deepening shallow modules. Use when user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more AI-navigable.

cdcoonce/Portfolio_Website

CEO/founder-mode plan review. Rethink the problem, find the 10-star product, challenge premises, expand scope when it creates a better product. Three modes: SCOPE EXPANSION (dream big), HOLD SCOPE (maximum rigor), SCOPE REDUCTION (strip to essentials). Use when the user asks for a plan review, CEO review, mega review, or wants a plan challenged/stress-tested before implementation.

cdcoonce/Portfolio_Website

Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Use when user wants to convert a PRD to issues, create implementation tickets, or break down a PRD into work items.

cdcoonce/Portfolio_Website

Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices, saved as a local Markdown file in docs/plans/. Use when user wants to break down a PRD, create an implementation plan, plan phases from a PRD, or mentions "tracer bullets".

cdcoonce/Portfolio_Website

Generate or update the `.claude/docs/project.md` file that gives Claude project-specific context. Use this skill when the user asks to create, update, regenerate, or refresh project context, or says things like "update project.md", "generate project context", "this repo needs a project.md", or "Claude doesn't know about this project". Also trigger when onboarding Claude to a new repository for the first time.

cdcoonce/Portfolio_Website

Generate comprehensive, high-quality README.md files for code repositories. Use this skill whenever the user asks to create, write, generate, update, or improve a README for any project or repository. Also trigger when the user says things like "document this project", "write docs for this repo", "this repo needs a README", "help me onboard developers to this codebase", or asks for project documentation in markdown. Even if the user just says "README" or "readme" in the context of a codebase, use this skill.

cdcoonce/Portfolio_Website

Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. Use when user wants to plan a refactor, create a refactoring RFC, or break a refactor into safe incremental steps.

cdcoonce/Portfolio_Website

Set up pre-commit hooks for the current repo. Use when user wants to add pre-commit hooks, configure commit-time linting, formatting, type checking, or testing. Triggers on "pre-commit", "git hooks", "linting hooks", or /setup-pre-commit.

cdcoonce/Portfolio_Website

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

cdcoonce/Portfolio_Website

Triage a bug or issue by exploring the codebase to find root cause, then create a GitHub issue with a TDD-based fix plan. Use when user reports a bug, wants to file an issue, mentions "triage", or wants to investigate and plan a fix for a problem.

cdcoonce/Portfolio_Website

Rewrites the prose sections of wiki pages in-place. Reads source files to understand current context, then updates only the content inside <!-- claude:prose --> ... <!-- claude:prose:end --> markers. Never touches <!-- generated:start --> ... <!-- generated:end --> blocks. Supports targeting a single page with /update-wiki {PageName}.

cdcoonce/Portfolio_Website

Create a PRD through user interview, codebase exploration, and module design, then submit as a GitHub issue. Use when user wants to write a PRD, create a product requirements document, or plan a new feature.

相關技能