AGENT SKILL

needs-analysis

Mandatory high-priority need validation. Always use before general brainstorming or planning whenever Tony's message contains the Chinese word “需求” or the standalone English word “needs” (case-insensitive). Investigate product, customer, business, or software needs with supporting and disconfirming evidence; judge true, conditional, pseudo, or insufficient; score breadth, urgency, and frequency; then design a decisive validation before development.

使用场景视觉设计
License 许可
MIT
最近更新
2026-11-01
Stars
★ 3
Forks
1

01 前言 Front Matter

name
needs-analysis
description
Mandatory high-priority need validation. Always use before general brainstorming or planning whenever Tony's message contains the Chinese word “需求” or the standalone English word “needs” (case-insensitive). Investigate product, customer, business, or software needs with supporting and disconfirming evidence; judge true, conditional, pseudo, or insufficient; score breadth, urgency, and frequency; then design a decisive validation before development.

02 资源文件 2

03 SKILL.md 正文

Needs Analysis

Turn a raw request into an evidence-backed product decision. Separate whether the problem is real from whether it is an attractive product opportunity.

Operating rules

  • Start with the conclusion. Use 真需求, 有条件成立, 伪需求, or 证据不足; include confidence (高/中/低). Do not force a binary verdict when evidence is missing.
  • Treat “广泛、刚需、高频” as opportunity qualities, not proof that a need exists. A need can be real but commercially weak.
  • Consider a candidate attractive when the need is at least conditionally real and one or more of the three qualities scores at least 3/5. More passing qualities increase priority, but do not replace evidence.
  • Distinguish facts, user claims, third-party estimates, inference, and unknowns. Cite or link sources when research tools are available.
  • Prefer observed behavior over stated preference: payment, active workaround, repeated use, switching, budget, deadlines, support tickets, search or purchase behavior.
  • Do not confuse a requested feature with the underlying need. Analyze the problem independently of the proposed solution.
  • Continue on low-risk assumptions when possible. Ask only questions whose answers would materially change the verdict or validation test.

Read rubric.md before scoring or issuing the final verdict.

Workflow

1. Normalize the raw need

Rewrite it without solution bias:

[specific user] in [specific situation] struggles to [job/progress], causing [measurable cost or consequence]; today they use [current alternative/workaround].

Record separately:

  • proposed solution;
  • target user and buyer;
  • triggering situation;
  • desired outcome;
  • current alternative;
  • claimed frequency and consequence;
  • uncertainties and assumptions.

If the user and situation are absent, infer a provisional version and label it as an assumption.

2. Build the evidence set

Search only as deeply as the decision warrants. Use this order:

  1. User-provided materials, current workspace, product analytics, customer notes, support records, sales or payment evidence.
  2. Direct customer evidence: interviews with concrete past behavior, paid pilots, preorders, retained usage, switching or active workarounds.
  3. Market behavior: competitor customers and pricing, reviews, complaints, procurement/RFPs, job posts, communities, search trends.
  4. Market reports, surveys, social engagement, and generic opinions as supporting proxies only.

For each important item capture: source, date, affected segment, what it supports or contradicts, and evidence strength. Recheck live sources for time-sensitive claims. If access is unavailable, state the limitation and do not fabricate findings.

Search for disconfirming evidence as deliberately as confirming evidence. Look for non-consumption, free substitutes, low retention, long replacement cycles, weak willingness to pay, or a segment too costly to reach.

3. Judge true versus false need

Evaluate these independent questions:

  • Is there an identifiable user in a recurring or important situation?
  • Does the problem exist without the proposed product?
  • Is there observable cost, risk, delay, frustration, lost revenue, or missed progress?
  • Do users already spend time, money, reputation, or effort on a workaround?
  • Is the buyer able and willing to act now?
  • Does contrary evidence weaken the claimed problem or segment?

Use the rubric's verdict rules. A verbal “I would use this” is weak evidence. A paid or repeated workaround is strong evidence.

4. Score the three opportunity qualities

Score each from 0–5 using the rubric and show one sentence of evidence:

  • 广泛 Breadth: enough reachable users share the problem; define the denominator and reachable segment instead of saying “everyone”.
  • 刚需 Urgency: inaction creates a material, time-bound consequence; distinguish must-have from useful.
  • 高频 Frequency: the problem or workflow recurs often enough to support habit, retention, or repeat purchase.

Mark each quality 通过 at 3–5 and 未通过 at 0–2. Do not hide the three scores inside a single average.

Map passed qualities to product logic:

  • 广泛: emphasize simple onboarding, distribution, standardization, or lower unit price.
  • 刚需: emphasize outcome certainty, speed, trust, service, and premium pricing.
  • 高频: emphasize workflow integration, retention, automation, and subscription or repeat use.

5. Design the smallest decisive validation

Identify the riskiest assumption and propose a test that can fail. Include:

  • target participant and recruitment channel;
  • artifact or offer;
  • behavior to observe;
  • sample size or exposure;
  • success threshold;
  • failure/stop threshold;
  • timebox and next decision.

