Skip to content

MinLeeV5/devkeel / .harness/skills/brainstorming

brainstorming

Verified

探索、比较、挑战或补全开发方案;按 Lite/Full 深度组织相关问题、形成可读结论,并在用户同意持久化后维护 OpenSpec Living brainstorm。

FileKindSize
SKILL.mdskill md7.6 KB
agents/openai.yamlconfig220 B
references/living-brainstorm.mdmarkdown4.5 KB
references/openspec-context.mdmarkdown2.4 KB
scripts/openspec-status-snapshot.shexecutablescript1.1 KB
scripts/planning-state.mjsexecutablescript3.3 KB
---
name: brainstorming
description: 探索、比较、挑战或补全开发方案;按 Lite/Full 深度组织相关问题、形成可读结论,并在用户同意持久化后维护 OpenSpec Living brainstorm。
license: MIT
metadata:
  author: "devkeel"
  version: "9.2.0"
---

# Brainstorming

通过聚焦讨论形成共同设计。同一 change 的需求与技术设计只在此处发生,下游 artifacts 只投影。

## 工作状态与权限

| 状态 | 边界 |
|------|------|
| topic-only(默认) | 在会话中调查、讨论或做 Gap Check,不创建 change、不写文件;结束时输出决定、开放项、阶段与下一步 |
| change-draft | 用户显式 `/opsx:new` 或同意持久化后进入,只维护 `brainstorm.md` |

本 skill 不修改实现、不生成下游 artifacts;`/opsx:ff` 只改变节奏,不跳过未确认决定。
用户暂停时保留 D/A/O 与下一 gap,不把讨论完成表述为实现完成。

## 按需引用

普通 topic-only 无 change 线索且无需查询时,不加载以下引用:

- 定位、读取或恢复已有 change 状态(含冲突或复用查询):先读 [OpenSpec 上下文](references/openspec-context.md)。
- 准备创建、恢复持久化讨论、维护、确认或迁移 Living brainstorm:先读 [Living brainstorm](references/living-brainstorm.md)。

仅查看 change 不授权写入;已有可靠上下文可复用,不因加载引用重复查询。

## 讨论深度

深度 `lite` / `full` 控制探索范围,与工作流 schema、工作状态分别维护;切换深度不改变它们或
文档、实施、治理授权。

选择优先级:用户当前明确指定 → 当前主题已记录深度 → 已选工作流的同名默认值。均无时,明确要求
探索方向、比较方案或挑战思路用 Full,其余(包括已有方案)用 Lite。支持自然语言覆盖;仅在歧义
明显影响讨论范围时询问。首次进入或深度变化时简述深度与依据。

| 深度 | 探索与探针策略 | 收敛要求 |
|------|----------------|----------|
| Lite | 围绕当前方向补缺,按需定向调用需求或技术探针 | 当前讨论目标闭合,没有阻塞决定 |
| Full | 主动检查相关假设、替代方向与风险,完成需求和技术双探针检查 | 满足 Lite 条件,且两类检查已完成或有有效结果可复用 |

两档都须处理影响主方案或关键验收的风险,不按问题数、调用次数或篇幅衡量深度,不遍历无关维度、
制造问题或替代方案。Full 达到条件即收敛,无须先降为 Lite。

局部缺口不升级;明显扩大探索范围时,说明新证据与价值,建议切换并等待确认。用户主动切换时
立即调整,保留有效决定、调查和未解决的关键风险。

## 调查与探针

先区分用户目标、仓库事实和外部未知,查必要的约束、代码、配置、测试与 artifacts,不反问可查
事实。可靠热上下文直接复用,外部编辑、压缩或关键事实缺失时刷新。

早期想法先探索方向;已有方案按当前深度核验,不重新生成设计;成熟输入复用依据,检查完成即可
收敛。用户明确要求 brainstorm/grill 时,即使输入成熟也保持显式互动。

调用 `requirement-analysis` / `technical-design` 的 probe 模式时,传入深度、目标与边界、已有
D/A、仓库依据及探查重点,专业维度由探针负责。目标不清时先探需求,方向有依据后再深入技术。

复用探查须有可追溯结论,目标、边界、依据仍适用,且覆盖当前深度所需检查。Lite → Full 只复用
已覆盖部分,补齐尚未检查的相关假设、替代方向与风险;不每轮重跑,不以“已调用”认定完成。

探针只返回候选问题、依据与影响,不写报告、不替用户决定;无缺口时返回检查结论。合并去重后,
影响当前方向成立或关键验收的未知作为阻塞项,额外机会作为可选建议,不自动扩大范围或进入 O-*。
已有决定只因新证据揭示冲突或风险才重开。

下游投影阶段禁止调用这些探针;发现缺口时退出投影,回到 Brainstorming。

## 阶段与问题组织

| 阶段 | 条件 |
|------|------|
| 探索中 | 目标、范围、主方向仍不明确,或核心可行性缺少依据 |
| 收敛中 | 主方向有依据,仍有影响边界、行为、方案或验证的决定 |
| 可确认 | 当前讨论目标闭合、无阻塞项,且当前深度检查完成 |

topic-only 的闭合范围是目标、主要边界与下一路径;change-draft 还须满足
[完整快照确认](references/living-brainstorm.md#快照确认)。
阶段不代表用户授权;确认后记录确认状态,不再评分。

阶段或关键缺口变化时简述新证据与剩余决定,融入下文对话格式;无缺口时进入快照确认。
不重复评估,不按百分比、剩余轮数或决定数量衡量进展。

切换工作状态、范围扩大、新增依赖或假设被推翻时,按受影响缺口重评,不沿用旧结论。证据足以支持
选择即可:留待实施后执行的验证不自动成为阻塞项;可能推翻主方案的未知能力仍是核心可行性缺口,
不得留作“后续联调”。

按 `影响 × 不确定性` 选择当前主题,合并可独立回答的相关问题;真正依赖前一答案才能提出的
问题分轮处理。用户要求逐题或集中回答时沿用其偏好,不为凑题数扩展范围。

1. 先调查可查事实,承接有效决定与已授权自主范围,只将仍需用户决定的事项列入待确认。
2. 每项给出推荐答案、依据与主要代价;多个合理选项时紧凑列出并明确标注推荐项。
3. 等待必要答复;部分回答只确认对应项,未回答、沉默或推荐项默认选中均不等于确认。
4. 逐项更新决定与缺口,保留未答问题编号;仅对歧义、冲突或新增缺口补问,不持久化猜测。

无阻塞项且检查完成时收敛,不强制增加问题。

## 对话格式

使用 Markdown,标签独立成段,编号列表前留空行;“待确认”放在项目要求的独立决策区或选择控件中:

```text
**当前主题:**<需求/方案等讨论内容> · <具体主题>

**必要上下文:**<影响本轮决定的事实、已有决定及其关联>

**待确认:**

1. **<决策项>**:建议<选择>;依据<理由>;代价<关键取舍>。
```

主题切换、中断恢复时展示“当前主题”,同一主题内按需省略。上下文压成必要的一段,省略空项
和重复背景;必要时列出备选方案。业务事实未知时直接说明所需信息,不编造推荐答案。

本节闭合后用“**本节结论:**”给出连贯正文,描述已确定的行为、机制与边界,可直接用于后续文档。
只组织有效 D/A 和仓库事实,候选保持待定;章节结论随讨论更新,整体确认沿用快照流程,不逐节追加审批。

## 决定与记录

- `D-*`:用户明确确认的单项语义决定。
- `A-*`:用户明确授权 Agent 自主决定的类别,不得自行补造。
- `O-*`:阻塞问题,`CONFIRMED` 时必须为 0。
- 仓库事实:引用可定位依据,不伪装成 D/A。

topic-only 在会话中保留编号、深度与来源。目标、主要范围与职责已明确,且有跨会话恢复、交接、并行
或审计价值时,询问是否建立 change;否则继续 topic-only 或 Direct。

持久化设计须经用户明确确认完整 D/A 快照后才可交给下游入口;阶段或文件存在不代表确认。
设计语义变化须重新确认,未确认或已失效的内容不得投影;具体记录、快照与恢复步骤见上述引用。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall