关于 bro-give-me-spec
这是用于编写软件规格说明的技能,明确要改什么、原因及可观察的完成条件,但不规定实现方式。它会与用户澄清歧义,并根据可用工具选择相应工作流。
主要功能
- 01定义目标与可观察的验收标准
- 02区分预期结果与实现方式
- 03与用户澄清产品歧义
- 04根据可用工具选择工作流
适用场景
- 01在实现前编写功能规格
- 02明确变更范围与预期结果
- 03为变更定义验收标准
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ irpsv/ ai-bro --skill bro-give-me-spec安装后在 Claude Code 中输入/bro-give-me-spec确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
evals/trigger-evals.jsonreferences/dialog-rules.mdspec-review.mdspec-template.mdsubagent-model-tiers.mdreferences/workflows/create-plan.mdfile-spec.mdsubagents/closer-prompt.md详细介绍
Bro Give Me Spec
你的任务是创建一份结果规格说明:明确记录要改变什么以及为什么要改变,并说明结果满足哪些可观察条件才算完成,但不定义实现方式。 不要写代码,也不要编写实现步骤。
通用规则
- 必须遵守对话规则!
- 必须遵守且不得违反工作流程!
- 规格说明必须明确无歧义,不得有变体或未解决的问题。产品方面的歧义必须与相关人员一同解决。
- 验收标准必须用可观察的陈述覆盖目标结果。验收标准中不得说明检查方式(自动化测试、人工检查、构建等)。
- 规格说明不规定测试编写和实现的先后顺序,也不要求采用 TDD。
限制 / 停止
- 禁止在规格说明中添加步骤、阶段、执行者任务、选定的解决方案架构、代码、diff、补丁、伪代码,以及关于要创建或修改哪些文件的指示。现有路径、类型和方法可以作为当前状态的锚点,出现在“任务与背景”和“目标结果”中,但不得作为修改方案。
- 禁止添加超出模板结构的章节。仅在已有明确约定时,才允许添加
已做出的决定章节。 - 禁止编造事实或标准。规格说明准备就绪前,必须解决有关结果、范围或验收的歧义。
- 禁止在相关人员未明确指定路径前写入规格说明文件。当前请求中指定的路径即视为已回答——不要重复询问。如果指定路径下的文件已存在,未经明确批准,禁止更新该文件。
- 如果有可用的
CreatePlan(或同类工具),禁止询问文件存放路径,也禁止自行编写规格说明文件来替代调用该工具。 - 禁止提议后续制定实现计划或使用
/bro-give-me-plan。 - 规格说明完成且评审通过后,只提示一个后续步骤:
/bro-do-it。不要提供后续步骤选项菜单。
工作流程
- 收集代码和上下文信息,以便明确描述当前状态、目标结果、范围和验证标准。
- 询问相关人员缺失的信息。必须遵守对话规则。必要时将已确定的选项整理到
已做出的决定章节。 - 检查目标结果中的每个变更场景是否都有对应的验收标准,并确认每项标准都可观察,且未描述验证方式。
- 根据工作流程判定规则确定要使用的工作流程。
- 加载所选工作流程的说明文件。遵守所选工作流程中的所有说明。
工作流程判定规则
以下规则说明如何确定要使用的工作流程。 在选定工作流程前,不要阅读说明文件。 根据判定标准选择工作流程。
create-plan
满足以下条件时使用:
- 当前会话中有可用的
CreatePlan工具(或同类计划创建框架)
选择此工作流程时,不要询问文件存放路径。
说明文件:create-plan
file-spec
满足以下条件时使用:
CreatePlan(或同类工具)不可用
说明文件:file-spec
评论
支持 Markdown