Communitygithub.com

wshobson/before-you-build

針對創辦人、產品經理及 AI 輔助開發者,在建置前進行產品與功能風險審查。當使用者即將建置登陸頁面、MVP、SaaS 產品、內部工具、代理工作流程或重大功能時,使用此技能在實作前檢查需求、定位、獲利、留存、信任、分銷及採用風險。

before-you-build 是什麼?

此技能提供一個結構化的「事前驗屍」(pre-mortem)流程,幫助開發者與產品負責人在投入大量資源進行實作之前,識別並評估產品或功能構想中的關鍵風險。它涵蓋七大風險維度:需求、定位、獲利、留存、信任、分銷及功能採用,並透過簡潔的檢查清單引導使用者思考。技能會根據評估結果輸出風險裁決、主要假設、優先尋找的證據、下一步行動以及應延遲的部分,確保團隊專注於高風險假設的驗證,避免無謂的開發浪費。此技能適用於 Claude Code、Cursor 及 Codex 等 AI 代理平台,其運作完全基於提供的 SKILL.md 文件,無需外部工具或 API,僅需使用者的構想描述即可進行分析。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wshobson/agents/tree/main/plugins/before-you-build/skills/before-you-build

在你喜歡的 AI 中提問

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

說明文件

建置前審查

在實作前進行簡潔的「事前驗屍」。目標不是阻止建置,而是找出風險最高的假設、最簡單的驗證步驟,以及應在證據更充分後才進行的建置範圍。

使用時機

當使用者要求建置或推出以下項目時,請使用此技能:

  • 新產品、MVP、原型、登陸頁面、SaaS 應用程式、市集、內容網站、代理工作流程或內部工具
  • 對採用、營收、留存、信任或分銷影響不明確的重大功能
  • 定位不佳可能浪費開發或推廣成本的公開推出素材

當任務是狹隘的實作修復、重構、測試修復、依賴更新,或已有明確驗收標準且經過驗證的變更時,請跳過此技能。

風險檢查清單

從以下風險維度審查構想:

  • 需求: 是否有證據顯示特定買家或使用者迫切需要此產品?
  • 定位: 目標使用者能否在短短一句話內理解這是什麼以及為何重要?
  • 獲利: 是否存在可信的付費、預算或戰略價值路徑?
  • 留存: 使用者在使用後是否有理由再次回來?
  • 信任: 產品是否需要使用者可能抗拒的信譽、資料存取、整合或行為改變?
  • 分銷: 是否有可重複的方式接觸目標使用者?
  • 功能採用: 對於功能開發,該功能會改變使用者行為,還是只增加表面功能?

如果裁決不明確,請參閱 references/risk-checklist.md 以取得更深入的問題。

輸出格式

保持回應簡短且以決策為導向:

  1. 風險裁決: 低、中或高風險,並用一句話解釋原因。
  2. 主要假設: 最可能導致專案失敗的單一假設。
  3. 優先尋找的證據: 在建置更多內容之前,最簡單有用的信號。
  4. 下一步行動: 一個具體的驗證步驟或縮小後的建置範圍。
  5. 延遲項目: 什麼是還不應該建置的。

指導原則

  • 對薄弱證據直言不諱,但避免否定使用者的構想。
  • 偏好較小的驗證步驟,而非大型研究計畫。
  • 區分產品風險與工程難度。
  • 如果構想已經驗證,說明哪些證據使其風險較低,並建議最小的實作切片。
  • 如果缺少事實,請指出缺少的證據,而不是憑空捏造市場說法。

Individual skills in this repo

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

wshobson/accessibility-compliance

Implement WCAG 2.2 compliant interfaces with mobile accessibility, inclusive design patterns, and assistive technology support. Use when auditing accessibility, implementing ARIA patterns, building for screen readers, or ensuring inclusive user experiences.

wshobson/airflow-dag-patterns

Build production Apache Airflow DAGs with best practices for operators, sensors, testing, and deployment. Use when creating data pipelines, orchestrating workflows, or scheduling batch jobs.

wshobson/angular-migration

Migrate from AngularJS to Angular using hybrid mode, incremental component rewriting, and dependency injection updates. Use when upgrading AngularJS applications, planning framework migrations, or modernizing legacy Angular code.

wshobson/anti-reversing-techniques

Understand anti-reversing, obfuscation, and protection techniques encountered during software analysis. Use this skill when analyzing malware evasion techniques, when implementing anti-debugging protections for CTF challenges, when reverse engineering packed binaries, or when building security research tools that need to detect virtualized environments.

wshobson/api-design-principles

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.

wshobson/architecture-decision-records

Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.

wshobson/architecture-patterns

Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use this skill when designing clean architecture for a new microservice, when refactoring a monolith to use bounded contexts, when implementing hexagonal or onion architecture patterns, or when debugging dependency cycles between application layers.

wshobson/async-python-patterns

Master Python asyncio, concurrent programming, and async/await patterns for high-performance applications. Use when building async APIs, concurrent systems, or I/O-bound applications requiring non-blocking operations.

wshobson/attack-tree-construction

Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders.

wshobson/auth-implementation-patterns

Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems. Use when implementing auth systems, securing APIs, or debugging security issues.

wshobson/avoid-ai-writing

Audit and rewrite prose so it stops reading as machine-generated. Use this skill when asked to remove AI-isms, clean up AI writing, edit a draft for AI tells, audit a README, changelog, release note, PR description, or blog post for machine-sounding prose, or make text sound less like AI. Supports a detect-only mode, a rewrite mode, and an edit-in-place mode, with optional voice and context profiles.

wshobson/backtesting-frameworks

Build robust backtesting systems for trading strategies with proper handling of look-ahead bias, survivorship bias, and transaction costs. Use when developing trading algorithms, validating strategies, or building backtesting infrastructure.

wshobson/bash-defensive-patterns

Master defensive Bash programming techniques for production-grade scripts. Use when writing robust shell scripts, CI/CD pipelines, or system utilities requiring fault tolerance and safety.

wshobson/bats-testing-patterns

Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven development of shell utilities.

wshobson/bazel-build-optimization

Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.

wshobson/billing-automation

Build automated billing systems for recurring payments, invoicing, subscription lifecycle, and dunning management. Use when implementing subscription billing, automating invoicing, or managing recurring payment systems.

wshobson/binary-analysis-patterns

Master binary analysis patterns including disassembly, decompilation, control flow analysis, and code pattern recognition. Use when analyzing executables, understanding compiled code, or performing static analysis on binaries.

wshobson/block-no-verify-hook

Configure a PreToolUse hook to prevent AI agents from skipping git pre-commit hooks with --no-verify and other bypass flags. Use when setting up Claude Code projects that enforce commit quality gates.

wshobson/brand-landingpage

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

wshobson/changelog-automation

Automate changelog generation from commits, PRs, and releases following Keep a Changelog format. Use when setting up release workflows, generating release notes, or standardizing commit conventions.

相關技能