前言¶

做小程序的人常遇到这类情况：需求方给了一句「做一个会员积分签到小程序」，开发接手后才发现要补的东西很多——有哪些页面、每个页面有哪些字段、接口怎么约定、状态怎么流转、异常怎么处理、最后怎么验收。把这些从零整理一遍，往往比写代码还费时间。

下面介绍一个 Skill：小程序需求拆解器 · 一句话变开发文档。它由 SkillHub 社区发布者 user_8ee65e73 维护，作用是把一句自然语言需求，拆成可以交给开发的小程序规格文档。

这是什么¶

小程序需求拆解器 · 一句话变开发文档是一个基于通用 SKILL.md 格式的 Agent Skill，坐标 @user_8ee65e73/miniapp-spec-breaker，当前版本 1.3.0，来源标记为 community，分类 dev-programming，标签 requires_api_key=false，即不需要 API Key。

它解决的问题是：把一句话需求转成可开发的小程序规格，覆盖页面、字段、接口、状态与异常。交付物包括需求文档、页面清单、字段定义、接口约定、状态机。

需要注意边界：按官方简介，它不用于原生 App 与后端服务实现，只面向小程序侧的规格拆解。

核心功能¶

按官方简介，这个 Skill 覆盖以下能力：

• 小程序需求拆解
• 一句话变开发文档
• 功能清单梳理
• 原型草图
• 页面跳转逻辑
• 接口字段定义
• 验收标准生成
• 微信云开发方案

交付物分五类：需求文档、页面清单、字段定义、接口约定、状态机。从能力命名看，它同时照顾了前端页面结构（页面、跳转、原型）和数据侧约定（字段、接口、状态机），并附带验收标准与微信云开发方案。

安装与启用¶

官方资料中没有提供安装命令、目录约定或配置文件字段。按任务要求核实不到的部分不写，这里如实说明：需要安装方式与启用步骤的用户，请到官方页面核对后再操作，不要依据推测执行命令。

标签 requires_api_key=false 只说明该 Skill 不需要 API Key，不代表它已经配置好。

典型用法¶

官方资料给出的输入是一句自然语言需求，例如「做一个会员积分签到小程序」这类一句话描述。实际使用时，把需求交给 Agent 并触发该 Skill，由它在对话中完成拆解。

官方资料没有提供可复现的输入样例、输出样例或命令行示例，因此这里不构造具体案例。可以确认的是输出方向：需求文档、页面清单、字段定义、接口约定、状态机，以及原型草图、页面跳转逻辑、接口字段定义、验收标准和微信云开发方案。

适用场景与注意¶

适合的场景是小程序项目在动手开发前，需要把模糊需求转成结构化规格的团队或个人。尤其是一句话需求、需要梳理功能清单和验收标准的场合。

限制与坑有三点。

1、只做规格拆解，不做原生 App 与后端服务实现。如果项目含原生客户端或独立后端服务，这个 Skill 覆盖不到。
2、产出是文档与约定，不是代码。它给出的接口字段定义、状态机等内容，需要开发按实际情况校对后再落地。
3、输入质量决定输出质量。一句话需求如果缺少关键约束，拆出的规格会有多处需要回填。

结尾¶

这个 Skill 的价值在于把「从一句话到开发文档」这一步标准化，减少需求整理阶段的重复沟通。它不做代码生成，也不越界到原生 App 和后端服务。

官方地址：https://api.skillhub.cn/user_8ee65e73/miniapp-spec-breaker
SkillHub 页面：https://www.skillhub.cn/skills/user_8ee65e73/miniapp-spec-breaker