بنقرة واحدة
harness-brainstorm
头脑风暴技能,在实现前探索用户意图、需求和设计,防止返工
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
القائمة
头脑风暴技能,在实现前探索用户意图、需求和设计,防止返工
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
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