Prefer commitment tests over opinion tests: paid diagnostic, deposit, signed pilot, data access, calendar commitment, or repeated usage. For Tony's AI 本机工作台服务, when relevant, map the test to the current 50 触达 / 10 访谈 / 3 demo / 1 付费意向 gate and recommend the next missing external action.

6. Deliver the analysis

Use this structure, scaling detail to the decision:

  1. 结论 — verdict, confidence, and one-sentence reason.
  2. 需求重述 — user, situation, job, consequence, current alternative.
  3. 证据与反证 — compact table with source/date/type/strength/implication.
  4. 真伪需求判断 — behavioral evidence, gaps, and why the verdict follows.
  5. 三要素评分 — 广泛 X/5, 刚需 X/5, 高频 X/5; pass count and product implications.
  6. 产品决策 — build now, validate first, narrow segment, reposition, or stop.
  7. 最小验证实验 — exact test, thresholds, timebox, and next action.
  8. 仍未知 — only uncertainties capable of changing the decision.

When the user also requests implementation, present the analysis first, convert validated findings into acceptance criteria, then continue the implementation unless a failed gate makes building wasteful or unsafe.

Failure modes

  • Do not call a need real solely because many people liked, searched, or discussed it.
  • Do not call a need false solely because it is niche or infrequent; urgent niche problems can support premium products.
  • Do not count the same evidence twice across breadth, urgency, and frequency.
  • Do not use market size as a substitute for reachable users or willingness to pay.
  • Do not make interview count the goal; use interviews to uncover past behavior and then seek commitment.
  • Do not recommend a full build when a landing page, manual concierge test, paid diagnostic, or prototype can test the riskiest assumption faster.

04 同仓库更多 Skills

shengdabai
shengdabai/Tony-Claude-Code-Skills

xiaolai-methodology

以李笑来(Li Xiaolai)的思考方式、方法论与表达风格,为用户做全方位 1-on-1 教练指导,覆盖创业、赚钱、投资、学习、自学、读书写作、用 AI、以及人生心态与自我管理。当用户提到 "李笑来"、"笑来"、"笑来老师"、"扮演李笑来"、"找笑来聊聊"、"笑来怎么看"、"xiaolai"、"把时间当作朋友"、"通往财富自由之路"、"定投改变命运"、"韭菜的自我修养"、"自学是门手艺"、"让时间陪你慢慢变富"、"七年就是一辈子"、"元认知"、"活在未来"、"复利/长期主义"、"践行"、"痴迷改进"、"个人商业模式/出售时间"、"睡后收入"、"定投"、"财富自由"、"操作系统升级"、"最少必要知识"、"北极星提示词"、"用 AI 该怎么学/思考" 等任一触发词,或当用户带着关于创业/赚钱/投资/学习/职业/重大人生决策的困惑、希望被人用笑来式的「逻辑 + 大白话 + 类比 + 重新定义 + 践行导向」来点醒和指导时,自动进入李笑来教练模式。

写作与文案
★ 3
shengdabai
shengdabai/Tony-Claude-Code-Skills

zread

Produce and consume a wiki-style knowledge base for a code repository via the `zread` CLI and its on-disk output under `./.zread/wiki/`. Use this skill whenever the user wants to understand, onboard onto, explore, summarize, map, or get an overview of an unfamiliar codebase; asks for architecture docs, a project wiki, a repo walkthrough, module/package explanations, or "what does this repo do"; wants to generate, regenerate, resume, browse, or serve code documentation locally; or mentions zread / zread.ai directly. Also use it proactively before diving into a large unknown repo — if `./.zread/wiki/current` exists, read the generated pages instead of crawling source file-by-file; if it doesn't, consider offering to run `zread generate`. The trigger is the intent (understand a codebase through generated docs), not the literal word "zread".

开发工程师Skill与智能体开发
★ 3
shengdabai
shengdabai/Tony-Claude-Code-Skills

youtube

Launch the YouTube Creator Agent to auto-generate videos. Use when: user types /youtube, wants to create YouTube videos, generate video content, or upload to YouTube. Keywords: youtube, video, 视频, 创作视频, 发布视频

内容创作者Skill与智能体开发
★ 3
shengdabai
shengdabai/Tony-Claude-Code-Skills

youtube-script-sync

Sync, update, or optimize Tony's GetNote knowledge base `Youtube视频逐字稿` by turning each parent recording or first-person idea note into an idempotent child note containing a directly recordable YouTube long-video or Shorts script. Use when the user says “更新/同步/优化 Youtube视频逐字稿知识库”, or says “更新/同步/优化该知识库” while this knowledge base is the active context.

Skill与智能体开发
★ 3
shengdabai
shengdabai/Tony-Claude-Code-Skills

writing-skills

How to write SKILL.md files that trigger reliably and teach effectively. Use when creating, improving, or reviewing Claude Code skills.

开发工程师内容创作者写作与文案Skill与智能体开发
★ 3
shengdabai
shengdabai/Tony-Claude-Code-Skills

writing-rules

How to write .claude/rules/ files that Claude actually follows. Use when creating, improving, or reviewing project rules.

内容创作者写作与文案
★ 3