A skill your agent uses when 用户要创建新功能、构建组件、添加功能或修改行为等任何创作性工作之前。必须在实施任何方案前先触发本技能。触发场景:头脑风暴、方案设计、需求分析、功能规划、设计方案、系统设计、我想做、帮我想想、如何实现、方案评估、设计评审。

MITAuto-check passedAgent Workflows

Install Brainstorming

skills CLI
$ npx skills add ProgrammerAnthony/Expert-Coding-Harness --skill brainstorming -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ProgrammerAnthony/Expert-Coding-Harness brainstorming --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ProgrammerAnthony/Expert-Coding-Harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/brainstorming .claude/skills/brainstorming && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
brainstorming
GitHub stars
235
Token cost
~732 tokens
SKILL.md length
164 words
Files
3 (incl. references)
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when 用户要创建新功能、构建组件、添加功能或修改行为等任何创作性工作之前。必须在实施任何方案前先触发本技能。触发场景:头脑风暴、方案设计、需求分析、功能规划、设计方案、系统设计、我想做、帮我想想、如何实现、方案评估、设计评审。

  • Works in 9 steps: 探索项目上下文 — 检查文件、文档、最近的提交 → 评估范围 — 判断是否需要拆分为多个子项目 → 澄清问题 — 每次一个问题,理解目的/约束/成功标准 → …
  • 用户要创建新功能、构建组件、添加功能或修改行为等任何创作性工作之前。必须在实施任何方案前先触发本技能。触发场景:头脑风暴、方案设计、需求分析、功能规划、设计方案、系统设计、我想做、帮我想想、如何实现、方案评估、设计评审
  • SKILL.md covers Inputs / Outputs / Gates /…, 反模式:"这太简单了,不需要设计", 工作流 and 流程详解, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Brainstorming is an agent skill from ProgrammerAnthony/Expert-Coding-Harness. Use when 用户要创建新功能、构建组件、添加功能或修改行为等任何创作性工作之前。必须在实施任何方案前先触发本技能。触发场景:头脑风暴、方案设计、需求分析、功能规划、设计方案、系统设计、我想做、帮我想想、如何实现、方案评估、设计评审。

Its SKILL.md is about 730 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `README.md` and `references/spec-reviewer-prompt.md`).

It sits in Agent Workflows, covering Brainstorming. The repository describes itself as: 生产级 AI Agent 技能集,辅助AI Harness应用于企业开发,覆盖代码审查、代码安全审计、TDD、需求工程、实施计划与子代理编排、架构设计、调试、前端开发与技能创建全流程。 The licence is MIT.

When your agent uses it

  • 用户要创建新功能、构建组件、添加功能或修改行为等任何创作性工作之前。必须在实施任何方案前先触发本技能。触发场景:头脑风暴、方案设计、需求分析、功能规划、设计方案、系统设计、我想做、帮我想想、如何实现、方案评估、设计评审
  • Tasks that involve Brainstorming

Example prompts

  • “/brainstorming”

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. 探索项目上下文 — 检查文件、文档、最近的提交
  2. 评估范围 — 判断是否需要拆分为多个子项目
  3. 澄清问题 — 每次一个问题,理解目的/约束/成功标准
  4. 提出 2-3 个方案 — 带权衡分析,给出推荐
  5. 分节展示设计 — 每节获得用户确认后再继续
  6. 编写设计文档 — 保存到 docs/specs/YYYY-MM-DD-<主题>-设计.md
  7. 文档自检循环 — 派发文档审查子代理(见 references/spec-reviewer-prompt.md),发现问题则修复后重新审查(最多 3 轮,超出则交人工处理)
  8. 等待用户审阅 — 请用户在继续前审阅设计文档
  9. 转入实施规划 — 调用实施计划技能(如有)

What it can do on your machine

Read from SKILL.md and the folder at commit ab0b827. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Brainstorming loads about 732 tokens when it runs, and up to ~1.1k if it reads all its reference files. Until then it costs about 33 tokens; SKILL.md has 164 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~732
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ProgrammerAnthony/Expert-Coding-Harness at commit ab0b827, republished under its MIT licence (© ProgrammerAnthony). 164 words, ~732 tokens.

Download SKILL.mdSave it as .claude/skills/brainstorming/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
brainstorming
description
Use when 用户要创建新功能、构建组件、添加功能或修改行为等任何创作性工作之前。必须在实施任何方案前先触发本技能。触发场景:头脑风暴、方案设计、需求分析、功能规划、设计方案、系统设计、我想做、帮我想想、如何实现、方案评估、设计评审。

方案设计师

铁律:先设计,后实施。 在充分理解需求并获得用户认可前,禁止编写任何代码或启动任何实施动作。

<HARD-GATE>
在完成设计展示并获得用户明确批准之前,禁止调用任何实施技能、编写代码、脚手架项目或执行任何实施动作。无论项目看起来多简单,都必须如此。
</HARD-GATE>

Inputs / Outputs / Gates / Handoffs(统一契约)

  • Inputs(最小输入):用户目标(要解决什么问题);约束(时间/技术/合规/成本);成功标准(如何验收);现有系统线索(仓库/模块/接口,如有)。
  • Outputs(产物形态):一份经用户确认的设计/规格说明文档(建议写入 docs/specs/YYYY-MM-DD-<主题>-设计.md)。
  • Gates(继续前必须满足):
    • 设计展示并获得用户明确批准前,禁止进入实施(保持与本文件 HARD-GATE 一致)。
    • 每次最多问 1 个关键问题,避免一次性轰炸用户。
  • Handoffs(推荐下游):
    • writing-plans(实施计划编写):把设计变成可执行计划
    • prd-engineer(需求工程师):当需要 PRD / 验收标准 / Issues 拆解时先补齐

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

所有项目都必须走这个流程——待办清单、单函数工具、配置变更,全部如此。"简单"项目恰恰是未经审视的假设造成最多返工的地方。设计可以很短(对于真正简单的项目几句话就够),但你必须展示设计并获得确认。


工作流

检查清单(按序完成,每项创建一个 Todo 任务)
  1. 探索项目上下文 — 检查文件、文档、最近的提交
  2. 评估范围 — 判断是否需要拆分为多个子项目
  3. 澄清问题 — 每次一个问题,理解目的/约束/成功标准
  4. 提出 2-3 个方案 — 带权衡分析,给出推荐
  5. 分节展示设计 — 每节获得用户确认后再继续
  6. 编写设计文档 — 保存到 docs/specs/YYYY-MM-DD-<主题>-设计.md
  7. 文档自检循环 — 派发文档审查子代理(见 references/spec-reviewer-prompt.md),发现问题则修复后重新审查(最多 3 轮,超出则交人工处理)
  8. 等待用户审阅 — 请用户在继续前审阅设计文档
  9. 转入实施规划 — 调用实施计划技能(如有)

流程详解

第一步:理解想法
  • 先检查当前项目状态(文件、文档、最近提交),再提问
  • 先评估范围:如果请求涵盖多个独立子系统,立即指出,不要在细节上浪费提问次数
  • 如果项目过大,帮助用户拆分子项目:各部分是什么、如何关联、构建顺序如何?然后对第一个子项目走完整设计流程
  • 对范围合适的项目,每次只问一个问题逐步澄清需求
  • 优先使用选择题,比开放式问题更容易回答
  • 聚焦于:目的、约束、成功标准
第二步:探索方案
  • 提出 2-3 个不同方案及其权衡
  • 用对话方式呈现选项,说明推荐及理由
  • 以推荐方案开头并解释选择原因
第三步:展示设计
  • 一旦充分理解要构建什么,就展示设计
  • 每节根据复杂度调整篇幅:简单的几句话,复杂的不超过 200-300 字
  • 每节展示后询问是否符合预期,再继续
  • 覆盖:架构、核心组件、数据流、错误处理、测试策略
  • 如有不清楚的地方随时回头澄清
第四步:设计隔离与清晰度
  • 将系统拆分为更小的单元,每个单元有单一职责、清晰接口,可独立理解和测试
  • 对每个单元应能回答:它做什么、如何使用、依赖什么
  • 判断标准:不看内部实现能否理解这个单元?修改内部实现是否会破坏使用方?否则需要重新划分边界
  • 更小、边界更清晰的单元也更容易让 AI 工作——上下文能容纳的代码越少越好,文件过大往往是做了太多事情的信号
第五步:在已有代码库中工作
  • 提出变更前先探索现有结构,遵循已有模式
  • 如果现有代码有影响当前工作的问题(文件过大、边界不清、职责混乱),将针对性改进纳入设计——就像优秀开发者改进他们正在接触的代码一样
  • 不要提议无关的重构,专注于服务当前目标

设计文档

设计通过验证后:

  • 将设计(规格说明)写入 docs/specs/YYYY-MM-DD-<主题>-设计.md
    • (用户偏好的路径优先)
  • 提交到 git
文档自检循环

写完文档后:

  1. 派发文档审查子代理(见 references/spec-reviewer-prompt.md)
  2. 如有问题:修复后重新派发,直到通过
  3. 如果循环超过 3 轮,交人工处理
用户审阅门控

自检循环通过后,请用户审阅:

"设计文档已写入 <路径>。请审阅,如需修改请告知,确认后我们开始编写实施计划。"

等待用户回复。如有修改需求,执行后重跑自检循环。用户确认后才能继续。


关键原则

原则说明
每次一个问题不要用多个问题淹没用户
优先选择题比开放式问题更容易回答
无情地 YAGNI从所有设计中去掉不必要的功能
探索替代方案在确定方案前始终提出 2-3 个选项
渐进式验证展示设计,获得批准后再继续
保持灵活有不清楚的地方随时回头澄清

警告:当你想跳过设计时

遇到以下想法,立刻停下——先完成设计流程:

借口现实
"需求很清楚,直接写代码"清楚的需求 ≠ 明确的约束与边界。少 2 分钟问题 = 多 2 小时返工。
"太简单了不需要设计"简单项目里未审视的假设造成最多浪费。设计可以很短,但不能没有。
"用户肯定想要这个功能""肯定"不是确认。问清楚。
"我已经知道该怎么做了"你知道怎么做 ≠ 用户想要你那样做。先对齐。
"只是一个小改动"小改动也会破坏接口、引入回归、违背用户预期。走流程。

参考资源

  • references/spec-reviewer-prompt.md — 文档审查子代理提示词模板

© ProgrammerAnthony, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/brainstorming of ProgrammerAnthony/Expert-Coding-Harness.

  • SKILL.md
  • README.md
  • references/spec-reviewer-prompt.md

Open the folder on GitHubat commit ab0b827

Compare with similar skills

Brainstorming next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Brainstorming compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brainstorming this skillProgrammerAnthony/Expert-Coding-Harness235—~732Automated safety check: PassMIT
Brainstormingxpinjection/test-driven-spring-boot11254 repos~2.6kAutomated safety check: PassMIT
LLM Councilgcpdev/llm-council-skill4611 repos~1kAutomated safety check: NotesMIT
Typesafe AIOpenAgentsInc/openagents4559 repos~2.5kAutomated safety check: PassMIT
Yao Meta Skillyaojingang/yao-meta-skill2.7k—~768Automated safety check: PassMIT
Trellis StartROYIANS/foliq-print-template-designer1356 repos~646Automated safety check: PassMIT

Similar skills

  • Brainstorming

    xpinjection/test-driven-spring-boot

    You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior.

    112 GitHub starsUsed in 54 repos~2.6k tokens
    Agent WorkflowsAuto-check passed
  • LLM Council

    gcpdev/llm-council-skill

    Multi-LLM collaborative brainstorming and planning. An agent skill from gcpdev/llm-council-skill.

    461 GitHub starsUsed in 1 repo~1k tokens
    Agent WorkflowsAuto-check: notes
  • Typesafe AI

    OpenAgentsInc/openagents

    Build AI-powered software with TypeSafe: small units of AI intelligence you can use like programming primitives.

    455 GitHub starsUsed in 9 repos~2.5k tokens
    Agent WorkflowsAuto-check passed
  • Yao Meta Skill

    yaojingang/yao-meta-skill

    Create, improve, or evaluate an existing skill from workflows, prompts, SOPs, scripts.

    2.7k GitHub stars~768 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Trellis Start

    ROYIANS/foliq-print-template-designer

    Initializes an AI development session by reading workflow guides, developer identity, git status, active tasks, and project guidelines from .trellis/.

    135 GitHub starsUsed in 6 repos~646 tokens
    Agent WorkflowsAuto-check passed
  • Brainstorming Before Building

    jnMetaCode/superpowers-zh

    Turns a rough idea into an approved design before any code is written, sorting the request into spike, bounded or architectural and enforcing an approval gate.

    8.3k GitHub stars~1.8k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed

More from ProgrammerAnthony/Expert-Coding-Harness

All 23 skills in this repo
  • Architecture Advisor

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户需要设计新系统架构、评审或优化已有系统架构、选择技术方案时。触发场景:架构分析、架构设计、系统设计、architecture、架构优化、系统架构、架构评审、架构咨询、技术方案、技术设计、如何组织代码结构、模块划分、服务拆分、数据库选型、微服务设计。

    235 GitHub stars~673 tokensUpdated 4 mo ago
    Auto-check passed
  • Code Review Expert

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户要求审查代码、评估代码质量、提交 PR 前检查、发现代码有潜在问题时。触发场景:代码审查、code review、审查代码、review、检查代码、代码检查、代码质量、代码评审、这段代码有问题吗、帮我看看代码、合并前检查。

    235 GitHub stars~806 tokensUpdated 4 mo ago
    Auto-check passed
  • Code Security Audit

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户需要对代码进行安全审计、发现安全漏洞、上线前安全评估、检查代码是否存在安全风险时。触发场景:代码安全审计、安全审计、白盒审计、安全扫描、漏洞检测、漏洞挖掘、SQL注入、命令注入、XSS、SSRF、反序列化、认证绕过、越权、代码安全检查、security audit、code…

    235 GitHub stars~1.6k tokensUpdated 4 mo ago
    Auto-check passed
  • Debug Expert

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 程序出现错误、异常、崩溃,或行为与预期不符,或测试失败,或无法定位问题根因时。触发场景:调试、debug、报错、错误、异常、bug、问题排查、故障排查、不工作、崩溃、无法运行、出错了、为什么不生效、运行报错、跑不起来、程序挂了。

    235 GitHub stars~986 tokensUpdated 4 mo ago
    Auto-check passed
  • Frontend Code Review

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户需要审查前端代码(React/Vue/Next.js/TypeScript/Tailwind等)、检查代码质量、性能问题、可维护性、安全漏洞、最佳实践落地时。触发场景:前端代码评审、前端代码优化、React/Vue代码检查、TypeScript代码审查、前端性能优化、前端安全审计、前端代码规范检查。

    235 GitHub stars~614 tokensUpdated 4 mo ago
    Auto-check passed
  • Frontend Performance Optimization

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户需要优化前端性能、提升页面加载速度、减少白屏时间、优化交互流畅度、进行性能排查时。触发场景:前端性能优化、页面加载慢、白屏时间长、卡顿、LCP/FID/CLS指标优化、前端性能分析、打包体积优化。

    235 GitHub stars~701 tokensUpdated 4 mo ago
    Auto-check passed

Categories

Questions about Brainstorming

What does Brainstorming do?

A skill your agent uses when 用户要创建新功能、构建组件、添加功能或修改行为等任何创作性工作之前。必须在实施任何方案前先触发本技能。触发场景:头脑风暴、方案设计、需求分析、功能规划、设计方案、系统设计、我想做、帮我想想、如何实现、方案评估、设计评审。. Brainstorming is an agent skill from ProgrammerAnthony/Expert-Coding-Harness.

When should I use Brainstorming?

Brainstorming fits situations like: 用户要创建新功能、构建组件、添加功能或修改行为等任何创作性工作之前。必须在实施任何方案前先触发本技能。触发场景:头脑风暴、方案设计、需求分析、功能规划、设计方案、系统设计、我想做、帮我想想、如何实现、方案评估、设计评审; tasks that involve Brainstorming.

How do I install Brainstorming in Claude Code?

Run `npx skills add ProgrammerAnthony/Expert-Coding-Harness --skill brainstorming -a claude-code`. Or copy the skill folder (skills/brainstorming in ProgrammerAnthony/Expert-Coding-Harness) into .claude/skills/brainstorming in your project. Claude Code loads it when a task matches its description.

How do I install Brainstorming in Codex?

Run `npx skills add ProgrammerAnthony/Expert-Coding-Harness --skill brainstorming -a codex`. Or copy the skill folder (skills/brainstorming in ProgrammerAnthony/Expert-Coding-Harness) into .agents/skills/brainstorming in your project. Codex loads it when a task matches its description.

Can I use Brainstorming in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ProgrammerAnthony/Expert-Coding-Harness --skill brainstorming -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brainstorming, .gemini/skills/brainstorming, .github/skills/brainstorming and .opencode/skills/brainstorming in your project.

What does Brainstorming need to run?

SKILL.md names no scripts, command-line tools or credentials: Brainstorming is instructions for the agent only.

Does Brainstorming access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Brainstorming safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Brainstorming use?

Brainstorming is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Brainstorming use?

About 732 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 396 tokens, read only when the agent opens those files.

What are the alternatives to Brainstorming?

Skills that share tags, products or a category with Brainstorming: Brainstorming (xpinjection/test-driven-spring-boot, 112 stars), LLM Council (gcpdev/llm-council-skill, 461 stars), Typesafe AI (OpenAgentsInc/openagents, 455 stars) and Yao Meta Skill (yaojingang/yao-meta-skill, 2.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brainstorming?

ProgrammerAnthony (a GitHub user) maintains it in ProgrammerAnthony/Expert-Coding-Harness, which has 235 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on May 11, 2026.

Source: ProgrammerAnthony/Expert-Coding-Harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.