前言¶

需求常常不在文档里，而在群聊、会议纪要和某个人的脑子里。落到开发手上时，缺的往往是同一批东西：边界在哪、异常怎么走、怎么算做完。返工也多由此而来。

下面介绍的 SkillHub Skill「需求文档助手」就是处理这一环：把模糊想法整理为范围清楚、可以验收、便于变更和交付的需求规格。

这是什么¶

「需求文档助手」是一个发布在 SkillHub 上的社区（community）Skill，坐标 @user_b4da0893/requirements-spec-cn，版本 1.0.0，发布者 user_b4da0893，分类 business-ops，当前评分 100000、下载 804、安装 0。

它面向产品功能、内部工具、自动化流程和软件改动这几类对象，做需求澄清与规格编写。不是替你写代码，而是先把要做什么写清楚。

核心功能¶

按照官方简介，它把一次需求拆成两个方向。

1、收集维度。 把目标、用户、现状、范围、业务规则、异常路径、数据、权限、非功能要求和验收标准组织成一份可追踪文档。

2、输出结果。 除规格本身外，还会输出待决问题、影响分析、实施拆分与验证计划。

另外，该 Skill 标注 requires_api_key=false，使用时不需要额外的 API Key。

安装与启用¶

抓取的官方页面没有给出具体的安装命令、目录路径或配置项，这里不做推测。可以确认的是两点：

1、它遵循通用 SKILL.md 格式，因此沿用宿主环境对 SKILL.md 的加载方式即可；
2、不需要配置 API Key。

获取 Skill 本体请访问官方地址（见文末），安装与启用方式以该页面和你的宿主环境说明为准。

典型用法¶

抓取的官方页面没有提供 CLI 示例或命令行用法，因此下面按官方简介描述的能力，给出一次需求澄清的大致流程。

1、给出模糊想法。例如「内部报销流程能不能自动化」。
2、先澄清目标、用户、现状和范围，确认哪些在本次之内、哪些明确排除。
3、补齐业务规则与异常路径：审批层级、金额阈值、驳回后怎么办、超时怎么办。
4、补齐数据、权限和非功能要求：涉及哪些字段、谁能看谁能改、响应和并发有没有约束。
5、收尾输出待决问题、影响分析、实施拆分与验证计划，并把验收标准写成可检查的条目。

上面每一步的产物，都对应官方简介中列出的那一组要素。

适用场景与注意¶

适合需要把需求落成文档、再交给开发的人：产品、需求方、内部工具负责人，以及做规格评审的一方。

注意几点。

1、它产出的是规格文档，不生成代码，也不替代与需求方的沟通；待决问题仍需要人来回答。
2、它按固定维度组织内容，如果项目已有强约定的模板或合规要求，需要人工对齐。
3、安装数与评分来自 SkillHub 页面，数据会变动，使用前以官方地址的当前值为准。

结尾¶

「需求文档助手」的价值在于把「想清楚」这一步前置成一份可追踪、可验收的规格，减少开发阶段因边界不清产生的返工。它不是万能的需求管理工具，但能把澄清维度和产出清单固定下来。

官方地址：https://api.skillhub.cn/user_b4da0893/requirements-spec-cn
SkillHub 页面：https://www.skillhub.cn/skills/user_b4da0893/requirements-spec-cn