用途:把用户以自然语言提出的功能描述转化为结构化功能规格说明(spec),产出并写入specs目录下的spec.md,同时生成需求质量检查清单。
主要能力:从描述中提取关键词生成2-4词的action-noun短名(如add-user-auth、fix-payment-timeout);通过git fetch --all --prune、git ls-remote --heads origin与本地分支及specs目录三处来源确定下一个可用编号,创建并切换N+1-<short-name>分支和specs/N+1-<short-name>/spec.md;填充用户场景与测试、功能需求、可度量且与技术无关的成功标准、关键实体;最多保留3处[NEEDS CLARIFICATION]并以选项表向用户确认;生成checklists/requirements.md做质量校验,最多迭代3轮。若BuildBetter上下文采集可用,会生成buildbetter-context.json、buildbetter-context.md、user-stories.md并做证据追溯,状态为ok/partial/skipped/error时分别处理。
使用方式:调用时把功能描述作为输入参数;描述为空则报错No feature description provided。模板文件参考仓库templates/,本地安装可查~/.bb-skills/templates/或项目templates/目录。完成后报告分支名、spec路径、BuildBetter产物路径与检查清单结果,供后续clarify或plan阶段使用。
限制:规格聚焦WHAT与WHY,不写技术栈、API与代码结构;不做内嵌检查清单;某章节不适用时应整段删除而非写N/A;无明确用户流程时报错Cannot determine user scenarios。关于收费、价格与支持平台,资料暂未提供。