mcpField
C
collaborative-ideation

collaborative-ideation

github.com/qodex-aiAgent 工作流47152 次安装42 周前更新
代码仓库

关于 collaborative-ideation

一项协作构思技能,可将初步项目想法发展为经过确认的设计和规格。它通过逐个提问、比较方案并分段评审来推进设计。

主要功能

  1. 01逐次提出一个问题以了解需求
  2. 02比较方案及其取舍
  3. 03分段确认设计内容
  4. 04整理设计文档并衔接实现

适用场景

  1. 01澄清初步项目构想
  2. 02比较架构方案
  3. 03在实现前评审设计

安装

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

$npx skills add https://github.com/qodex-ai/ai-agent-skills --skill collaborative-ideation

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

详细介绍

将想法头脑风暴为设计

概述

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

先理解当前项目背景,然后一次问一个问题来打磨想法。一旦你理解了要构建的内容,就以小段落(200-300 字)呈现设计,并在每段之后确认目前看起来是否正确。

流程

理解想法:

  • 先查看当前项目状态(文件、文档、最近的提交)
  • 一次问一个问题来打磨想法
  • 尽可能优先使用选择题,但开放性问题也可以
  • 每条消息只问一个问题 - 如果某个主题需要更多探索,就拆成多个问题
  • 专注于理解:目的、约束、成功标准

探索方案:

  • 提出 2-3 种不同方案及其取舍
  • 以对话方式呈现选项,并给出你的建议和理由
  • 先给出你推荐的选项,并解释原因

呈现设计:

  • 一旦你认为自己理解了要构建的内容,就呈现设计
  • 将其拆分为 200-300 字的段落
  • 每段之后询问目前看起来是否正确
  • 覆盖:架构、组件、数据流、错误处理、测试
  • 如果某些内容不合理,准备好回头澄清

设计之后

文档:

  • 将已验证的设计写入 docs/plans/YYYY-MM-DD-<topic>-design.md
  • 如果可用,使用 elements-of-style:writing-clearly-and-concisely 技能
  • 将设计文档提交到 git

实现(如果继续):

  • 询问:“准备好开始实现了吗?”
  • 使用 superpowers:using-git-worktrees 创建隔离工作区
  • 使用 superpowers:writing-plans 创建详细的实现计划

关键原则

  • 一次一个问题 - 不要用多个问题让人不堪重负
  • 优先选择题 - 在可能的情况下,比开放性问题更容易回答
  • 严格践行 YAGNI - 从所有设计中移除不必要的功能
  • 探索替代方案 - 在定稿前始终提出 2-3 种方案
  • 增量验证 - 分段呈现设计,并逐段验证
  • 保持灵活 - 当某些内容不合理时,回头澄清

评论

支持 Markdown