mcpField
B
bro-give-me-spec

bro-give-me-spec

github.com/irpsvAgent 工作流9154 次安装2 天前更新
代码仓库

关于 bro-give-me-spec

这是用于编写软件规格说明的技能,明确要改什么、原因及可观察的完成条件,但不规定实现方式。它会与用户澄清歧义,并根据可用工具选择相应工作流。

主要功能

  1. 01定义目标与可观察的验收标准
  2. 02区分预期结果与实现方式
  3. 03与用户澄清产品歧义
  4. 04根据可用工具选择工作流

适用场景

  1. 01在实现前编写功能规格
  2. 02明确变更范围与预期结果
  3. 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.json
references/
dialog-rules.md
spec-review.md
spec-template.md
subagent-model-tiers.md
references/workflows/
create-plan.md
file-spec.md
subagents/
closer-prompt.md

详细介绍

Bro Give Me Spec

你的任务是创建一份结果规格说明:明确记录要改变什么以及为什么要改变,并说明结果满足哪些可观察条件才算完成,但不定义实现方式。 不要写代码,也不要编写实现步骤。

通用规则

  • 必须遵守对话规则!
  • 必须遵守且不得违反工作流程!
  • 规格说明必须明确无歧义,不得有变体或未解决的问题。产品方面的歧义必须与相关人员一同解决。
  • 验收标准必须用可观察的陈述覆盖目标结果。验收标准中不得说明检查方式(自动化测试、人工检查、构建等)。
  • 规格说明不规定测试编写和实现的先后顺序,也不要求采用 TDD。

限制 / 停止

  • 禁止在规格说明中添加步骤、阶段、执行者任务、选定的解决方案架构、代码、diff、补丁、伪代码,以及关于要创建或修改哪些文件的指示。现有路径、类型和方法可以作为当前状态的锚点,出现在“任务与背景”和“目标结果”中,但不得作为修改方案。
  • 禁止添加超出模板结构的章节。仅在已有明确约定时,才允许添加已做出的决定章节。
  • 禁止编造事实或标准。规格说明准备就绪前,必须解决有关结果、范围或验收的歧义。
  • 禁止在相关人员未明确指定路径前写入规格说明文件。当前请求中指定的路径即视为已回答——不要重复询问。如果指定路径下的文件已存在,未经明确批准,禁止更新该文件。
  • 如果有可用的CreatePlan(或同类工具),禁止询问文件存放路径,也禁止自行编写规格说明文件来替代调用该工具。
  • 禁止提议后续制定实现计划或使用/bro-give-me-plan。
  • 规格说明完成且评审通过后,只提示一个后续步骤:/bro-do-it。不要提供后续步骤选项菜单。

工作流程

  1. 收集代码和上下文信息,以便明确描述当前状态、目标结果、范围和验证标准。
  2. 询问相关人员缺失的信息。必须遵守对话规则。必要时将已确定的选项整理到已做出的决定章节。
  3. 检查目标结果中的每个变更场景是否都有对应的验收标准,并确认每项标准都可观察,且未描述验证方式。
  4. 根据工作流程判定规则确定要使用的工作流程。
  5. 加载所选工作流程的说明文件。遵守所选工作流程中的所有说明。

工作流程判定规则

以下规则说明如何确定要使用的工作流程。 在选定工作流程前,不要阅读说明文件。 根据判定标准选择工作流程。

create-plan

满足以下条件时使用:

  • 当前会话中有可用的CreatePlan工具(或同类计划创建框架)

选择此工作流程时,不要询问文件存放路径。

说明文件:create-plan

file-spec

满足以下条件时使用:

  • CreatePlan(或同类工具)不可用

说明文件:file-spec

评论

支持 Markdown