Communitygithub.com

wshobson/动工之前

面向创始人、产品经理和AI辅助开发者,在构建落地页、MVP、SaaS产品、内部工具、Agent工作流或重大功能前,预先评估需求、定位、变现、留存、信任、分发和采用等风险。

动工之前 是什么?

该技能在实施前提供一次紧凑的事前评估(预检),旨在识别最高风险假设、最小验证步骤以及应推迟构建的范围,确保开发工作不会浪费在未经验证的想法上。它覆盖需求验证、市场定位、变现路径、用户留存、信任建立、分发渠道和功能采用等七个核心风险维度,并给出明确的风险等级(低/中/高)、最可能失败的核心假设、应立即寻找的最小证据、下一步具体行动以及建议推迟的内容。技能支持Claude Code、Cursor、Codex等主流AI编码助手,以及一般对话型AI,帮助产品构建者在投入工程资源前做出更明智的决策。

兼容平台~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应用、市场平台、内容站点、Agent工作流或内部工具
  • 对采用、收入、留存、信任或分发影响不明确的主要功能
  • 定位薄弱可能浪费开发或推广精力的公开发布资产

当任务属于狭窄的实现修复、重构、测试修复、依赖更新,或已有明确验收标准的已验证变更时,跳过此技能。

风险检查清单

对照以下风险审查想法:

  • 需求: 是否有证据表明特定买家或用户迫切需要此物?
  • 定位: 目标用户能否一句话理解它是什么以及它为何重要?
  • 变现: 是否存在可信的付费、预算或战略价值路径?
  • 留存: 用户首次尝试后是否有理由返回?
  • 信任: 产品是否需要用户可能抗拒的可信度、数据访问、集成或行为改变?
  • 分发: 是否有可重复的方式触达目标用户?
  • 功能采用: 对于功能工作,该功能是否会改变用户行为,还是仅仅增加表面积?

如果结论不明确,请参考 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.

相关技能