Community寫作與編輯github.com

AaronCx/claude-code-practices:需求深度訪談與規格撰寫

深度訪談使用者關於某項功能的所有細節,然後撰寫一份自足的 SPEC.md 檔案,以便在新的會話中根據這份規格進行實作。建議在建立任何大型功能前使用此技巧。

claude-code-practices:需求深度訪談與規格撰寫 是什麼?

這項 AI Agent 技巧旨在幫助開發者在開始大型功能實作前,先透過結構化的深度訪談來徹底釐清需求。它會使用 AskUserQuestion 工具,針對技術實作細節、UI/UX、邊界情況、潛在風險以及取捨進行多輪提問,避免問顯而易見的問題,而是深入挖掘開發者可能忽略的困難點。訪談結束後,它會自動產生一份自足的 SPEC.md 檔案,其中明確列出涉及的檔案與介面、說明哪些事項不在範圍內,並包含一個端到端的驗證步驟,確保功能正確無誤。最後,它會引導使用者執行 /clear 指令,在全新的會話中根據這份規格進行實作,這樣實作上下文就能保持純淨,只專注於規格本身。此技巧適用於 Claude Code、Cursor、Codex 等需要規劃與實作分離的 AI Agent 平台。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AaronCx/claude-code-practices/tree/HEAD/skills/spec-interview

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

使用者想要建立:$ARGUMENTS

使用 AskUserQuestion 工具對其進行詳細訪談。詢問技術實作、UI/UX、邊界情況、疑慮和取捨。不要問顯而易見的問題;深入挖掘他們可能沒有考慮到的困難點。持續訪談,直到所有事項都被涵蓋。

然後將完整的規格寫入 SPEC.md。最有用的規格是自足的:命名涉及的檔案和介面,說明哪些事項不在範圍內,並以一個端到端的驗證步驟結尾,證明功能運作正常。

最後,告訴使用者執行 /clear,然後在新的會話中根據 SPEC.md 進行實作,這樣實作上下文就只包含這份規格。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能