Community研究與資料分析github.com

功能規格摘要 (brief)

將一個功能想法轉化為一頁規格,涵蓋問題、目標受眾、MVP 範圍、非目標、編號的 Given/When/Then 驗收標準、受影響的路由、資料與電子郵件,以及未解決的問題。當使用者說「簡要說明」、「規格化」、「界定範圍」或「需要什麼」時,或在開始一個範圍不明確的功能之前使用。

功能規格摘要 (brief) 是什麼?

此技能旨在幫助開發者快速將模糊的功能想法轉化為結構化、可執行的單頁規格。它會自動讀取專案的 CLAUDE.md 與記憶條目,並瀏覽相關的路由、資料庫結構與電子郵件模板,以確保規格引用真實的檔案路徑與現有欄位。在必要時,它會以不超過三個問題的方式向使用者提問來釐清範圍,其餘假設則列於「未解決問題」中。輸出的規格包含標準的 MVP 範圍、非目標、可測試的 Given/When/Then 驗收標準,以及風險評估。此技能支援 Claude Code 等平台,預設直接輸出於對話中,僅在要求時才寫入檔案。它的設計遵守專案限制,例如禁止新增未要求的元件、設定或管理後台,並確保每個驗收條件都可透過流程檢查、冒煙測試或單元測試來驗證。

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

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

功能規格摘要 (brief) 是做什麼的?

功能:$ARGUMENTS

先奠基(靜默執行)

  • 讀取此儲存庫的 CLAUDE.md 及此專案的記憶條目。瀏覽該功能涉及的 routes、schema 及 email 模板。規格中會引用真實的檔案路徑與現有欄位。
  • 僅當某項決定會改變範圍時才進行提問。使用 AskUserQuestion 一次問一個問題,並附上建議選項,最多問 3 個問題。其餘事項皆視為假設,列在「未解決問題」中。

範圍的基本規則

  • MVP 指的是使用現有欄位和元件建構的傳統最小可行產品。「像任何電子商務平台」代表標準流程,而非特定平台。
  • 絕不新增未要求的功能、元件、設定、管理後台或分析工具。將它們列在「非目標」中。
  • 合作夥伴或 API 功能:通常「API 金鑰」代表環境變數中的租戶 ID,而不是開發者入口網站。
  • 尊重 CLAUDE.md/記憶中的專案限制(例如「不修改 schema」)。標記任何會違反限制的事項。

模板

# <功能名稱>:功能規格摘要
**問題:** 一到兩句話,描述使用者的痛點,而非解決方案。
**目標受眾:** 誰,以及數量(如果已知,請引用查詢或來源)。
**MVP:** 3-6 個要點,每個都可交付並可觀察。
**非目標:** 我們明確不在此次實作的事項。
**驗收標準**
1. Given <狀態>, When <動作>, Then <可觀察結果>。
2. ...(每個都可透過 flow-check、smoke 或 unit test 測試)
**影響範圍:** 路由 · 資料表/欄位(優先使用現有的) · 電子郵件 · 環境變數/機密 · 第三方
**風險:** 金錢、法律/GDPR、送達率、SEO(noindex/canonical)、i18n
**未解決問題:** 編號問題;每個問題附上我的預設答案(若無回應)

輸出

  • 預設輸出於對話中。僅在要求時才寫入 docs/briefs/<slug>.md。
  • 以一句話開頭(「簡要說明如下:N 個驗收標準,M 個未解決問題」),接著是規格內容。之後不應有其他內容。

退出條件

  • 每個驗收標準都可觀察,並對應到一種檢查方式(flow-check 步驟、smoke 預期結果或測試)。
  • MVP 中未包含未要求或非嚴格必要的事項。
  • 每個未解決問題都有預設答案,以便在等待回覆時即可開始開發。

Individual skills in this repo

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

iamk3nnyt/claude-skills

Checks UI copy across locales by comparing key parity between next-intl message catalogs and in-code sv/en COPY objects, finding placeholder and array mismatches and words from the other language leaking in (the "och" in English bug), then manually reviewing claims against terms and pricing and the project's banned phrases. Use after editing copy or translations, before shipping a page with new text, or when asked to proofread or check translations.

iamk3nnyt/claude-skills

Applies an agreed visual direction to a page or component by reusing existing components first, then verifies every width and dark mode with the headless-Chrome audit plus a before/after pixel diff, and reviews against Refactoring UI, Nielsen and WCAG 2.2. Use when asked to redesign, restyle, polish or "make it look like the reference", after design-ref or when the direction is already clear.

iamk3nnyt/claude-skills

Extracts the visual system from a reference site or pasted HTML (colour roles, type scale, spacing scale, radii, shadows, button/card/eyebrow anatomy, tone) and maps it onto the current project's existing tokens as a short token table. Use when the user shares a reference ("make it look like <site>", "in this style", a URL or HTML paste) before a redesign.

iamk3nnyt/claude-skills

QAs a project's transactional and digest emails by rendering every template without DB or network, screenshotting at 600 and 375 px in light, dark and images-off, and checking for placeholder leaks (undefined, NaN, {{…}}), preheader, unsubscribe, alt text, absolute links, Outlook-safe buttons, viewport meta and Gmail's 102 KB clip. Use when email templates change, before sending a campaign, or when asked to check how emails look.

相關技能