mcpField
B
brainstorming

brainstorming

github.com/hjewkesAgent 工作流448 次安装36 周前更新
代码仓库

关于 brainstorming

brainstorming 是一项通过协作对话将想法整理为设计和规格的技能。它引导项目探索、逐项澄清问题、比较方案、获取设计批准,并衔接实现规划。

主要功能

  1. 01设计前探索项目背景
  2. 02一次提出一个澄清问题
  3. 03比较多种方案及其取舍
  4. 04实现前提交设计并获取批准
  5. 05编写设计文档并衔接实现计划

适用场景

  1. 01澄清新项目的需求
  2. 02实现前比较设计方案
  3. 03在开始编写代码前获取设计批准

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/hjewkes/agent-skills --skill brainstorming

安装后在 Claude Code 中输入/brainstorming确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
debugging-principles.md
detailed-process.md
tdd-principles.md
verification-principles.md

详细介绍

将构想转化为设计

概述

通过自然的协作对话,帮助将构想转化为完整的设计和规格说明。

首先了解当前项目的背景,然后一次提出一个问题,以完善构想。了解要构建的内容后,展示设计并征求用户批准。

在展示设计并获得用户批准之前,**不得**调用任何实现技能、编写任何代码、搭建任何项目骨架,或采取任何实现行动。无论项目看起来多么简单,这一要求都适用。

反模式:“这太简单了,不需要设计”

每个项目都必须遵循此流程。“简单”项目中未经审视的假设最容易造成大量无谓工作。设计可以简短,但必须展示设计并获得批准。

检查清单

必须为以下每一项创建任务,并按顺序完成:

  1. 了解项目背景 — 检查文件、文档和近期提交
  2. 提出澄清问题 — 一次一个,了解目的、限制条件和成功标准
  3. 提出 2-3 种方案 — 说明取舍并给出推荐方案
  4. 展示设计 — 根据复杂程度分节说明,包括测试策略、错误处理方案和验证标准(参见下方的质量原则),并在每个部分结束后征求用户批准
  5. 编写设计文档 — 保存到 .claude/plans/YYYY-MM-DD-<topic>-design.md 并提交
  6. 转入实现阶段 — 调用 writing-plans 技能来创建实现计划

质量原则

此技能生成的计划应在设计阶段考虑以下事项:

流程

digraph brainstorming {
    "Explore project context" [shape=box];
    "Ask clarifying questions" [shape=box];
    "Propose 2-3 approaches" [shape=box];
    "Present design sections" [shape=box];
    "User approves design?" [shape=diamond];
    "Write design doc" [shape=box];
    "Invoke writing-plans skill" [shape=doublecircle];

    "Explore project context" -> "Ask clarifying questions";
    "Ask clarifying questions" -> "Propose 2-3 approaches";
    "Propose 2-3 approaches" -> "Present design sections";
    "Present design sections" -> "User approves design?";
    "User approves design?" -> "Present design sections" [label="no, revise"];
    "User approves design?" -> "Write design doc" [label="yes"];
    "Write design doc" -> "Invoke writing-plans skill";
}

流程的终点是调用 writing-plans。 不得调用 frontend-design、mcp-builder 或任何其他实现技能。

有关详细流程步骤(提问技巧、设计展示、文档编写、关键原则),请参阅 references/detailed-process.md。

评论

支持 Markdown