前言¶

评审结束后通常有一件事没人愿意做：把需求讲清楚。要么在需求文档里贴几张截图，要么临时画个流程图发到群里，信息散、版本乱，不同人看到的理解也不一样。团队宣讲需要的是一个可以直接打开、边看边讲的页面，而不是一堆散落的图和文字。

下面介绍 SkillHub 上的社区 Skill「需求评审概要宣贯」，它做的事情很直接：输入一份功能设计源 Markdown，输出一个可直接在浏览器打开、用于团队宣讲的 HTML 页面。

这是什么¶

一句话定位：功能宣贯页面生成工具，把功能设计源 Markdown 变成可宣讲的 HTML 页面。

• 名称：需求评审概要宣贯
• 坐标：@user_b1e35ae8/feature-briefing
• 版本：1.0.0
• 来源：community（社区发布）
• 分类：office-efficiency
• 发布者：user_b1e35ae8
• 标签：requires_api_key=false，即不要求提供 API Key

它解决的问题是：宣讲材料从需求文档里手工摘抄、手工排版的成本，以及图表口径不一致的问题。

核心功能¶

1、读取功能设计源 Markdown，生成一个自包含的 HTML 页面，不需要再额外拼接静态资源，浏览器直接打开即可宣讲。

2、页面包含四类内容：功能流程图（UML 活动图）、状态流转图（UML 状态机图）、外部系统业务交互时序图、核心要点卡片。其中流程图、状态机图、时序图分别对应功能内部流程、对象状态变化、跨系统交互三个视角，核心要点卡片承载最重要的结论。

3、所有图表支持全屏查看和放大缩小。宣讲现场投屏时可以直接全屏，讲解细节时可以放大局部。

4、触发方式明确。当用户提到「生成功能宣贯」「宣贯页面」「宣贯图」「给团队讲解这个功能」「讲解页」「流程图宣贯」「功能介绍页面」「宣贯材料」「出一份宣贯」「生成讲解页」时，应使用本 Skill。这相当于一套关键词约定，让上层 Agent 知道什么时候该调用它。

安装与启用¶

官方页面未提供可直接核实的安装命令和配置字段，本节不列命令，避免给出未经验证的步骤。可确认的信息只有两点：

• 该 Skill 无需 API Key（标签 requires_api_key=false），调用不需要额外的密钥配置。
• 官方地址：https://api.skillhub.cn/user_b1e35ae8/feature-briefing，SkillHub 页面：https://www.skillhub.cn/skills/user_b1e35ae8/feature-briefing。

它基于通用 SKILL.md 格式，接入方式遵循对应宿主工具的 Skill 安装机制。具体的安装命令以官方页面为准。

典型用法¶

输入是一份功能设计源 Markdown，输出是一个 HTML 宣贯页面。

1、准备源文档。把功能的背景、流程、状态变化、与外部系统的交互、关键要点写进一份 Markdown 设计稿，这份文档是 Skill 的唯一输入。

2、触发生成。在对话中使用触发词，例如「出一份宣贯」或「生成讲解页」，并把功能设计源 Markdown 交给 Skill。

3、宣讲。在浏览器打开生成的 HTML 页面，按页面结构讲解：先讲功能流程图，再讲状态流转图，然后讲外部系统交互时序图，最后用核心要点卡片收尾。需要强调局部时使用放大，投屏时切换全屏。

适用场景与注意¶

适合的场景：

• 需求评审通过后，需要给团队做一次功能宣贯。
• 跨团队功能涉及多个外部系统，用时序图说明交互比文字描述更清楚。
• 需要把功能的状态流转固化下来，避免不同模块对状态口径理解不一致。

需要注意的地方：

• 源文档质量决定输出质量。流程图、状态机、时序图的内容都来自输入的 Markdown，源文档里没有写清楚的部分，页面上不会凭空出现。
• 它是一个面向 HTML 单页的工具，不负责生成可编辑的源图表，也不负责把页面回写进需求管理系统。
• 页面内容取决于输入材料，宣贯前仍需人工核对图表口径是否与最终实现一致。

结尾¶

这个 Skill 的价值在于把「宣讲材料」从零散的截图和文字，变成一份结构固定、图表齐全、可直接投屏的 HTML 页面，并且用明确的触发词降低了调用门槛。它不改变需求内容本身，只是把已有的功能设计按宣讲的动线整理出来。

官方地址：https://api.skillhub.cn/user_b1e35ae8/feature-briefing