头脑风暴技能，在实现前探索用户意图、需求和设计，防止返工
npx skills add https://github.com/konglong87/enjoy_harness_ai --skill harness-brainstorm复制此命令并粘贴到 Claude Code 中以安装该技能
EnjoyHarness 唯一强制入口，初始化全局状态、文件体系、技能注册表
配置文件读取和验证技能，确保用户配置正确且完整
全流程自动执行超级组合技能，编排所有16个基础技能，从用户需求到完整交付的全自动化流程
实施计划执行技能，逐任务执行实施计划，支持检查点、错误恢复和进度跟踪
10倍产能提效超级组合技能，通过并行执行、智能调度、优化策略实现10倍开发效率提升
构建≤60行的核心规则清单，从源头避免Agent行为跑偏
| name | harness-brainstorm |
| description | 头脑风暴技能，在实现前探索用户意图、需求和设计，防止返工 |
| trigger_words | ["harness-brainstorm","头脑风暴","brainstorm","设计讨论","需求澄清"] |
| priority | MEDIUM |
| dependencies | ["harness-init"] |
| version | v3.0.0 |
.EnjoyHarness/CONFIG.md，决定头脑风暴是否需要用户参与使用 Read 工具读取：.EnjoyHarness/SKILL_REGISTRY.md
检查条件：
如果未完成：
❌ 错误: 系统未初始化
💡 请先运行: harness-init
使用 Bash 工具执行：
# 查看项目结构
ls -la
# 查看关键文档
cat README.md CLAUDE.md EnjoyHarness_MANIFEST.md 2>/dev/null | head -100
# 查看最近提交
git log --oneline -10
# 查看当前分支状态
git status
目的：
使用 Read 工具读取：.EnjoyHarness/CONFIG.md
读取字段：
brainstorm_user_participation: {true|false}
规则：
falsefalse：保持现状，走全自动 brainstorm 模式true：允许用户参与需求头脑风暴；完成一次最终确认后立即切回自治执行当 brainstorm_user_participation: false 或未配置时：
harness-goal 产物、README、现有代码和约束自动推断需求细节.EnjoyHarness/EXECUTION_CONTRACT.mdconfirmation_source 记为 harness-brainstorm-autonomous当 brainstorm_user_participation: true 时：
confirmation_source 记为 harness-brainstorm-user协作模式强制规则：一次只问一个问题
自治边界规则：
brainstorm_user_participation: true 时，才允许用户参与需求表达、澄清和头脑风暴。协作模式的问题类型：
协作模式的问题格式示例：
🎯 问题1: 这个功能的主要目的是什么？
A) 解决性能瓶颈
B) 添加新功能
C) 重构现有代码
D) 其他（请说明）
💡 提示：选择最符合你需求的选项，或提供自定义答案
当收集足够信息后，提出方案：
## 方案对比
### 方案A: [方案名称]（推荐）
**优点**：
- 优点1
- 优点2
**缺点**：
- 缺点1
**适用场景**：场景描述
### 方案B: [方案名称]
**优点**：
- 优点1
**缺点**：
- 缺点1
- 缺点2
### 方案C: [方案名称]
（如果有第三个方案）
---
**推荐方案A的理由**：
- 理由1
- 理由2
在全自动 brainstorm 模式下，必须额外输出：
设计文档结构：
# [功能名称] 设计文档
## 概述
（一句话描述）
## 架构设计
（分层架构图、组件关系）
## 核心组件
（每个组件的职责）
## 数据流
（数据如何流转）
## 错误处理
（如何处理错误）
## 测试策略
（如何测试）
最终确认 / 冻结流程：
brainstorm_user_participation: true
brainstorm_user_participation: false
.EnjoyHarness/EXECUTION_CONTRACT.md使用 Write 工具创建文件：docs/plans/{YYYY-MM-DD}-{topic}-design.md
文件命名示例：
docs/plans/2026-03-28-user-auth-design.mddocs/plans/2026-03-28-payment-integration-design.md内容结构：
---
created: {TIMESTAMP}
status: draft
version: v1.0.0
---
# [功能名称] 设计文档
## 背景
（为什么需要这个功能）
## 目标
（SMART目标）
## 方案概述
（选定的方案及其理由）
## 架构设计
（详细架构）
## 组件设计
（每个组件的详细设计）
## 数据模型
（数据结构和关系）
## API设计
（接口定义）
## 错误处理
（错误处理策略）
## 测试策略
（测试计划）
## 风险与缓解
（识别的风险及缓解措施）
## 实施计划
（后续实施步骤，由harness-plan细化）
使用 Edit 工具更新：.EnjoyHarness/EXECUTION_CONTRACT.md
将以下字段写入或更新为：
mode: autonomous_after_confirmation
requirements_confirmed: true
brainstorm_user_participation: {true|false}
confirmation_source: {harness-brainstorm-user|harness-brainstorm-autonomous}
execution_mode: parallel_session
resume_policy: auto_continue
retry_policy: retry_3_then_recover
human_escalation_policy: true_blockers_only
说明：
brainstorm_user_participation: false 时，代表用户选择了全自动 brainstorm，不再需要额外确认。brainstorm_user_participation: true 时，代表用户参与只发生在 brainstorm 阶段，之后自动切回无人值守。使用 Bash 工具执行：
git add docs/plans/{YYYY-MM-DD}-{topic}-design.md
git commit -m "docs: add {topic} design document
- Add design document for {feature name}
- Cover architecture, components, data model
- Include error handling and testing strategy
- Generated by harness-brainstorm"
使用 Edit 工具追加到：.EnjoyHarness/EVENT_LOG.md
事件内容：
{TIMESTAMP} | SKILL_COMPLETE | harness-brainstorm | 设计文档完成 - {topic} | SUCCESS
{TIMESTAMP} | TRIGGER_DOWNSTREAM | harness-plan | 触发计划编写 | PENDING
使用 Bash 工具输出：
echo ""
echo "✅ harness-brainstorm 完成!"
echo ""
echo "📋 设计文档:"
echo " - 文件: docs/plans/{YYYY-MM-DD}-{topic}-design.md"
echo " - 状态: 已提交"
echo ""
echo "🎯 下一步:"
echo " - 运行 harness-plan 创建实施计划"
echo " - 或使用 harness-auto-full-execution 自动执行全流程"
echo ""
.EnjoyHarness/EXECUTION_CONTRACT.md 已冻结为自治模式harness-escalate-to-humanharness-escalate-to-human设计文档必须包含以下部分：
brainstorm_user_participation: true，则默认不进入用户参与式 brainstorm错误观念："这个功能很简单，不需要设计"
正确做法：每个项目都经过头脑风暴流程。即使是单个函数、配置修改，也需要设计。设计可以很简短；在自治模式下可直接冻结，在协作模式下再由用户做一次最终确认。
原因：
本技能执行预计迭代次数：约 15-20 次
Step 1: 探索项目
ls -la
# 发现是Go项目，已有用户模型
cat CLAUDE.md
# 了解项目架构约束
git log --oneline -5
# 看到最近在重构认证模块
Step 2-3: 逐一提问
🎯 问题1: 用户认证的主要目的是什么？
A) 替换现有的认证系统
B) 添加新的认证方式（如OAuth）
C) 增强现有认证的安全性
D) 其他
用户选择: B
🎯 问题2: 需要支持哪些OAuth提供商？
A) GitHub
B) Google
C) 微信
D) 以上全部
用户选择: D
（继续提问直到信息充分）
Step 4: 提出方案
## 方案对比
### 方案A: 使用现有OAuth库（推荐）
**优点**：
- 成熟稳定，社区支持好
- 开发速度快
- 安全性有保障
**缺点**：
- 定制性较差
- 依赖第三方库
**适用场景**：标准OAuth流程，无特殊定制需求
### 方案B: 自研OAuth实现
**优点**：
- 完全可控
- 可深度定制
**缺点**：
- 开发周期长
- 安全风险高
**推荐方案A的理由**：
- 项目时间紧，需要快速上线
- 标准OAuth流程满足需求
- 安全性比自研更有保障
Step 5: 展示设计
# 用户OAuth认证设计文档
## 概述
为现有用户系统添加GitHub、Google、微信OAuth认证，使用成熟OAuth库实现。
## 架构设计
（架构图）
## 核心组件
1. OAuthController - 处理OAuth回调
2. OAuthService - OAuth业务逻辑
3. UserRepository - 用户数据访问
（最终需求确认：✅）
...
Step 6: 编写文档
Write to: docs/plans/2026-03-28-user-oauth-design.md
Step 7: 提交
git add docs/plans/2026-03-28-user-oauth-design.md
git commit -m "docs: add user OAuth authentication design"
Step 8: 触发下游
2026-03-28T16:00:00 | SKILL_COMPLETE | harness-brainstorm | 设计文档完成 - user-oauth | SUCCESS
2026-03-28T16:00:00 | TRIGGER_DOWNSTREAM | harness-plan | 触发计划编写 | PENDING
docs/plans/2026-03-28-enjoyharness-design-v3.md