brainstorming

分类: 内容与多媒体 | 上传者: artk0de | 下载: 0 | 版本: v1.0（最新）

集思广益地讨论代码变更，同时首先从茶布中看到风险、所有权和技术债务信号，因此创造性的探索是基于受影响地区的实际状况。触发“头脑风暴 X”、“设计功能”、“重构 Y”、“让我们讨论一下”、“давай обсудим”、“как перестроить”、“что может сломаться”。不适用于没有代码区域可丰富的琐碎编辑或风格问题。包裹超能力：通过茶布风险信号丰富步骤进行头脑风暴。 --- # dinopowers: 头脑风暴 `superpowers:brainstorming` 的包装器。确保创造性探索从目标区域的真实 git 信号（热点、所有者、遗留债务）开始，而不是从对当前代码外观的假设开始。 ## 铁律 **茶抹布浓缩必须在“技能（超能力：头脑风暴）”之前调用——只要目标区域是可识别的。正确的预设选择（`hotspots`、`ownership`、`techDebt`）+正确的参数+正确的排序是这个包装器的核心价值。如果无法从用户请求中识别出任何代码区域（纯粹的概念性头脑风暴）：跳过丰富并直接调用“superpowers:brainstorming”。明确指出——不要制造一个区域。 **链接规则：**参见 [CHAINING.md](../../CHAINING.md) — 每个恐龙力量：X

更新日志: Source: GitHub https://github.com/artk0de/TeaRAGs-MCP

目录结构

当前层级: tree/main/.claude-plugin/dinopowers/skills/brainstorming/

📄 SKILL.md 8.2 KB

SKILL.md

---
name: brainstorming
description:
  Brainstorm a code change while seeing risk, ownership, and tech-debt signals
  from tea-rags first, so creative exploration is grounded in the actual state
  of the affected area. Triggers on "brainstorm X", "design feature", "refactor
  Y", "let's discuss", "давай обсудим", "как перестроить", "что может
  сломаться". NOT for trivial edits or stylistic questions with no code area to
  enrich. Wraps superpowers:brainstorming with a tea-rags risk-signal enrichment
  step.
---

# dinopowers: brainstorming

Wrapper over `superpowers:brainstorming`. Ensures creative exploration starts
from real git signals (hotspots, owners, legacy debt) of the target area — not
from assumptions about how the code looks today.

## Iron Rule

**tea-rags enrichment MUST be called BEFORE `Skill(superpowers:brainstorming)`**
— whenever the target area is identifiable. Correct preset selection
(`hotspots`, `ownership`, `techDebt`) + correct parameters + correct ordering is
the core value of this wrapper.

If no code area is identifiable from the user request (pure conceptual
brainstorming): skip enrichment and invoke `superpowers:brainstorming` directly.
State that explicitly — do not fabricate an area.

**Chaining rule:** see [CHAINING.md](../../CHAINING.md) — every dinopowers:X
redirects superpowers:X. NEVER bypass the wrapper.

**Index freshness:** see [FRESHNESS.md](../../FRESHNESS.md) — MUST run
`mcp__tea-rags__reindex_changes` if any file was edited in this session, BEFORE
the first tea-rags call.

## Step 1 — Extract target area

From the user request identify:

| Element                                        | Example                                                 |
| ---------------------------------------------- | ------------------------------------------------------- |
| **Area** — path or domain                      | `src/core/domains/ingest/**`, `auth/`, "rerank presets" |
| **Change type** — what the brainstorm is about | "new feature", "refactor", "bug-fix approach"           |
| **Scope hint** — narrower filter if mentioned  | file name, class name, symbol                           |

Compose:

- `pathPattern` for Step 2 (e.g. `**/auth/**`,
  `src/core/domains/ingest/**/chunker/**`)
- `query` — a single sentence describing the change intent

If no area is mentioned or derivable: skip to Step 4 with empty enrichment.
Report "no area identifiable — proceeding without tea-rags enrichment".

## Step 2 — Three tea-rags enrichment calls

Run these three `mcp__tea-rags__semantic_search` calls **in parallel** (same
tool call block), each with `metaOnly: true` (we want signals, not content):

| Call          | `rerank` preset | Why                                                                             |
| ------------- | --------------- | ------------------------------------------------------------------------------- |
| A — Hotspots  | `"hotspots"`    | Bug-prone zones the brainstorm must account for (high churn + recency + bugFix) |
| B — Ownership | `"ownership"`   | Knowledge silos — single-owner files that need reviewer pairing                 |
| C — Tech debt | `"techDebt"`    | Legacy zones where "just refactor it" hides cost (age + churn + bugFix)         |

Exact parameters for each call:

```
project:     <alias from list_projects — RECOMMENDED, omit path when set>
path:        <current project path — fallback when no alias is registered>
query:       <intent sentence from Step 1>
pathPattern: <pathPattern from Step 1>
rerank:      "hotspots" | "ownership" | "techDebt"
limit:       10
metaOnly:    true
```

Do NOT substitute:

| Wrong tool                           | Why wrong                                                                          |
| ------------------------------------ | ---------------------------------------------------------------------------------- |
| `mcp__tea-rags__hybrid_search`       | Preset-based reranking is tied to `semantic_search`; `hybrid` ignores risk presets |
| `mcp__tea-rags__find_similar`        | Requires an existing symbolId; brainstorm targets an area, not a known symbol      |
| `mcp__tea-rags__find_symbol`         | Returns one symbol; brainstorming needs area-wide risk distribution                |
| Running the three calls sequentially | Wastes time; they are independent — issue them in one parallel block               |

Do NOT pass:

- `metaOnly: false` — content is not needed; larger payloads slow the wrapper
- Custom `rerank` weights instead of the three named presets — loses the
  calibrated risk-assessment semantics
- `filter` on `git.ageDays` / `git.commitCount` — the presets already encode
  these signals; adding filters shrinks the result set and hides debt

If all three calls return 0 results (area is new, untouched by git): report "no
git-enriched results for pathPattern `<X>` — area is new or excluded from
indexing" and skip to Step 4 without enrichment block. Do NOT fabricate signals.

## Step 3 — Build enrichment block

From the three result sets, compose a compact block (max ~15 lines):

```
### tea-rags enrichment for <pathPattern>

**Hotspots (bug-prone):**
- <relativePath>:<startLine>-<endLine> — bugFixRate <N>, commitCount <N>, ageDays <N>
- ... (top 3)

**Knowledge silos (single live-line owner):**
- <relativePath> — <blameDominantAuthor> (<blameDominantAuthorPct>%), <commitCount> commits
- ... (top 3)

**Tech debt (legacy + churn):**
- <relativePath> — ageDays <N>, commitCount <N>, relativeChurn <X>
- ... (top 3)
```

Cap each section at 3 entries. If a file appears in multiple sections, note it
explicitly (`→ also in Hotspots`) — overlap is a strong brainstorming signal. Do
NOT paste raw JSON. Extract readable `relativePath` + 2-3 key signals per entry.

## Step 4 — Invoke superpowers:brainstorming

Invoke the `Skill` tool with `superpowers:brainstorming`. Prepend the enrichment
block from Step 3 as context. Phrase the handoff as:

> "Before exploring, note these risk signals in the target area: …<block>… Use
> them to pressure-test ideas — especially around the hotspot files.
>
> Chaining rule reminder: if your cycle would next invoke a `superpowers:Y`
> skill (writing-plans, test-driven-development, etc.), invoke the
> `dinopowers:Y` wrapper instead when one exists — see the Chaining rule section
> above."

Let `superpowers:brainstorming` run its full exploration cycle — this wrapper
does not replace it, only grounds it.

## Red Flags — STOP and restart from Step 2

- "I already know which files are hotspots here" → run Step 2 anyway; memory is
  stale
- "tea-rags is slow for 3 calls, let me do one" → three presets are different
  lenses; one call loses two of them
- Substituted `hybrid_search` / `find_similar` / `find_symbol` → redo with
  `semantic_search` + preset
- Ran the three calls sequentially → reissue as parallel (same tool block)
- Invoked `superpowers:brainstorming` first, tea-rags after as "validation" →
  wrong order, restart
- Set `metaOnly: false` to "see content" → unnecessary; restart with
  `metaOnly: true`
- Let `superpowers:brainstorming` chain into a raw `superpowers:Y` (e.g.
  `superpowers:writing-plans`) without redirecting to `dinopowers:Y` → intercept
  and invoke the wrapper instead (see Chaining rule)

## Common Mistakes

| Mistake                                                     | Reality                                                                        |
| ----------------------------------------------------------- | ------------------------------------------------------------------------------ |
| Skip tea-rags because "brainstorming is abstract"           | If the user named a code area, it's not abstract. Enrich it.                   |
| Use `rerank: "relevance"` instead of the three risk presets | Loses the point — brainstorming should see risk, not just relevance            |
| Collapse three calls into one with custom weights           | Custom weights ≠ calibrated presets; output is noisy and hard to interpret     |
| Paste raw `results[]` JSON into Step 4 handoff              | `superpowers:brainstorming` drowns in noise; extract 3 entries per lens        |
| Fabricate an area when user didn't name one                 | Explicit "no area — skipping enrichment" is honest; faked pathPattern is a lie |

登录后下载/点赞/收藏 ❤ 10 | ★ 0

brainstorming

目录结构

SKILL.md

举报内容

提示