软件需求分析专家:从原始描述到可开发需求文档

前言

立项或接外包时,常见输入是一段口语化的想法、会议纪要或零散功能点。自己整理 PRD 要反复对齐粒度:敏捷团队要 Epic 和用户故事,传统交付要模块与多级功能清单。若只靠通用对话,结构容易漂移,验收标准也常缺位。

下面介绍 SkillHub 社区技能「软件需求分析专家」(坐标 @user_b13835cb/requirement-analyst)。它从用户原始需求描述出发,按选定模式细化,并通过官方简介中的四阶段分析流程,输出可直接用于开发的需求文档。

这是什么

「软件需求分析专家」是 SkillHub 上分类为 dev-programming 的社区技能,版本 1.0.0,发布者为 user_b13835cb,来源标注为 community。标签 requires_api_key=false,使用时无需配置 API Key。

官方页面与 API 入口:

  • SkillHub 展示页:https://www.skillhub.cn/skills/user_b13835cb/requirement-analyst
  • 官方地址:https://api.skillhub.cn/user_b13835cb/requirement-analyst

核心功能

以下能力均来自 SkillHub 页面与已抓取简介,未展开未公开的内部提示词细节。

两种需求细化模式

  1. 敏捷模式:Epic → User Story → 验收标准。
  2. 瀑布模式:模块 → 一级功能 → 二级功能 → 三级功能 → 功能描述 → 优先级。

四阶段分析流程

技能说明采用「四阶段分析流程」组织输出,最终目标是生成可直接用于开发的需求文档(如 PRD、功能清单、用户故事与验收条目等,具体章节结构由技能在对话中按模式生成)。

触发意图

当对话中出现需求分析、需求梳理、需求拆解、写 PRD、输出需求文档、功能清单、用户故事、Epic 拆解、外包报价评估、需求细化、整理需求等意图时,Agent 可启用此技能。

安装与启用

SkillHub 提供两种方式,任选其一即可。

方式一:让 AI 按官方安装文档执行

将下面提示词发给当前使用的 AI 客户端(Cursor、Claude Code、Codex 等均可),由 Agent 读取安装说明并完成安装:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_b13835cb/requirement-analyst`。

方式二:使用 SkillHub CLI

若本机已安装 skillhub,可将技能安装到当前 Agent 识别的 skills 目录。安装文档要求必须使用 --dir,否则默认目录可能不会被客户端加载。

先检查 CLI:

command -v skillhub && skillhub --version

未安装时可按 SkillHub 安装文档执行完整安装或仅安装 CLI(见 https://skillhub.cn/install/skillhub.md)。

按客户端选择目录,例如:

客户端 skills 目录(摘自 SkillHub 安装文档)
Cursor ~/.cursor/skills/
Claude Code ~/.claude/skills/
Codex ~/.codex/skills/ 或项目下的 .agents/skills/

在 Cursor 中示例:

skillhub install user_b13835cb/requirement-analyst --dir ~/.cursor/skills/

安装后按你所用客户端的惯例重启或刷新技能列表,使新技能生效。

典型用法

官方未提供固定命令行子命令;用法是在启用技能后,用自然语言给出原始需求并标明模式或交付物类型。下面示例仅演示可复现的对话方式,输出结构以技能实际回复为准。

瀑布模式 / 功能清单

下面是我们和客户沟通的初稿,请用瀑布模式做需求细化:模块、多级功能、功能描述和优先级,输出一份给开发用的功能清单。

[粘贴原始需求描述]

敏捷模式 / 用户故事

请用敏捷模式拆解:Epic、User Story,并为每个 Story 写验收标准。

[粘贴原始需求描述]

外包报价前的范围整理

请做需求梳理和功能拆解,便于评估外包工作量;不确定的地方单独列成待确认项。

[粘贴原始需求描述]

经过上面的步骤,你应得到结构化文档草稿,再与业务方做一次评审即可进入排期或报价。

适用场景与注意

适合谁

  • 需要把模糊需求落成 PRD、功能清单或用户故事的产品、项目负责人。
  • 小型团队缺少专职需求分析师,希望用统一模板对齐 Epic、Story 或多级功能树。
  • 外包前需要可核对的功能范围与优先级列表。

使用注意

  • 技能依赖模型对原文的理解,输入越完整(角色、约束、非功能需求),细化结果越稳定;关键业务规则仍建议人工确认。
  • SkillHub 页面统计(截至资料抓取):评分 100000,下载 3346;与部分摘要线索中的数字可能不一致,以 SkillHub 页面为准。
  • 若 CLI 直链下载失败,优先使用「方式一」让 Agent 按 https://skillhub.cn/install/skillhub.md 安装,与官方页面推荐一致。

结尾

「软件需求分析专家」把敏捷与瀑布两套细化路径和四阶段流程收进一个 Skill,适合从原始描述快速拉出可开发文档骨架。需要安装或查看说明时,可打开 SkillHub 页面:https://www.skillhub.cn/skills/user_b13835cb/requirement-analyst ,或引用官方地址:https://api.skillhub.cn/user_b13835cb/requirement-analyst 。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye