diff --git a/.claude/commands/workflow/brainstorm.md b/.claude/commands/workflow/brainstorm.md deleted file mode 100644 index 435204c7..00000000 --- a/.claude/commands/workflow/brainstorm.md +++ /dev/null @@ -1,506 +0,0 @@ ---- -name: brainstorm -description: Multi-perspective brainstorming coordination command that orchestrates multiple agents for comprehensive ideation and solution exploration -usage: /brainstorm [--mode=] [--perspectives=] [--execution=] -argument-hint: "brainstorming topic or challenge description" [optional: mode, perspectives, execution] -examples: - - /brainstorm "innovative user authentication methods" - - /brainstorm "solving scalability challenges" --mode=analytical - - /brainstorm "redesigning the onboarding experience" --perspectives=ui-designer,user-researcher,product-manager - - /brainstorm "reducing system complexity" --mode=strategic --execution=parallel -allowed-tools: Task(conceptual-planning-agent), TodoWrite(*) ---- - -### 🚀 **Command Overview: `/brainstorm`** - -- **Type**: Coordination Command -- **Purpose**: To orchestrate multiple specialized agents for comprehensive multi-perspective brainstorming on challenges and opportunities. -- **Core Tools**: `Task(conceptual-planning-agent)`, `TodoWrite(*)` -- **Integration Rules**: @~/.claude/workflows/brainstorming-principles.md - -### 🔄 **Overall Brainstorming Protocol** - -`Phase 1: Coordination Setup` **->** `Phase 1.5: User Discussion & Validation` **->** `Phase 2: Agent Coordination` **->** `Phase 3: Synthesis & Documentation` - -### ⚙️ **Brainstorming Modes** - -- **`creative` (Default)** - - **Approach**: Divergent thinking, "what if" scenarios. - - **Agent Selection**: Auto-selects `innovation-lead`, `ui-designer`, `user-researcher`, and a business agent. - - **Execution**: Typically parallel. -- **`analytical`** - - **Approach**: Root cause analysis, data-driven insights. - - **Agent Selection**: Auto-selects `business-analyst`, `data-architect`, `system-architect`, and a domain expert. - - **Execution**: Typically serial. -- **`strategic`** - - **Approach**: Systems thinking, long-term visioning. - - **Agent Selection**: Auto-selects `innovation-lead`, `product-manager`, `business-analyst`, and a technical expert. - - **Execution**: Mixed serial/parallel. - -### 🚦 **Execution Patterns** - -- **`serial` (Default)** - - **Use Case**: When perspectives need to build on each other. - - **Process**: Agents run one at a time, informed by previous outputs. -- **`parallel`** - - **Use Case**: When diverse, independent perspectives are needed quickly. - - **Process**: All selected agents run simultaneously. -- **`hybrid`** - - **Use Case**: Complex, multi-phase brainstorming. - - **Process**: Combines parallel initial ideation with serial refinement phases. - -### 🎭 **Available Perspectives (Agent Roles)** - -- `product-manager`: User needs, business value, market positioning. -- `system-architect`: Technical architecture, scalability, integration. -- `ui-designer`: User experience, interface design, usability. -- `data-architect`: Data flow, storage, analytics, insights. -- `security-expert`: Security implications, threat modeling, compliance. -- `user-researcher`: User behavior, pain points, research insights. -- `business-analyst`: Process optimization, efficiency, ROI. -- `innovation-lead`: Emerging trends, disruptive technologies, opportunities. -- `feature-planner`: Feature planning and development strategy. -- `test-strategist`: Testing strategy and quality assurance. - -### 🤖 **Agent Selection & Loading Logic** - -This logic determines which agents participate in the brainstorming session. - -```pseudo -FUNCTION select_agents(mode, perspectives_arg): - IF perspectives_arg is provided: - // User explicitly defines roles via --perspectives flag - RETURN perspectives_arg.split(',') - ELSE: - // Automatic selection based on mode or topic analysis - CASE topic_type: - WHEN "Technical Challenge": - selected = ["system-architect", "security-expert"] - IF topic is data_heavy: ADD "data-architect" - RETURN selected - WHEN "User-Facing Feature": - RETURN ["ui-designer", "user-researcher", "product-manager"] - WHEN "Business Process": - RETURN ["business-analyst", "product-manager"] - WHEN "Innovation/Strategy": - RETURN ["innovation-lead", "product-manager"] - DEFAULT: - // Fallback to mode-based selection - CASE mode: - WHEN "creative": RETURN ["innovation-lead", "ui-designer", "user-researcher", ...] - WHEN "analytical": RETURN ["business-analyst", "data-architect", "system-architect", ...] - WHEN "strategic": RETURN ["innovation-lead", "product-manager", "business-analyst", ...] - END CASE - END CASE - END IF -END FUNCTION - -FUNCTION load_agent_role(role_name): - // Dynamically loads role capabilities using the specified shell script - execute_tool("Bash", "~/.claude/scripts/plan-executor.sh " + role_name) -END FUNCTION -``` - -### 🏗️ **Phase 1: Coordination Setup Protocol** - -⚠️ **CRITICAL**: Before brainstorming, MUST check for existing active session to avoid creating duplicate sessions. - -**Session Check Process:** -1. **Check Active Session**: Check for `.workflow/.active-*` marker file to identify active session. No file creation needed. -2. **Session Selection**: Use existing active session or create new one only if none exists -3. **Context Integration**: Load existing session state and continue brainstorming phase - -`Check Active Session` **->** `Generate Topic Slug (WFS-[topic-slug]) if needed` **->** `Create Project Directories (.workflow/WFS-[slug]/.brainstorming/{agent1}, {agent2}, ...)` **->** `Initialize/Update session-state.json` **->** `Verify Structure` **->** `Initialize TodoWrite` - -### 📝 **Initial TodoWrite Structure (Template)** - -This `TodoWrite` call establishes the complete workflow plan at the beginning of the session. -``` -TodoWrite([ - {"content": "Establish project structure and initialize session", "status": "completed", "activeForm": "Establishing project structure"}, - {"content": "Set up brainstorming session and select perspectives", "status": "in_progress", "activeForm": "Setting up brainstorming session"}, - {"content": "Discuss [agent1] scope and gather user requirements", "status": "pending", "activeForm": "Discussing [agent1] requirements with user"}, - {"content": "Coordinate [selected_agent1] perspective analysis", "status": "pending", "activeForm": "Coordinating [agent1] perspective"}, - {"content": "Discuss [agent2] scope and gather user requirements", "status": "pending", "activeForm": "Discussing [agent2] requirements with user"}, - {"content": "Coordinate [selected_agent2] perspective analysis", "status": "pending", "activeForm": "Coordinating [agent2] perspective"}, - {"content": "Discuss [agent3] scope and gather user requirements", "status": "pending", "activeForm": "Discussing [agent3] requirements with user"}, - {"content": "Coordinate [selected_agent3] perspective analysis", "status": "pending", "activeForm": "Coordinating [agent3] perspective"}, - {"content": "Synthesize multi-perspective insights", "status": "pending", "activeForm": "Synthesizing insights"}, - {"content": "Generate prioritized recommendations", "status": "pending", "activeForm": "Generating recommendations"}, - {"content": "Create comprehensive brainstorming documentation", "status": "pending", "activeForm": "Creating documentation"} -]) -``` - -### 💬 **Phase 1.5: Mandatory User Discussion Protocol** - -This validation loop is **required** before *each* agent is executed. - -```pseudo -FUNCTION validate_and_run_agents(selected_agents): - FOR EACH agent in selected_agents: - // Update the task list to show which discussion is active - update_todowrite("Discuss " + agent + " scope", "in_progress") // Corresponds to TodoWrite(*) tool - - present_agent_scope(agent) - user_context = ask_context_questions(agent) // Example questions in next card - present_task_roadmap(agent) - - LOOP: - user_response = get_user_input("Ready to proceed with " + agent + " analysis?") - IF user_response is "Yes, proceed" or similar: - // User has given explicit approval - update_todowrite("Discuss " + agent + " scope", "completed") // Corresponds to TodoWrite(*) - execute_agent_task(agent, user_context) // Proceeds to Phase 2 for this agent - BREAK - ELSE IF user_response is "No", "Wait", or requests changes: - // User has feedback, revise the plan - revise_approach(user_feedback) - present_task_roadmap(agent) // Re-present the revised plan - END IF - END LOOP - END FOR -END FUNCTION -``` - -### ❓ **User Discussion Question Templates** - -- **System Architect**: Technical constraints? Integrations? Scalability needs? -- **UI Designer**: Primary users? Usability challenges? Brand guidelines? Accessibility? -- **Product Manager**: Business goals? Key stakeholders? Market factors? Success metrics? -- **Data Architect**: Data sources? Privacy/compliance? Quality challenges? -- **Security Expert**: Threat models? Compliance needs (GDPR, etc.)? Security level? - -### 🧠 **Phase 2: Agent Coordination Logic** - -This logic executes after user approval for each agent. - -```pseudo -FUNCTION execute_agent_task(agent, user_context): - update_todowrite("Coordinate " + agent + " perspective", "in_progress") // Corresponds to TodoWrite(*) tool - - // This action corresponds to calling the allowed tool: Task(conceptual-planning-agent) - // The specific prompt templates are provided in the source documentation. - status = execute_tool("Task(conceptual-planning-agent)", agent, user_context) - - IF status is 'SUCCESS': - update_todowrite("Coordinate " + agent + " perspective", "completed") - ELSE: - // Handle potential agent execution failure - log_error("Agent " + agent + " failed.") - HALT_WORKFLOW() - END IF -END FUNCTION -``` - -### 📋 **Agent Execution Task Templates (Serial & Parallel)** - -These templates show the exact structure of the `Task(conceptual-planning-agent)` call. - -- **For Serial Execution (one agent at a time):** - ``` - Task(conceptual-planning-agent): "Conduct brainstorming analysis for: [topic]. Use [mode] brainstorming approach. Required perspective: [agent1]. - - Load role definition using: ~/.claude/scripts/plan-executor.sh [agent1] - - USER CONTEXT FROM DISCUSSION: - - Specific focus areas: [user_specified_challenges_goals] - - Constraints and requirements: [user_specified_constraints] - - Expected outcomes: [user_expected_outcomes] - - Additional user requirements: [other_user_inputs] - - OUTPUT REQUIREMENT: Save all generated documents to: .workflow/WFS-[topic-slug]/.brainstorming/[agent1]/ - - analysis.md (main perspective analysis incorporating user context) - - [agent1-specific-output].md (specialized deliverable addressing user requirements) - - Apply the returned planning template and generate comprehensive analysis from this perspective, ensuring all user-specified requirements and context are fully incorporated." - ``` -- **For Parallel Execution (multiple agents at once):** - ``` - Task(conceptual-planning-agent): "Conduct multi-perspective brainstorming analysis for: [topic]. Use [mode] brainstorming approach. Required perspectives: [agent1, agent2, agent3]. - - For each perspective, follow this protocol: - 1. Load role definition using: ~/.claude/scripts/plan-executor.sh [role] - 2. Incorporate user discussion context for each agent: - - [Agent1]: Focus areas: [user_input_agent1], Constraints: [constraints_agent1], Expected outcomes: [outcomes_agent1] - - [Agent2]: Focus areas: [user_input_agent2], Constraints: [constraints_agent2], Expected outcomes: [outcomes_agent2] - - [Agent3]: Focus areas: [user_input_agent3], Constraints: [constraints_agent3], Expected outcomes: [outcomes_agent3] - 3. OUTPUT REQUIREMENT: Save documents to: .workflow/WFS-[topic-slug]/.brainstorming/[role]/ - - analysis.md (main perspective analysis incorporating user context) - - [role-specific-output].md (specialized deliverable addressing user requirements) - - Apply all perspectives in parallel analysis, ensuring each agent's output incorporates their specific user discussion context and is saved to their designated directory." - ``` - -### 🏁 **Phase 3: Synthesis & Documentation Flow** - -`Integrate All Agent Insights` **->** `Prioritize Solutions (by feasibility & impact)` **->** `Generate Comprehensive Summary Document` **->** `Mark All Todos as 'completed'` - -### ✅ **Core Principles & Quality Standards** - -- **User-Driven Process**: Every agent execution **must** be preceded by user discussion and explicit approval. -- **Context Integration**: All user inputs (focus areas, constraints, goals) must be fully incorporated into agent analysis. -- **`TodoWrite` First**: A `TodoWrite` plan must be established before any agent coordination begins. -- **Single Active Task**: Only one `TodoWrite` item should be marked `"in_progress"` at any time. -- **Transparent & Flexible**: The user understands what each agent will do and can provide feedback to revise the plan. - -### 📄 **Synthesis Output Structure** - -A guide for the final comprehensive report generated at the end of the workflow. -- **Session Summary**: - - Coordination approach (serial/parallel) - - Agent perspectives involved - - Brainstorming mode applied -- **Individual Agent Insights**: - - Summary of each agent's analysis. - - Note areas of agreement or disagreement. -- **Cross-Perspective Synthesis**: - - Identify convergent themes and breakthrough ideas. -- **Actionable Recommendations**: - - Categorize actions (immediate, strategic, research). -- **Implementation Guidance**: - - Suggested phases, resource needs, success metrics. - -## 📁 **File Generation System** - -### Automatic File Generation -Every brainstorming session generates a comprehensive set of structured output files: - -#### Generated File Structure -``` -.workflow/WFS-[topic-slug]/.brainstorming/ -├── synthesis-analysis.md # Cross-perspective analysis -├── recommendations.md # Actionable recommendations -├── brainstorm-session.json # Session metadata -├── [agent1]/ # Individual agent outputs -│ ├── analysis.md # Main perspective analysis -│ └── [specific-deliverable].md # Agent-specific outputs -├── [agent2]/ -│ ├── analysis.md -│ └── [specific-deliverable].md -└── artifacts/ # Supporting materials - ├── user-context.md # Captured user discussion - ├── session-transcript.md # Brainstorming session log - └── export/ # Export formats - ├── brainstorm-summary.pdf - └── recommendations.json -``` - -### Core Output Documents - -#### 1. synthesis-analysis.md -Cross-perspective synthesis of all agent insights: -```markdown -# Brainstorming Synthesis Analysis -*Session: WFS-[topic-slug] | Generated: 2025-09-07 16:00:00* - -## Session Overview -- **Topic**: [brainstorming topic] -- **Mode**: [creative|analytical|strategic] -- **Execution**: [serial|parallel] -- **Participants**: [list of agent roles] -- **Duration**: [session duration] - -## Individual Agent Insights Summary - -### 🎨 UI Designer Perspective -**Focus Areas**: User experience, interface design, usability -**Key Insights**: -- Modern, intuitive design approach -- Mobile-first considerations -- Accessibility requirements -**Recommendations**: [specific design recommendations] - -### 🏗️ System Architect Perspective -**Focus Areas**: Technical architecture, scalability, integration -**Key Insights**: -- Microservices architecture benefits -- Database optimization strategies -- Security considerations -**Recommendations**: [specific technical recommendations] - -[Additional agent perspectives...] - -## Cross-Perspective Analysis - -### Convergent Themes -1. **User-Centric Approach**: All agents emphasized user experience priority -2. **Scalability Focus**: Common concern for system growth capacity -3. **Security Integration**: Unanimous priority on security-by-design - -### Breakthrough Ideas -1. **Unified Authentication System**: Cross-platform identity management -2. **Progressive Web App**: Mobile and desktop feature parity -3. **AI-Powered Analytics**: Smart user behavior insights - -### Areas of Disagreement -1. **Technology Stack**: [description of disagreement and perspectives] -2. **Implementation Timeline**: [varying estimates and approaches] - -## Strategic Synthesis -[Integrated analysis combining all perspectives into coherent strategy] - ---- -*Generated by /brainstorm synthesis phase* -``` - -#### 2. recommendations.md -Actionable recommendations categorized by priority and scope: -```markdown -# Brainstorming Recommendations -*Session: WFS-[topic-slug] | Generated: 2025-09-07 16:15:00* - -## Executive Summary -[High-level summary of key recommendations] - -## Immediate Actions (0-2 weeks) -### High Priority - Critical -- **REC-001**: [Recommendation title] - - **Context**: [Background and rationale] - - **Action**: [Specific steps to take] - - **Resources**: [Required resources/skills] - - **Impact**: [Expected outcomes] - - **Owner**: [Suggested responsible party] - -### Medium Priority - Important -- **REC-002**: [Recommendation title] - [Same structure as above] - -## Strategic Actions (2-8 weeks) -### Architecture & Infrastructure -- **REC-003**: [Technical improvements] -- **REC-004**: [System optimizations] - -### User Experience & Design -- **REC-005**: [UX improvements] -- **REC-006**: [Design system updates] - -## Research Actions (Future Investigation) -### Technical Research -- **REC-007**: [Emerging technology evaluation] -- **REC-008**: [Performance optimization study] - -### Market Research -- **REC-009**: [User behavior analysis] -- **REC-010**: [Competitive analysis] - -## Implementation Roadmap -### Phase 1: Foundation (Weeks 1-2) -- Execute REC-001, REC-002 -- Establish core infrastructure - -### Phase 2: Development (Weeks 3-6) -- Implement REC-003, REC-004, REC-005 -- Build core features - -### Phase 3: Enhancement (Weeks 7-8) -- Deploy REC-006 -- Optimize and refine - -## Success Metrics -- [Quantifiable measures of success] -- [Key performance indicators] - -## Risk Assessment -- [Potential obstacles and mitigation strategies] - ---- -*Generated by /brainstorm recommendations synthesis* -``` - -#### 3. brainstorm-session.json -Session metadata and tracking: -```json -{ - "session_id": "WFS-[topic-slug]", - "brainstorm_id": "BRM-2025-09-07-001", - "topic": "[brainstorming topic]", - "mode": "creative", - "execution": "parallel", - "created_at": "2025-09-07T15:30:00Z", - "completed_at": "2025-09-07T16:30:00Z", - "duration_minutes": 60, - "participants": { - "agents": ["ui-designer", "system-architect", "product-manager"], - "user_interaction": true - }, - "outputs": { - "agent_analyses": { - "ui-designer": { - "analysis_path": ".brainstorming/ui-designer/analysis.md", - "deliverable_path": ".brainstorming/ui-designer/design-mockups.md", - "completed_at": "2025-09-07T15:50:00Z" - }, - "system-architect": { - "analysis_path": ".brainstorming/system-architect/analysis.md", - "deliverable_path": ".brainstorming/system-architect/architecture-proposal.md", - "completed_at": "2025-09-07T15:55:00Z" - }, - "product-manager": { - "analysis_path": ".brainstorming/product-manager/analysis.md", - "deliverable_path": ".brainstorming/product-manager/feature-roadmap.md", - "completed_at": "2025-09-07T16:00:00Z" - } - }, - "synthesis": { - "analysis_path": "synthesis-analysis.md", - "recommendations_path": "recommendations.md", - "completed_at": "2025-09-07T16:30:00Z" - } - }, - "user_context": { - "focus_areas": "[captured from user discussion]", - "constraints": "[user-specified limitations]", - "expected_outcomes": "[user goals and expectations]" - }, - "metrics": { - "insights_generated": 24, - "recommendations_count": 10, - "breakthrough_ideas": 3, - "consensus_areas": 3, - "disagreement_areas": 2 - } -} -``` - -### Session Integration -After brainstorming completion, the main workflow-session.json is updated: -```json -{ - "phases": { - "BRAINSTORM": { - "status": "completed", - "completed_at": "2025-09-07T16:30:00Z", - "output_directory": ".workflow/WFS-[topic-slug]/.brainstorming/", - "documents_generated": [ - "synthesis-analysis.md", - "recommendations.md", - "brainstorm-session.json" - ], - "agents_participated": ["ui-designer", "system-architect", "product-manager"], - "insights_available": true - } - }, - "documents": { - "brainstorming": { - "synthesis-analysis.md": { - "status": "generated", - "path": ".workflow/WFS-[topic-slug]/.brainstorming/synthesis-analysis.md", - "generated_at": "2025-09-07T16:30:00Z", - "type": "synthesis_analysis" - }, - "recommendations.md": { - "status": "generated", - "path": ".workflow/WFS-[topic-slug]/.brainstorming/recommendations.md", - "generated_at": "2025-09-07T16:30:00Z", - "type": "actionable_recommendations" - } - } - } -} -``` - -### Export and Integration Features -- **PDF Export**: Automatic generation of consolidated brainstorming report -- **JSON Export**: Machine-readable recommendations for integration tools -- **Action Plan Integration**: Direct feeding into `/workflow:action-plan --from-brainstorming` -- **Cross-Referencing**: Links to specific agent insights from synthesis documents diff --git a/.claude/commands/workflow/brainstorm/business-analyst.md b/.claude/commands/workflow/brainstorm/business-analyst.md new file mode 100644 index 00000000..d55f71ee --- /dev/null +++ b/.claude/commands/workflow/brainstorm/business-analyst.md @@ -0,0 +1,263 @@ +--- +name: brainstorm:business-analyst +description: Business analyst perspective brainstorming for process optimization and business efficiency analysis +usage: /brainstorm:business-analyst +argument-hint: "topic or challenge to analyze from business analysis perspective" +examples: + - /brainstorm:business-analyst "workflow automation opportunities" + - /brainstorm:business-analyst "business process optimization" + - /brainstorm:business-analyst "cost reduction initiatives" +allowed-tools: Task(conceptual-planning-agent), TodoWrite(*) +--- + +## 📊 **角色定义: Business Analyst** + +### 核心职责 +- **流程分析**: 分析现有业务流程的效率和改进机会 +- **需求分析**: 识别和定义业务需求和功能要求 +- **效益评估**: 评估解决方案的商业价值和投资回报 +- **变更管理**: 规划和管理业务流程变更 + +### 关注领域 +- **流程优化**: 工作流程、自动化机会、效率提升 +- **数据分析**: 业务指标、KPI设计、性能测量 +- **成本效益**: ROI分析、成本优化、价值创造 +- **风险管理**: 业务风险、合规要求、变更风险 + +## 🧠 **分析框架** + +@~/.claude/workflows/brainstorming-principles.md +@~/.claude/workflows/conceptual-planning-agent.md + +### 核心分析问题 +1. **业务流程分析**: + - 当前业务流程的瓶颈和低效环节？ + - 哪些流程可以自动化或简化？ + - 跨部门协作中的障碍点？ + +2. **业务需求识别**: + - 利益相关者的核心需求？ + - 业务目标和成功指标？ + - 功能和非功能需求优先级？ + +3. **价值和效益分析**: + - 解决方案的预期商业价值？ + - 实施成本vs收益对比？ + - 风险评估和缓解策略？ + +4. **实施和变更管理**: + - 变更对现有流程的影响？ + - 培训和适应需求？ + - 成功指标和监控机制？ + +## ⚙️ **执行协议** + +### Phase 1: 会话检测与初始化 +```bash +# 自动检测活动会话 +CHECK: .workflow/.active-* marker files +IF active_session EXISTS: + session_id = get_active_session() + load_context_from(session_id) +ELSE: + request_user_for_session_creation() +``` + +### Phase 2: 目录结构创建 +```bash +# 创建业务分析师分析目录 +mkdir -p .workflow/WFS-{topic-slug}/.brainstorming/business-analyst/ +``` + +### Phase 3: TodoWrite 初始化 +设置业务分析师视角分析的任务跟踪： +```json +[ + {"content": "Initialize business analyst brainstorming session", "status": "completed", "activeForm": "Initializing session"}, + {"content": "Analyze current business processes and workflows", "status": "in_progress", "activeForm": "Analyzing business processes"}, + {"content": "Identify business requirements and stakeholder needs", "status": "pending", "activeForm": "Identifying requirements"}, + {"content": "Evaluate cost-benefit and ROI analysis", "status": "pending", "activeForm": "Evaluating cost-benefit"}, + {"content": "Design process improvements and optimizations", "status": "pending", "activeForm": "Designing improvements"}, + {"content": "Plan change management and implementation", "status": "pending", "activeForm": "Planning change management"}, + {"content": "Generate comprehensive business analysis documentation", "status": "pending", "activeForm": "Generating documentation"} +] +``` + +### Phase 4: 概念规划代理协调 +```bash +Task(conceptual-planning-agent): " +Conduct business analyst perspective brainstorming for: {topic} + +ROLE CONTEXT: Business Analyst +- Focus Areas: Process optimization, requirements analysis, cost-benefit analysis, change management +- Analysis Framework: Business-centric approach with emphasis on efficiency and value creation +- Success Metrics: Process efficiency, cost reduction, stakeholder satisfaction, ROI achievement + +USER CONTEXT: {captured_user_requirements_from_session} + +ANALYSIS REQUIREMENTS: +1. Current State Business Analysis + - Map existing business processes and workflows + - Identify process inefficiencies and bottlenecks + - Analyze current costs, resources, and time investments + - Assess stakeholder roles and responsibilities + - Document pain points and improvement opportunities + +2. Requirements Gathering and Analysis + - Identify key stakeholders and their needs + - Define functional and non-functional business requirements + - Prioritize requirements based on business value and urgency + - Analyze requirement dependencies and constraints + - Create requirements traceability matrix + +3. Process Design and Optimization + - Design optimized future state processes + - Identify automation opportunities and digital solutions + - Plan for process standardization and best practices + - Design quality gates and control points + - Create process documentation and standard operating procedures + +4. Cost-Benefit and ROI Analysis + - Calculate implementation costs (people, technology, time) + - Quantify expected benefits (cost savings, efficiency gains, revenue) + - Perform ROI analysis and payback period calculation + - Assess intangible benefits (customer satisfaction, employee morale) + - Create business case with financial justification + +5. Risk Assessment and Mitigation + - Identify business, operational, and technical risks + - Assess impact and probability of identified risks + - Develop risk mitigation strategies and contingency plans + - Plan for compliance and regulatory requirements + - Design risk monitoring and control measures + +6. Change Management and Implementation Planning + - Assess organizational change readiness and impact + - Design change management strategy and communication plan + - Plan training and knowledge transfer requirements + - Create implementation timeline with milestones + - Design success metrics and monitoring framework + +OUTPUT REQUIREMENTS: Save comprehensive analysis to: +.workflow/WFS-{topic-slug}/.brainstorming/business-analyst/ +- analysis.md (main business analysis and process assessment) +- requirements.md (detailed business requirements and specifications) +- business-case.md (cost-benefit analysis and financial justification) +- implementation-plan.md (change management and implementation strategy) + +Apply business analysis expertise to optimize processes and maximize business value." +``` + +## 📊 **输出结构** + +### 保存位置 +``` +.workflow/WFS-{topic-slug}/.brainstorming/business-analyst/ +├── analysis.md # 主要业务分析和流程评估 +├── requirements.md # 详细业务需求和规范 +├── business-case.md # 成本效益分析和财务论证 +└── implementation-plan.md # 变更管理和实施策略 +``` + +### 文档模板 + +#### analysis.md 结构 +```markdown +# Business Analyst Analysis: {Topic} +*Generated: {timestamp}* + +## Executive Summary +[核心业务分析发现和建议概述] + +## Current State Assessment +### Business Process Mapping +### Stakeholder Analysis +### Performance Metrics Analysis +### Pain Points and Inefficiencies + +## Business Requirements +### Functional Requirements +### Non-Functional Requirements +### Stakeholder Needs Analysis +### Requirements Prioritization + +## Process Optimization Opportunities +### Automation Potential +### Workflow Improvements +### Resource Optimization +### Quality Enhancements + +## Financial Analysis +### Cost-Benefit Analysis +### ROI Calculations +### Budget Requirements +### Financial Projections + +## Risk Assessment +### Business Risks +### Operational Risks +### Mitigation Strategies +### Contingency Planning + +## Implementation Strategy +### Change Management Plan +### Training Requirements +### Timeline and Milestones +### Success Metrics and KPIs + +## Recommendations +### Immediate Actions (0-3 months) +### Medium-term Initiatives (3-12 months) +### Long-term Strategic Goals (12+ months) +### Resource Requirements +``` + +## 🔄 **会话集成** + +### 状态同步 +分析完成后，更新 `workflow-session.json`: +```json +{ + "phases": { + "BRAINSTORM": { + "business_analyst": { + "status": "completed", + "completed_at": "timestamp", + "output_directory": ".workflow/WFS-{topic}/.brainstorming/business-analyst/", + "key_insights": ["process_optimization", "cost_saving", "efficiency_gain"] + } + } + } +} +``` + +### 与其他角色的协作 +业务分析师视角为其他角色提供： +- **业务需求和约束** → Product Manager +- **流程技术化需求** → System Architect +- **业务流程界面需求** → UI Designer +- **业务数据需求** → Data Architect +- **业务安全要求** → Security Expert + +## ✅ **质量标准** + +### 必须包含的分析元素 +- [ ] 详细的业务流程映射 +- [ ] 明确的需求规范和优先级 +- [ ] 量化的成本效益分析 +- [ ] 全面的风险评估 +- [ ] 可执行的实施计划 + +### 业务分析原则检查 +- [ ] 以价值为导向：关注商业价值创造 +- [ ] 数据驱动：基于事实和数据进行分析 +- [ ] 全局思维：考虑整个业务生态系统 +- [ ] 风险意识：识别和管理各类风险 +- [ ] 可持续性：长期可维护和改进 + +### 分析质量指标 +- [ ] 需求的完整性和准确性 +- [ ] 流程优化的量化收益 +- [ ] 风险评估的全面性 +- [ ] 实施计划的可行性 +- [ ] 利益相关者的满意度 \ No newline at end of file diff --git a/.claude/commands/workflow/brainstorm/data-architect.md b/.claude/commands/workflow/brainstorm/data-architect.md new file mode 100644 index 00000000..f8465c18 --- /dev/null +++ b/.claude/commands/workflow/brainstorm/data-architect.md @@ -0,0 +1,253 @@ +--- +name: brainstorm:data-architect +description: Data architect perspective brainstorming for data modeling, flow, and analytics analysis +usage: /brainstorm:data-architect +argument-hint: "topic or challenge to analyze from data architecture perspective" +examples: + - /brainstorm:data-architect "user analytics data pipeline" + - /brainstorm:data-architect "real-time data processing system" + - /brainstorm:data-architect "data warehouse modernization" +allowed-tools: Task(conceptual-planning-agent), TodoWrite(*) +--- + +## 📊 **角色定义: Data Architect** + +### 核心职责 +- **数据模型设计**: 设计高效、可扩展的数据模型 +- **数据流程设计**: 规划数据采集、处理、存储流程 +- **数据质量管理**: 确保数据准确性、完整性、一致性 +- **分析和洞察**: 设计数据分析和商业智能解决方案 + +### 关注领域 +- **数据建模**: 关系模型、NoSQL、数据仓库、湖仓一体 +- **数据管道**: ETL/ELT流程、实时处理、批处理 +- **数据治理**: 数据质量、安全、隐私、合规 +- **分析平台**: BI工具、机器学习、报表系统 + +## 🧠 **分析框架** + +@~/.claude/workflows/brainstorming-principles.md +@~/.claude/workflows/conceptual-planning-agent.md + +### 核心分析问题 +1. **数据需求和来源**: + - 需要哪些数据来支持业务决策？ + - 数据来源的可靠性和质量如何？ + - 实时数据vs历史数据的需求平衡？ + +2. **数据架构和存储**: + - 最适合的数据存储方案是什么？ + - 如何设计可扩展的数据模型？ + - 数据分区和索引策略？ + +3. **数据处理和流程**: + - 数据处理的性能要求？ + - 如何设计容错的数据管道？ + - 数据变更和版本控制策略？ + +4. **分析和报告**: + - 如何支持不同的分析需求？ + - 实时仪表板vs定期报告？ + - 数据可视化和自助分析能力？ + +## ⚙️ **执行协议** + +### Phase 1: 会话检测与初始化 +```bash +# 自动检测活动会话 +CHECK: .workflow/.active-* marker files +IF active_session EXISTS: + session_id = get_active_session() + load_context_from(session_id) +ELSE: + request_user_for_session_creation() +``` + +### Phase 2: 目录结构创建 +```bash +# 创建数据架构师分析目录 +mkdir -p .workflow/WFS-{topic-slug}/.brainstorming/data-architect/ +``` + +### Phase 3: TodoWrite 初始化 +设置数据架构师视角分析的任务跟踪： +```json +[ + {"content": "Initialize data architect brainstorming session", "status": "completed", "activeForm": "Initializing session"}, + {"content": "Analyze data requirements and sources", "status": "in_progress", "activeForm": "Analyzing data requirements"}, + {"content": "Design optimal data model and schema", "status": "pending", "activeForm": "Designing data model"}, + {"content": "Plan data pipeline and processing workflows", "status": "pending", "activeForm": "Planning data pipelines"}, + {"content": "Evaluate data quality and governance", "status": "pending", "activeForm": "Evaluating data governance"}, + {"content": "Design analytics and reporting solutions", "status": "pending", "activeForm": "Designing analytics"}, + {"content": "Generate comprehensive data architecture documentation", "status": "pending", "activeForm": "Generating documentation"} +] +``` + +### Phase 4: 概念规划代理协调 +```bash +Task(conceptual-planning-agent): " +Conduct data architect perspective brainstorming for: {topic} + +ROLE CONTEXT: Data Architect +- Focus Areas: Data modeling, data flow, storage optimization, analytics infrastructure +- Analysis Framework: Data-driven approach with emphasis on scalability, quality, and insights +- Success Metrics: Data quality, processing efficiency, analytics accuracy, scalability + +USER CONTEXT: {captured_user_requirements_from_session} + +ANALYSIS REQUIREMENTS: +1. Data Requirements Analysis + - Identify all data sources (internal, external, third-party) + - Analyze data types, volumes, and velocity requirements + - Define data freshness and latency requirements + - Assess data quality and completeness standards + +2. Data Architecture Design + - Design logical and physical data models + - Plan data storage strategy (relational, NoSQL, data lake, warehouse) + - Design data partitioning and sharding strategies + - Plan for data archival and retention policies + +3. Data Pipeline and Processing + - Design ETL/ELT processes and data transformation workflows + - Plan real-time vs batch processing requirements + - Design error handling and data recovery mechanisms + - Plan for data lineage and audit trails + +4. Data Quality and Governance + - Design data validation and quality monitoring + - Plan data governance framework and policies + - Assess privacy and compliance requirements (GDPR, CCPA, etc.) + - Design data access controls and security measures + +5. Analytics and Reporting Infrastructure + - Design data warehouse/data mart architecture + - Plan business intelligence and reporting solutions + - Design self-service analytics capabilities + - Plan for machine learning and advanced analytics integration + +6. Performance and Scalability + - Analyze current and projected data volumes + - Design indexing and query optimization strategies + - Plan horizontal and vertical scaling approaches + - Design monitoring and alerting for data systems + +OUTPUT REQUIREMENTS: Save comprehensive analysis to: +.workflow/WFS-{topic-slug}/.brainstorming/data-architect/ +- analysis.md (main data architecture analysis) +- data-model.md (detailed data models and schemas) +- pipeline-design.md (data processing workflows and ETL design) +- governance-plan.md (data quality, security, and compliance framework) + +Apply data architecture expertise to create scalable, reliable, and insightful data solutions." +``` + +## 📊 **输出结构** + +### 保存位置 +``` +.workflow/WFS-{topic-slug}/.brainstorming/data-architect/ +├── analysis.md # 主要数据架构分析 +├── data-model.md # 详细数据模型和架构 +├── pipeline-design.md # 数据处理工作流和ETL设计 +└── governance-plan.md # 数据质量、安全和合规框架 +``` + +### 文档模板 + +#### analysis.md 结构 +```markdown +# Data Architect Analysis: {Topic} +*Generated: {timestamp}* + +## Executive Summary +[核心数据架构发现和建议概述] + +## Current Data Landscape Assessment +### Existing Data Sources +### Data Quality Issues +### Performance Bottlenecks +### Integration Challenges + +## Data Requirements Analysis +### Business Data Requirements +### Technical Data Requirements +- Volume: [预期数据量和增长] +- Velocity: [数据更新频率] +- Variety: [数据类型和格式] +- Veracity: [数据质量要求] + +## Proposed Data Architecture +### Data Storage Strategy +### Data Model Design +### Integration Architecture +### Analytics Infrastructure + +## Data Pipeline Design +### Data Ingestion Strategy +### Processing Workflows +### Transformation Rules +### Quality Assurance + +## Governance and Compliance +### Data Quality Framework +### Security and Privacy +### Audit and Lineage +### Compliance Requirements + +## Performance and Scalability +### Optimization Strategies +### Scaling Plans +### Monitoring and Alerting +### Disaster Recovery +``` + +## 🔄 **会话集成** + +### 状态同步 +分析完成后，更新 `workflow-session.json`: +```json +{ + "phases": { + "BRAINSTORM": { + "data_architect": { + "status": "completed", + "completed_at": "timestamp", + "output_directory": ".workflow/WFS-{topic}/.brainstorming/data-architect/", + "key_insights": ["data_model_optimization", "pipeline_efficiency", "governance_requirement"] + } + } + } +} +``` + +### 与其他角色的协作 +数据架构师视角为其他角色提供： +- **数据能力和限制** → Product Manager +- **数据存储要求** → System Architect +- **数据展示能力** → UI Designer +- **数据安全要求** → Security Expert +- **功能数据支持** → Feature Planner + +## ✅ **质量标准** + +### 必须包含的架构元素 +- [ ] 完整的数据模型设计 +- [ ] 详细的数据流程图 +- [ ] 数据质量保证方案 +- [ ] 可扩展性和性能优化 +- [ ] 合规和安全控制 + +### 数据架构原则检查 +- [ ] 可扩展性：支持数据量和用户增长 +- [ ] 可靠性：具有容错和恢复机制 +- [ ] 可维护性：清晰的数据模型和流程 +- [ ] 安全性：数据保护和访问控制 +- [ ] 高效性：优化的查询和处理性能 + +### 数据质量指标 +- [ ] 数据准确性和完整性标准 +- [ ] 数据一致性检查机制 +- [ ] 数据时效性和新鲜度要求 +- [ ] 数据可追溯性和审计能力 +- [ ] 合规性检查和报告机制 \ No newline at end of file diff --git a/.claude/commands/workflow/brainstorm/feature-planner.md b/.claude/commands/workflow/brainstorm/feature-planner.md new file mode 100644 index 00000000..154d3b35 --- /dev/null +++ b/.claude/commands/workflow/brainstorm/feature-planner.md @@ -0,0 +1,263 @@ +--- +name: brainstorm:feature-planner +description: Feature planner perspective brainstorming for feature development and planning analysis +usage: /brainstorm:feature-planner +argument-hint: "topic or challenge to analyze from feature planning perspective" +examples: + - /brainstorm:feature-planner "user dashboard enhancement" + - /brainstorm:feature-planner "mobile app feature roadmap" + - /brainstorm:feature-planner "integration capabilities planning" +allowed-tools: Task(conceptual-planning-agent), TodoWrite(*) +--- + +## 🔧 **角色定义: Feature Planner** + +### 核心职责 +- **功能规划**: 设计和规划产品功能的开发路线图 +- **需求转化**: 将业务需求转化为具体的功能规范 +- **优先级排序**: 基于价值和资源平衡功能开发优先级 +- **交付规划**: 制定功能开发和发布时间表 + +### 关注领域 +- **功能设计**: 功能规范、用户故事、验收标准 +- **开发规划**: 迭代计划、里程碑、依赖关系管理 +- **质量保证**: 测试策略、质量标准、验收流程 +- **发布管理**: 发布策略、版本控制、变更管理 + +## 🧠 **分析框架** + +@~/.claude/workflows/brainstorming-principles.md +@~/.claude/workflows/conceptual-planning-agent.md + +### 核心分析问题 +1. **功能需求分析**: + - 核心功能需求和用户故事？ + - 功能的MVP和完整版本规划？ + - 跨功能依赖和集成需求？ + +2. **技术可行性评估**: + - 技术实现的复杂度和挑战？ + - 现有系统的扩展和改造需求？ + - 第三方服务和API集成？ + +3. **开发资源和时间估算**: + - 开发工作量和时间预估？ + - 所需技能和团队配置？ + - 开发风险和缓解策略？ + +4. **测试和质量保证**: + - 测试策略和测试用例设计？ + - 质量标准和验收条件？ + - 用户验收和反馈机制？ + +## ⚙️ **执行协议** + +### Phase 1: 会话检测与初始化 +```bash +# 自动检测活动会话 +CHECK: .workflow/.active-* marker files +IF active_session EXISTS: + session_id = get_active_session() + load_context_from(session_id) +ELSE: + request_user_for_session_creation() +``` + +### Phase 2: 目录结构创建 +```bash +# 创建功能规划师分析目录 +mkdir -p .workflow/WFS-{topic-slug}/.brainstorming/feature-planner/ +``` + +### Phase 3: TodoWrite 初始化 +设置功能规划师视角分析的任务跟踪： +```json +[ + {"content": "Initialize feature planner brainstorming session", "status": "completed", "activeForm": "Initializing session"}, + {"content": "Analyze feature requirements and user stories", "status": "in_progress", "activeForm": "Analyzing feature requirements"}, + {"content": "Design feature architecture and specifications", "status": "pending", "activeForm": "Designing feature architecture"}, + {"content": "Plan development phases and prioritization", "status": "pending", "activeForm": "Planning development phases"}, + {"content": "Evaluate testing strategy and quality assurance", "status": "pending", "activeForm": "Evaluating testing strategy"}, + {"content": "Create implementation timeline and milestones", "status": "pending", "activeForm": "Creating timeline"}, + {"content": "Generate comprehensive feature planning documentation", "status": "pending", "activeForm": "Generating documentation"} +] +``` + +### Phase 4: 概念规划代理协调 +```bash +Task(conceptual-planning-agent): " +Conduct feature planner perspective brainstorming for: {topic} + +ROLE CONTEXT: Feature Planner +- Focus Areas: Feature specification, development planning, quality assurance, delivery management +- Analysis Framework: Feature-centric approach with emphasis on deliverability and user value +- Success Metrics: Feature completion, quality standards, user satisfaction, delivery timeline + +USER CONTEXT: {captured_user_requirements_from_session} + +ANALYSIS REQUIREMENTS: +1. Feature Requirements Analysis + - Break down high-level requirements into specific feature specifications + - Create detailed user stories with acceptance criteria + - Identify feature dependencies and integration requirements + - Map features to user personas and use cases + - Define feature scope and boundaries (MVP vs full feature) + +2. Feature Architecture and Design + - Design feature workflows and user interaction patterns + - Plan feature integration with existing system components + - Define APIs and data interfaces required + - Plan for feature configuration and customization options + - Design feature monitoring and analytics capabilities + +3. Development Planning and Estimation + - Estimate development effort and complexity for each feature + - Identify technical risks and implementation challenges + - Plan feature development phases and incremental delivery + - Define development milestones and checkpoints + - Assess resource requirements and team capacity + +4. Quality Assurance and Testing Strategy + - Design comprehensive testing strategy (unit, integration, E2E) + - Create test scenarios and edge case coverage + - Plan performance testing and scalability validation + - Design user acceptance testing procedures + - Plan for accessibility and usability testing + +5. Feature Prioritization and Roadmap + - Apply prioritization frameworks (MoSCoW, Kano, RICE) + - Balance business value with development complexity + - Create feature release planning and versioning strategy + - Plan for feature flags and gradual rollout + - Design feature deprecation and sunset strategies + +6. Delivery and Release Management + - Plan feature delivery timeline and release schedule + - Design change management and deployment strategies + - Plan for feature documentation and user training + - Create feature success metrics and KPIs + - Design post-release monitoring and support plans + +OUTPUT REQUIREMENTS: Save comprehensive analysis to: +.workflow/WFS-{topic-slug}/.brainstorming/feature-planner/ +- analysis.md (main feature analysis and specifications) +- user-stories.md (detailed user stories and acceptance criteria) +- development-plan.md (development timeline and resource planning) +- testing-strategy.md (quality assurance and testing approach) + +Apply feature planning expertise to create deliverable, high-quality feature implementations." +``` + +## 📊 **输出结构** + +### 保存位置 +``` +.workflow/WFS-{topic-slug}/.brainstorming/feature-planner/ +├── analysis.md # 主要功能分析和规范 +├── user-stories.md # 详细用户故事和验收标准 +├── development-plan.md # 开发时间线和资源规划 +└── testing-strategy.md # 质量保证和测试方法 +``` + +### 文档模板 + +#### analysis.md 结构 +```markdown +# Feature Planner Analysis: {Topic} +*Generated: {timestamp}* + +## Executive Summary +[核心功能规划发现和建议概述] + +## Feature Requirements Overview +### Core Feature Specifications +### User Story Summary +### Feature Scope and Boundaries +### Success Criteria and KPIs + +## Feature Architecture Design +### Feature Components and Modules +### Integration Points and Dependencies +### APIs and Data Interfaces +### Configuration and Customization + +## Development Planning +### Effort Estimation and Complexity +### Development Phases and Milestones +### Resource Requirements +### Risk Assessment and Mitigation + +## Quality Assurance Strategy +### Testing Approach and Coverage +### Performance and Scalability Testing +### User Acceptance Testing Plan +### Quality Gates and Standards + +## Delivery and Release Strategy +### Release Planning and Versioning +### Deployment Strategy +### Feature Rollout Plan +### Post-Release Support + +## Feature Prioritization +### Priority Matrix (High/Medium/Low) +### Business Value Assessment +### Development Complexity Analysis +### Recommended Implementation Order + +## Implementation Roadmap +### Phase 1: Core Features (Weeks 1-4) +### Phase 2: Enhanced Features (Weeks 5-8) +### Phase 3: Advanced Features (Weeks 9-12) +### Continuous Improvement Plan +``` + +## 🔄 **会话集成** + +### 状态同步 +分析完成后，更新 `workflow-session.json`: +```json +{ + "phases": { + "BRAINSTORM": { + "feature_planner": { + "status": "completed", + "completed_at": "timestamp", + "output_directory": ".workflow/WFS-{topic}/.brainstorming/feature-planner/", + "key_insights": ["feature_specification", "development_timeline", "quality_requirement"] + } + } + } +} +``` + +### 与其他角色的协作 +功能规划师视角为其他角色提供： +- **功能优先级和规划** → Product Manager +- **技术实现需求** → System Architect +- **界面功能要求** → UI Designer +- **数据功能需求** → Data Architect +- **功能安全需求** → Security Expert + +## ✅ **质量标准** + +### 必须包含的规划元素 +- [ ] 详细的功能规范和用户故事 +- [ ] 现实的开发时间估算 +- [ ] 全面的测试策略 +- [ ] 明确的质量标准 +- [ ] 可执行的发布计划 + +### 功能规划原则检查 +- [ ] 用户价值：每个功能都有明确的用户价值 +- [ ] 可测试性：所有功能都有验收标准 +- [ ] 可维护性：考虑长期维护和扩展 +- [ ] 可交付性：计划符合团队能力和资源 +- [ ] 可测量性：有明确的成功指标 + +### 交付质量评估 +- [ ] 功能完整性和正确性 +- [ ] 性能和稳定性指标 +- [ ] 用户体验和满意度 +- [ ] 代码质量和可维护性 +- [ ] 文档完整性和准确性 \ No newline at end of file diff --git a/.claude/commands/workflow/brainstorm/innovation-lead.md b/.claude/commands/workflow/brainstorm/innovation-lead.md new file mode 100644 index 00000000..f9b4a309 --- /dev/null +++ b/.claude/commands/workflow/brainstorm/innovation-lead.md @@ -0,0 +1,263 @@ +--- +name: brainstorm:innovation-lead +description: Innovation lead perspective brainstorming for emerging technologies and future opportunities analysis +usage: /brainstorm:innovation-lead +argument-hint: "topic or challenge to analyze from innovation and emerging technology perspective" +examples: + - /brainstorm:innovation-lead "AI integration opportunities" + - /brainstorm:innovation-lead "future technology trends" + - /brainstorm:innovation-lead "disruptive innovation strategy" +allowed-tools: Task(conceptual-planning-agent), TodoWrite(*) +--- + +## 🚀 **角色定义: Innovation Lead** + +### 核心职责 +- **趋势识别**: 识别和分析新兴技术趋势和市场机会 +- **创新策略**: 制定创新路线图和技术发展战略 +- **技术评估**: 评估新技术的应用潜力和可行性 +- **未来规划**: 设计面向未来的产品和服务概念 + +### 关注领域 +- **新兴技术**: AI、区块链、IoT、AR/VR、量子计算等前沿技术 +- **市场趋势**: 行业变革、用户行为演进、商业模式创新 +- **创新机会**: 破坏性创新、蓝海市场、技术融合机会 +- **未来愿景**: 长期技术路线图、概念验证、原型开发 + +## 🧠 **分析框架** + +@~/.claude/workflows/brainstorming-principles.md +@~/.claude/workflows/conceptual-planning-agent.md + +### 核心分析问题 +1. **技术趋势和机会**: + - 哪些新兴技术对我们的行业最有影响？ + - 技术成熟度和采用时间轴？ + - 技术融合创造的新机会？ + +2. **创新潜力评估**: + - 破坏性创新的可能性和影响？ + - 现有解决方案的创新空间？ + - 未被满足的市场需求？ + +3. **竞争和市场分析**: + - 竞争对手的创新动向？ + - 市场空白和蓝海机会？ + - 技术壁垒和先发优势？ + +4. **实施和风险评估**: + - 技术实施的可行性和风险？ + - 投资需求和预期回报？ + - 组织创新能力和适应性？ + +## ⚙️ **执行协议** + +### Phase 1: 会话检测与初始化 +```bash +# 自动检测活动会话 +CHECK: .workflow/.active-* marker files +IF active_session EXISTS: + session_id = get_active_session() + load_context_from(session_id) +ELSE: + request_user_for_session_creation() +``` + +### Phase 2: 目录结构创建 +```bash +# 创建创新领导分析目录 +mkdir -p .workflow/WFS-{topic-slug}/.brainstorming/innovation-lead/ +``` + +### Phase 3: TodoWrite 初始化 +设置创新领导视角分析的任务跟踪： +```json +[ + {"content": "Initialize innovation lead brainstorming session", "status": "completed", "activeForm": "Initializing session"}, + {"content": "Research emerging technology trends and opportunities", "status": "in_progress", "activeForm": "Researching technology trends"}, + {"content": "Analyze innovation potential and market disruption", "status": "pending", "activeForm": "Analyzing innovation potential"}, + {"content": "Evaluate competitive landscape and positioning", "status": "pending", "activeForm": "Evaluating competitive landscape"}, + {"content": "Design future-oriented solutions and concepts", "status": "pending", "activeForm": "Designing future solutions"}, + {"content": "Assess implementation feasibility and roadmap", "status": "pending", "activeForm": "Assessing implementation"}, + {"content": "Generate comprehensive innovation strategy documentation", "status": "pending", "activeForm": "Generating documentation"} +] +``` + +### Phase 4: 概念规划代理协调 +```bash +Task(conceptual-planning-agent): " +Conduct innovation lead perspective brainstorming for: {topic} + +ROLE CONTEXT: Innovation Lead +- Focus Areas: Emerging technologies, market disruption, future opportunities, innovation strategy +- Analysis Framework: Forward-thinking approach with emphasis on breakthrough innovation and competitive advantage +- Success Metrics: Innovation impact, market differentiation, technology adoption, future readiness + +USER CONTEXT: {captured_user_requirements_from_session} + +ANALYSIS REQUIREMENTS: +1. Emerging Technology Landscape Analysis + - Research current and emerging technology trends relevant to the topic + - Analyze technology maturity levels and adoption curves + - Identify breakthrough technologies with disruptive potential + - Assess technology convergence opportunities and synergies + - Map technology evolution timelines and critical milestones + +2. Innovation Opportunity Assessment + - Identify unmet market needs and whitespace opportunities + - Analyze potential for disruptive innovation vs incremental improvement + - Assess blue ocean market opportunities and new value propositions + - Evaluate cross-industry innovation transfer possibilities + - Identify platform and ecosystem innovation opportunities + +3. Competitive Intelligence and Market Analysis + - Analyze competitor innovation strategies and technology investments + - Identify market leaders and emerging disruptors + - Assess patent landscapes and intellectual property opportunities + - Evaluate startup ecosystem and potential acquisition targets + - Analyze venture capital and funding trends in related areas + +4. Future Scenario Planning + - Design multiple future scenarios based on technology trends + - Create technology roadmaps with short, medium, and long-term horizons + - Identify potential black swan events and wild card scenarios + - Plan for technology convergence and platform shifts + - Design adaptive strategies for uncertain futures + +5. Innovation Concept Development + - Generate breakthrough product and service concepts + - Design minimum viable innovation experiments + - Create proof-of-concept prototyping strategies + - Plan innovation pilot programs and validation approaches + - Design scalable innovation frameworks and processes + +6. Implementation Strategy and Risk Assessment + - Assess organizational innovation readiness and capabilities + - Identify required technology investments and partnerships + - Evaluate risks including technology, market, and execution risks + - Design innovation governance and decision-making frameworks + - Plan talent acquisition and capability building strategies + +OUTPUT REQUIREMENTS: Save comprehensive analysis to: +.workflow/WFS-{topic-slug}/.brainstorming/innovation-lead/ +- analysis.md (main innovation analysis and opportunity assessment) +- technology-roadmap.md (technology trends and future scenarios) +- innovation-concepts.md (breakthrough ideas and concept development) +- strategy-implementation.md (innovation strategy and execution plan) + +Apply innovation leadership expertise to identify breakthrough opportunities and design future-ready strategies." +``` + +## 📊 **输出结构** + +### 保存位置 +``` +.workflow/WFS-{topic-slug}/.brainstorming/innovation-lead/ +├── analysis.md # 主要创新分析和机会评估 +├── technology-roadmap.md # 技术趋势和未来场景 +├── innovation-concepts.md # 突破性想法和概念开发 +└── strategy-implementation.md # 创新策略和执行计划 +``` + +### 文档模板 + +#### analysis.md 结构 +```markdown +# Innovation Lead Analysis: {Topic} +*Generated: {timestamp}* + +## Executive Summary +[核心创新机会和战略建议概述] + +## Technology Landscape Assessment +### Emerging Technologies Overview +### Technology Maturity Analysis +### Convergence Opportunities +### Disruptive Potential Assessment + +## Innovation Opportunity Analysis +### Market Whitespace Identification +### Unmet Needs and Pain Points +### Disruptive Innovation Potential +### Blue Ocean Opportunities + +## Competitive Intelligence +### Competitor Innovation Strategies +### Patent Landscape Analysis +### Startup Ecosystem Insights +### Investment and Funding Trends + +## Future Scenarios and Trends +### Short-term Innovations (0-2 years) +### Medium-term Disruptions (2-5 years) +### Long-term Transformations (5+ years) +### Wild Card Scenarios + +## Innovation Concepts +### Breakthrough Ideas +### Proof-of-Concept Opportunities +### Platform Innovation Possibilities +### Ecosystem Partnership Ideas + +## Strategic Recommendations +### Innovation Investment Priorities +### Technology Partnership Strategy +### Capability Building Requirements +### Risk Mitigation Approaches + +## Implementation Roadmap +### Innovation Pilot Programs +### Technology Validation Milestones +### Scaling and Commercialization Plan +### Success Metrics and KPIs +``` + +## 🔄 **会话集成** + +### 状态同步 +分析完成后，更新 `workflow-session.json`: +```json +{ + "phases": { + "BRAINSTORM": { + "innovation_lead": { + "status": "completed", + "completed_at": "timestamp", + "output_directory": ".workflow/WFS-{topic}/.brainstorming/innovation-lead/", + "key_insights": ["breakthrough_opportunity", "emerging_technology", "disruptive_potential"] + } + } + } +} +``` + +### 与其他角色的协作 +创新领导视角为其他角色提供： +- **创新机会和趋势** → Product Manager +- **新技术可行性** → System Architect +- **未来用户体验趋势** → UI Designer +- **新兴数据技术** → Data Architect +- **创新安全挑战** → Security Expert + +## ✅ **质量标准** + +### 必须包含的创新元素 +- [ ] 全面的技术趋势分析 +- [ ] 明确的创新机会识别 +- [ ] 具体的概念验证方案 +- [ ] 现实的实施路线图 +- [ ] 前瞻性的风险评估 + +### 创新思维原则检查 +- [ ] 前瞻性：关注未来3-10年趋势 +- [ ] 颠覆性：寻找破坏性创新机会 +- [ ] 系统性：考虑技术生态系统影响 +- [ ] 可行性：平衡愿景与现实可能 +- [ ] 差异化：创造独特竞争优势 + +### 创新价值评估 +- [ ] 市场影响的潜在规模 +- [ ] 技术可行性和成熟度 +- [ ] 竞争优势的可持续性 +- [ ] 投资回报的时间框架 +- [ ] 组织实施的复杂度 \ No newline at end of file diff --git a/.claude/commands/workflow/brainstorm/product-manager.md b/.claude/commands/workflow/brainstorm/product-manager.md new file mode 100644 index 00000000..1e9deefe --- /dev/null +++ b/.claude/commands/workflow/brainstorm/product-manager.md @@ -0,0 +1,217 @@ +--- +name: brainstorm:product-manager +description: Product manager perspective brainstorming for user needs and business value analysis +usage: /brainstorm:product-manager +argument-hint: "topic or challenge to analyze from product management perspective" +examples: + - /brainstorm:product-manager "user authentication redesign" + - /brainstorm:product-manager "mobile app performance optimization" + - /brainstorm:product-manager "feature prioritization strategy" +allowed-tools: Task(conceptual-planning-agent), TodoWrite(*) +--- + +## 🎯 **角色定义: Product Manager** + +### 核心职责 +- **用户需求分析**: 深度理解用户痛点和需求 +- **商业价值评估**: 评估功能和改进的商业影响 +- **市场定位**: 分析竞争环境和市场机会 +- **产品战略**: 制定产品路线图和优先级 + +### 关注领域 +- **用户体验**: 用户旅程、满意度、转化率 +- **商业指标**: ROI、用户增长、留存率、收入影响 +- **市场竞争**: 竞品分析、差异化优势、市场趋势 +- **产品生命周期**: 功能演进、技术债务、可维护性 + +## 🧠 **分析框架** + +@~/.claude/workflows/brainstorming-principles.md +@~/.claude/workflows/conceptual-planning-agent.md + +### 核心分析问题 +1. **用户价值**: + - 这个功能/改进解决了什么真实问题？ + - 目标用户群体是谁？他们的核心需求是什么？ + - 用户愿意为此付费/投入时间吗？ + +2. **商业影响**: + - 预期的商业收益是什么？ + - 实施成本vs预期回报如何？ + - 对现有业务流程有何影响？ + +3. **市场机会**: + - 市场上现有解决方案的不足在哪？ + - 我们的差异化优势是什么？ + - 时机是否合适？ + +4. **执行可行性**: + - 所需资源和时间估算？ + - 技术可行性和风险评估？ + - 团队能力匹配度？ + +## ⚙️ **执行协议** + +### Phase 1: 会话检测与初始化 +```bash +# 自动检测活动会话 +CHECK: .workflow/.active-* marker files +IF active_session EXISTS: + session_id = get_active_session() + load_context_from(session_id) +ELSE: + request_user_for_session_creation() +``` + +### Phase 2: 目录结构创建 +```bash +# 创建产品经理分析目录 +mkdir -p .workflow/WFS-{topic-slug}/.brainstorming/product-manager/ +``` + +### Phase 3: TodoWrite 初始化 +设置产品经理视角分析的任务跟踪： +```json +[ + {"content": "Initialize product manager brainstorming session", "status": "completed", "activeForm": "Initializing session"}, + {"content": "Analyze user needs and pain points", "status": "in_progress", "activeForm": "Analyzing user needs"}, + {"content": "Evaluate business value and impact", "status": "pending", "activeForm": "Evaluating business impact"}, + {"content": "Assess market opportunities", "status": "pending", "activeForm": "Assessing market opportunities"}, + {"content": "Develop product strategy recommendations", "status": "pending", "activeForm": "Developing strategy"}, + {"content": "Create prioritized action plan", "status": "pending", "activeForm": "Creating action plan"}, + {"content": "Generate comprehensive product analysis", "status": "pending", "activeForm": "Generating analysis"} +] +``` + +### Phase 4: 概念规划代理协调 +```bash +Task(conceptual-planning-agent): " +Conduct product management perspective brainstorming for: {topic} + +ROLE CONTEXT: Product Manager +- Focus Areas: User needs, business value, market positioning, product strategy +- Analysis Framework: User-centric approach with business impact assessment +- Success Metrics: User satisfaction, business growth, market differentiation + +USER CONTEXT: {captured_user_requirements_from_session} + +ANALYSIS REQUIREMENTS: +1. User Needs Analysis + - Identify core user problems and pain points + - Define target user segments and personas + - Map user journey and experience gaps + - Prioritize user requirements by impact and frequency + +2. Business Value Assessment + - Quantify potential business impact (revenue, growth, efficiency) + - Analyze cost-benefit ratio and ROI projections + - Identify key success metrics and KPIs + - Assess risk factors and mitigation strategies + +3. Market Opportunity Analysis + - Competitive landscape and gap analysis + - Market trends and emerging opportunities + - Differentiation strategies and unique value propositions + - Go-to-market considerations + +4. Product Strategy Development + - Feature prioritization matrix + - Product roadmap recommendations + - Resource allocation strategies + - Implementation timeline and milestones + +OUTPUT REQUIREMENTS: Save comprehensive analysis to: +.workflow/WFS-{topic-slug}/.brainstorming/product-manager/ +- analysis.md (main product management analysis) +- business-case.md (business justification and metrics) +- user-research.md (user needs and market insights) +- roadmap.md (strategic recommendations and timeline) + +Apply product management expertise to generate actionable insights addressing business goals and user needs." +``` + +## 📊 **输出结构** + +### 保存位置 +``` +.workflow/WFS-{topic-slug}/.brainstorming/product-manager/ +├── analysis.md # 主要产品分析 +├── business-case.md # 商业论证和指标 +├── user-research.md # 用户研究和市场洞察 +└── roadmap.md # 战略建议和时间线 +``` + +### 文档模板 + +#### analysis.md 结构 +```markdown +# Product Manager Analysis: {Topic} +*Generated: {timestamp}* + +## Executive Summary +[核心发现和建议概述] + +## User Needs Analysis +### Target User Segments +### Core Problems Identified +### User Journey Mapping +### Priority Requirements + +## Business Impact Assessment +### Revenue Impact +### Cost Analysis +### ROI Projections +### Risk Assessment + +## Competitive Analysis +### Market Position +### Differentiation Opportunities +### Competitive Advantages + +## Strategic Recommendations +### Immediate Actions (0-3 months) +### Medium-term Initiatives (3-12 months) +### Long-term Vision (12+ months) +``` + +## 🔄 **会话集成** + +### 状态同步 +分析完成后，更新 `workflow-session.json`: +```json +{ + "phases": { + "BRAINSTORM": { + "product_manager": { + "status": "completed", + "completed_at": "timestamp", + "output_directory": ".workflow/WFS-{topic}/.brainstorming/product-manager/", + "key_insights": ["insight1", "insight2", "insight3"] + } + } + } +} +``` + +### 与其他角色的协作 +产品经理视角为其他角色提供： +- **用户需求定义** → UI Designer +- **业务约束和目标** → System Architect +- **功能优先级** → Feature Planner +- **市场要求** → Innovation Lead + +## ✅ **质量标准** + +### 必须包含的分析元素 +- [ ] 明确的用户价值主张 +- [ ] 量化的业务影响评估 +- [ ] 可执行的产品策略建议 +- [ ] 基于数据的优先级排序 +- [ ] 清晰的成功指标定义 + +### 输出质量检查 +- [ ] 分析基于真实用户需求 +- [ ] 商业论证逻辑清晰 +- [ ] 建议具有可操作性 +- [ ] 时间线合理可行 +- [ ] 风险识别全面准确 \ No newline at end of file diff --git a/.claude/commands/workflow/brainstorm/security-expert.md b/.claude/commands/workflow/brainstorm/security-expert.md new file mode 100644 index 00000000..10af2a28 --- /dev/null +++ b/.claude/commands/workflow/brainstorm/security-expert.md @@ -0,0 +1,261 @@ +--- +name: brainstorm:security-expert +description: Security expert perspective brainstorming for threat modeling and security architecture analysis +usage: /brainstorm:security-expert +argument-hint: "topic or challenge to analyze from security perspective" +examples: + - /brainstorm:security-expert "user authentication security" + - /brainstorm:security-expert "API security architecture" + - /brainstorm:security-expert "data privacy compliance" +allowed-tools: Task(conceptual-planning-agent), TodoWrite(*) +--- + +## 🔒 **角色定义: Security Expert** + +### 核心职责 +- **威胁建模**: 识别和评估安全威胁和攻击向量 +- **安全架构**: 设计防御性安全控制和保护机制 +- **合规评估**: 确保符合安全标准和法规要求 +- **风险管理**: 评估和缓解安全风险 + +### 关注领域 +- **应用安全**: 代码安全、输入验证、会话管理 +- **基础设施安全**: 网络安全、服务器加固、云安全 +- **数据保护**: 数据加密、访问控制、隐私保护 +- **合规管理**: GDPR、SOC2、ISO27001、行业标准 + +## 🧠 **分析框架** + +@~/.claude/workflows/brainstorming-principles.md +@~/.claude/workflows/conceptual-planning-agent.md + +### 核心分析问题 +1. **威胁识别和建模**: + - 主要的安全威胁和攻击向量是什么？ + - 资产价值和风险评估？ + - 攻击者画像和攻击路径分析？ + +2. **安全控制和防护**: + - 需要实施哪些安全控制？ + - 身份认证和授权机制？ + - 数据保护和加密策略？ + +3. **合规和标准**: + - 适用的合规要求和标准？ + - 安全审计和监控需求？ + - 事件响应和恢复计划？ + +4. **风险评估和缓解**: + - 安全风险等级和影响评估？ + - 风险缓解策略和优先级？ + - 持续监控和改进机制？ + +## ⚙️ **执行协议** + +### Phase 1: 会话检测与初始化 +```bash +# 自动检测活动会话 +CHECK: .workflow/.active-* marker files +IF active_session EXISTS: + session_id = get_active_session() + load_context_from(session_id) +ELSE: + request_user_for_session_creation() +``` + +### Phase 2: 目录结构创建 +```bash +# 创建安全专家分析目录 +mkdir -p .workflow/WFS-{topic-slug}/.brainstorming/security-expert/ +``` + +### Phase 3: TodoWrite 初始化 +设置安全专家视角分析的任务跟踪： +```json +[ + {"content": "Initialize security expert brainstorming session", "status": "completed", "activeForm": "Initializing session"}, + {"content": "Conduct threat modeling and risk assessment", "status": "in_progress", "activeForm": "Conducting threat modeling"}, + {"content": "Design security architecture and controls", "status": "pending", "activeForm": "Designing security architecture"}, + {"content": "Evaluate compliance requirements", "status": "pending", "activeForm": "Evaluating compliance"}, + {"content": "Plan incident response and monitoring", "status": "pending", "activeForm": "Planning incident response"}, + {"content": "Assess data protection and privacy", "status": "pending", "activeForm": "Assessing data protection"}, + {"content": "Generate comprehensive security documentation", "status": "pending", "activeForm": "Generating documentation"} +] +``` + +### Phase 4: 概念规划代理协调 +```bash +Task(conceptual-planning-agent): " +Conduct security expert perspective brainstorming for: {topic} + +ROLE CONTEXT: Security Expert +- Focus Areas: Threat modeling, security architecture, compliance, risk management +- Analysis Framework: Defense-in-depth approach with risk-based security controls +- Success Metrics: Threat coverage, vulnerability reduction, compliance adherence, incident response time + +USER CONTEXT: {captured_user_requirements_from_session} + +ANALYSIS REQUIREMENTS: +1. Threat Modeling and Risk Assessment + - Identify threat actors and attack vectors + - Analyze attack surfaces and entry points + - Assess asset value and potential impact + - Create threat model diagrams and scenarios + - Evaluate existing security posture and gaps + +2. Security Architecture Design + - Design authentication and authorization mechanisms + - Plan encryption strategies for data at rest and in transit + - Design network security and segmentation + - Plan secure communication protocols and APIs + - Design security monitoring and logging architecture + +3. Application Security Assessment + - Analyze input validation and sanitization requirements + - Assess session management and CSRF protection + - Evaluate SQL injection and XSS vulnerabilities + - Plan secure coding practices and code review processes + - Design security testing and penetration testing strategies + +4. Compliance and Regulatory Requirements + - Assess applicable regulations (GDPR, CCPA, HIPAA, PCI-DSS, etc.) + - Map compliance requirements to security controls + - Plan audit trails and documentation requirements + - Design privacy impact assessments + - Plan compliance monitoring and reporting + +5. Incident Response and Recovery + - Design security incident detection and alerting + - Plan incident response procedures and escalation + - Design forensic analysis and evidence collection + - Plan business continuity and disaster recovery + - Design security awareness and training programs + +6. Data Protection and Privacy + - Design data classification and handling procedures + - Plan data retention and disposal strategies + - Assess third-party data sharing risks + - Design privacy controls and user consent management + - Plan data breach notification procedures + +OUTPUT REQUIREMENTS: Save comprehensive analysis to: +.workflow/WFS-{topic-slug}/.brainstorming/security-expert/ +- analysis.md (main security analysis and threat model) +- security-architecture.md (detailed security controls and architecture) +- compliance-framework.md (regulatory requirements and compliance plan) +- incident-response.md (security incident management and recovery procedures) + +Apply security expertise to create robust, compliant, and resilient security solutions." +``` + +## 📊 **输出结构** + +### 保存位置 +``` +.workflow/WFS-{topic-slug}/.brainstorming/security-expert/ +├── analysis.md # 主要安全分析和威胁建模 +├── security-architecture.md # 详细安全控制和架构 +├── compliance-framework.md # 法规要求和合规计划 +└── incident-response.md # 安全事件管理和恢复程序 +``` + +### 文档模板 + +#### analysis.md 结构 +```markdown +# Security Expert Analysis: {Topic} +*Generated: {timestamp}* + +## Executive Summary +[核心安全发现和建议概述] + +## Threat Modeling +### Threat Actors +- Internal threats: [内部威胁分析] +- External threats: [外部威胁分析] +- Threat capabilities and motivations + +### Attack Vectors +### Attack Surface Analysis +### Risk Assessment Matrix + +## Current Security Posture +### Existing Security Controls +### Identified Vulnerabilities +### Security Gaps and Weaknesses +### Compliance Status + +## Security Architecture Recommendations +### Authentication and Authorization +### Data Protection Strategy +### Network Security Design +### Application Security Controls + +## Risk Management +### Critical Risks Identified +### Risk Mitigation Strategies +### Security Control Prioritization +### Residual Risk Assessment + +## Compliance Requirements +### Applicable Regulations +### Compliance Gaps +### Required Documentation +### Audit Preparation + +## Implementation Roadmap +### Immediate Security Actions (0-30 days) +### Short-term Improvements (1-6 months) +### Long-term Security Strategy (6+ months) +### Success Metrics and KPIs +``` + +## 🔄 **会话集成** + +### 状态同步 +分析完成后，更新 `workflow-session.json`: +```json +{ + "phases": { + "BRAINSTORM": { + "security_expert": { + "status": "completed", + "completed_at": "timestamp", + "output_directory": ".workflow/WFS-{topic}/.brainstorming/security-expert/", + "key_insights": ["critical_vulnerability", "compliance_requirement", "security_control"] + } + } + } +} +``` + +### 与其他角色的协作 +安全专家视角为其他角色提供： +- **安全要求和约束** → System Architect +- **安全合规影响** → Product Manager +- **安全用户体验** → UI Designer +- **数据安全要求** → Data Architect +- **安全功能需求** → Feature Planner + +## ✅ **质量标准** + +### 必须包含的安全元素 +- [ ] 全面的威胁模型和风险评估 +- [ ] 详细的安全架构和控制设计 +- [ ] 合规要求映射和实施计划 +- [ ] 事件响应和恢复程序 +- [ ] 安全监控和测试策略 + +### 安全框架检查 +- [ ] 防御深度：多层安全控制 +- [ ] 最小权限：访问控制最小化 +- [ ] 失败安全：安全失败时的默认行为 +- [ ] 完整监控：全面的安全日志和告警 +- [ ] 持续改进：定期安全评估和更新 + +### 威胁覆盖验证 +- [ ] OWASP Top 10 威胁评估 +- [ ] 内部和外部威胁分析 +- [ ] 供应链安全风险 +- [ ] 云安全和配置管理 +- [ ] 隐私和数据保护合规 \ No newline at end of file diff --git a/.claude/commands/workflow/brainstorm/synthesis.md b/.claude/commands/workflow/brainstorm/synthesis.md new file mode 100644 index 00000000..5d9d5122 --- /dev/null +++ b/.claude/commands/workflow/brainstorm/synthesis.md @@ -0,0 +1,299 @@ +--- +name: brainstorm:synthesis +description: Synthesize all brainstorming role perspectives into comprehensive analysis and recommendations +usage: /brainstorm:synthesis +argument-hint: "no arguments required - analyzes existing brainstorming session outputs" +examples: + - /brainstorm:synthesis +allowed-tools: Read(*), Write(*), TodoWrite(*), Glob(*) +--- + +## 🧩 **命令定义: Brainstorm Synthesis** + +### 核心功能 +- **跨角色综合**: 整合所有角色的头脑风暴分析结果 +- **洞察提炼**: 识别共识点、分歧点和创新机会 +- **决策支持**: 生成优先级建议和行动计划 +- **报告生成**: 创建综合性的头脑风暴总结报告 + +### 分析范围 +- **产品管理**: 用户需求、商业价值、市场机会 +- **技术架构**: 系统设计、技术选型、实施可行性 +- **用户体验**: 界面设计、可用性、可访问性 +- **数据架构**: 数据模型、处理流程、分析能力 +- **安全专家**: 威胁评估、安全控制、合规要求 +- **用户研究**: 行为洞察、需求验证、体验优化 +- **业务分析**: 流程优化、成本效益、变更管理 +- **创新领导**: 技术趋势、创新机会、未来规划 +- **功能规划**: 开发计划、质量保证、交付管理 + +## ⚙️ **执行协议** + +### Phase 1: 会话检测与数据收集 +```bash +# 自动检测活动会话 +CHECK: .workflow/.active-* marker files +IF active_session EXISTS: + session_id = get_active_session() + load_context_from(session_id) +ELSE: + ERROR: "No active brainstorming session found. Please run role-specific brainstorming commands first." + EXIT +``` + +### Phase 2: 角色输出扫描 +```bash +# 扫描所有角色的头脑风暴输出 +SCAN_DIRECTORY: .workflow/WFS-{session}/.brainstorming/ +COLLECT_OUTPUTS: [ + product-manager/analysis.md, + system-architect/analysis.md, + ui-designer/analysis.md, + data-architect/analysis.md, + security-expert/analysis.md, + user-researcher/analysis.md, + business-analyst/analysis.md, + innovation-lead/analysis.md, + feature-planner/analysis.md +] +``` + +### Phase 3: TodoWrite 初始化 +设置综合分析任务跟踪： +```json +[ + {"content": "Initialize synthesis brainstorming session", "status": "completed", "activeForm": "Initializing synthesis"}, + {"content": "Collect and analyze all role perspectives", "status": "in_progress", "activeForm": "Collecting role analyses"}, + {"content": "Identify cross-role insights and patterns", "status": "pending", "activeForm": "Identifying insights"}, + {"content": "Generate consensus and disagreement analysis", "status": "pending", "activeForm": "Analyzing consensus"}, + {"content": "Create prioritized recommendations matrix", "status": "pending", "activeForm": "Creating recommendations"}, + {"content": "Generate comprehensive synthesis report", "status": "pending", "activeForm": "Generating synthesis report"}, + {"content": "Create action plan with implementation priorities", "status": "pending", "activeForm": "Creating action plan"} +] +``` + +### Phase 4: 综合分析执行 + +#### 4.1 数据收集和预处理 +```pseudo +FOR each role_directory in brainstorming_roles: + IF role_directory exists: + role_analysis = Read(role_directory + "/analysis.md") + role_recommendations = Read(role_directory + "/recommendations.md") IF EXISTS + role_insights[role] = extract_key_insights(role_analysis) + role_recommendations[role] = extract_recommendations(role_analysis) + role_concerns[role] = extract_concerns_risks(role_analysis) + END IF +END FOR +``` + +#### 4.2 跨角色洞察分析 +```pseudo +# 共识点识别 +consensus_areas = identify_common_themes(role_insights) +agreement_matrix = create_agreement_matrix(role_recommendations) + +# 分歧点分析 +disagreement_areas = identify_conflicting_views(role_insights) +tension_points = analyze_role_conflicts(role_recommendations) + +# 创新机会提取 +innovation_opportunities = extract_breakthrough_ideas(role_insights) +synergy_opportunities = identify_cross_role_synergies(role_insights) +``` + +#### 4.3 优先级和决策矩阵生成 +```pseudo +# 创建综合评估矩阵 +FOR each recommendation: + impact_score = calculate_business_impact(recommendation, role_insights) + feasibility_score = calculate_technical_feasibility(recommendation, role_insights) + effort_score = calculate_implementation_effort(recommendation, role_insights) + risk_score = calculate_associated_risks(recommendation, role_insights) + + priority_score = weighted_score(impact_score, feasibility_score, effort_score, risk_score) +END FOR + +SORT recommendations BY priority_score DESC +``` + +## 📊 **输出结构** + +### 保存位置 +``` +.workflow/WFS-{topic-slug}/.brainstorming/ +├── synthesis-report.md # 综合分析报告 +├── recommendations-matrix.md # 优先级推荐矩阵 +├── action-plan.md # 实施行动计划 +├── consensus-analysis.md # 共识和分歧分析 +└── brainstorm-summary.json # 机器可读的综合数据 +``` + +### 核心输出文档 + +#### synthesis-report.md 结构 +```markdown +# Brainstorming Synthesis Report: {Topic} +*Generated: {timestamp} | Session: WFS-{topic-slug}* + +## Executive Summary +### Key Findings Overview +### Strategic Recommendations +### Implementation Priority +### Success Metrics + +## Participating Perspectives Analysis +### Roles Analyzed: {list_of_completed_roles} +### Coverage Assessment: {completeness_percentage}% +### Analysis Quality Score: {quality_assessment} + +## Cross-Role Insights Synthesis + +### 🤝 Consensus Areas +**Strong Agreement (3+ roles)**: +1. **{consensus_theme_1}** + - Supporting roles: {role1, role2, role3} + - Key insight: {shared_understanding} + - Business impact: {impact_assessment} + +2. **{consensus_theme_2}** + - Supporting roles: {role1, role2, role4} + - Key insight: {shared_understanding} + - Business impact: {impact_assessment} + +### ⚡ Breakthrough Ideas +**Innovation Opportunities**: +1. **{breakthrough_idea_1}** + - Origin: {source_role} + - Cross-role support: {supporting_roles} + - Innovation potential: {potential_assessment} + +2. **{breakthrough_idea_2}** + - Origin: {source_role} + - Cross-role support: {supporting_roles} + - Innovation potential: {potential_assessment} + +### 🔄 Areas of Disagreement +**Tension Points Requiring Resolution**: +1. **{disagreement_area_1}** + - Conflicting views: {role1_view} vs {role2_view} + - Root cause: {underlying_issue} + - Resolution approach: {recommended_resolution} + +2. **{disagreement_area_2}** + - Conflicting views: {role1_view} vs {role2_view} + - Root cause: {underlying_issue} + - Resolution approach: {recommended_resolution} + +## Comprehensive Recommendations Matrix + +### 🎯 High Priority (Immediate Action) +| Recommendation | Business Impact | Technical Feasibility | Implementation Effort | Risk Level | Supporting Roles | +|----------------|-----------------|----------------------|---------------------|------------|------------------| +| {rec_1} | High | High | Medium | Low | PM, Arch, UX | +| {rec_2} | High | Medium | Low | Medium | BA, PM, FP | + +### 📋 Medium Priority (Strategic Planning) +| Recommendation | Business Impact | Technical Feasibility | Implementation Effort | Risk Level | Supporting Roles | +|----------------|-----------------|----------------------|---------------------|------------|------------------| +| {rec_3} | Medium | High | High | Medium | Arch, DA, Sec | +| {rec_4} | Medium | Medium | Medium | Low | UX, UR, PM | + +### 🔬 Research Priority (Future Investigation) +| Recommendation | Business Impact | Technical Feasibility | Implementation Effort | Risk Level | Supporting Roles | +|----------------|-----------------|----------------------|---------------------|------------|------------------| +| {rec_5} | High | Unknown | High | High | IL, Arch, PM | +| {rec_6} | Medium | Low | High | High | IL, DA, Sec | + +## Implementation Strategy + +### Phase 1: Foundation (0-3 months) +- **Focus**: High-priority, low-effort recommendations +- **Key Actions**: {action_list} +- **Success Metrics**: {metrics_list} +- **Required Resources**: {resource_list} + +### Phase 2: Development (3-9 months) +- **Focus**: Medium-priority strategic initiatives +- **Key Actions**: {action_list} +- **Success Metrics**: {metrics_list} +- **Required Resources**: {resource_list} + +### Phase 3: Innovation (9+ months) +- **Focus**: Research and breakthrough opportunities +- **Key Actions**: {action_list} +- **Success Metrics**: {metrics_list} +- **Required Resources**: {resource_list} + +## Risk Assessment and Mitigation + +### Critical Risks Identified +1. **{risk_1}**: {description} | Mitigation: {strategy} +2. **{risk_2}**: {description} | Mitigation: {strategy} + +### Success Factors +- {success_factor_1} +- {success_factor_2} +- {success_factor_3} + +## Next Steps and Follow-up +### Immediate Actions Required +### Decision Points Needing Resolution +### Continuous Monitoring Requirements +### Future Brainstorming Sessions Recommended + +--- +*This synthesis integrates insights from {role_count} perspectives to provide comprehensive strategic guidance.* +``` + +## 🔄 **会话集成** + +### 状态同步 +综合分析完成后，更新 `workflow-session.json`: +```json +{ + "phases": { + "BRAINSTORM": { + "status": "completed", + "synthesis_completed": true, + "completed_at": "timestamp", + "participating_roles": ["product-manager", "system-architect", "ui-designer", ...], + "key_outputs": { + "synthesis_report": ".workflow/WFS-{topic}/.brainstorming/synthesis-report.md", + "action_plan": ".workflow/WFS-{topic}/.brainstorming/action-plan.md", + "recommendations_matrix": ".workflow/WFS-{topic}/.brainstorming/recommendations-matrix.md" + }, + "metrics": { + "roles_analyzed": 9, + "consensus_areas": 5, + "breakthrough_ideas": 3, + "high_priority_recommendations": 8, + "implementation_phases": 3 + } + } + } +} +``` + +## ✅ **质量标准** + +### 必须包含的综合元素 +- [ ] 所有可用角色分析的整合 +- [ ] 明确的共识和分歧识别 +- [ ] 量化的优先级推荐矩阵 +- [ ] 可执行的实施计划 +- [ ] 全面的风险评估和缓解 + +### 综合分析质量检查 +- [ ] **完整性**: 整合所有可用的角色分析 +- [ ] **洞察力**: 识别跨角色的深层次模式 +- [ ] **可操作性**: 提供具体可执行的建议 +- [ ] **平衡性**: 考虑所有角色的观点和关切 +- [ ] **前瞻性**: 包含长期战略和创新考量 + +### 输出验证标准 +- [ ] 推荐优先级基于多维度评估 +- [ ] 实施计划考虑资源和时间约束 +- [ ] 风险评估全面且有缓解策略 +- [ ] 成功指标明确可测量 +- [ ] 后续行动清晰具体 \ No newline at end of file diff --git a/.claude/commands/workflow/brainstorm/system-architect.md b/.claude/commands/workflow/brainstorm/system-architect.md new file mode 100644 index 00000000..4bb06367 --- /dev/null +++ b/.claude/commands/workflow/brainstorm/system-architect.md @@ -0,0 +1,241 @@ +--- +name: brainstorm:system-architect +description: System architect perspective brainstorming for technical architecture and scalability analysis +usage: /brainstorm:system-architect +argument-hint: "topic or challenge to analyze from system architecture perspective" +examples: + - /brainstorm:system-architect "user authentication redesign" + - /brainstorm:system-architect "microservices migration strategy" + - /brainstorm:system-architect "system performance optimization" +allowed-tools: Task(conceptual-planning-agent), TodoWrite(*) +--- + +## 🏗️ **角色定义: System Architect** + +### 核心职责 +- **技术架构设计**: 设计可扩展、可维护的系统架构 +- **技术选型**: 评估和选择合适的技术栈和工具 +- **系统集成**: 设计系统间的集成和通信机制 +- **性能优化**: 识别性能瓶颈并提出优化方案 + +### 关注领域 +- **可扩展性**: 系统容量规划、负载处理、弹性扩展 +- **可靠性**: 高可用性、容错设计、灾难恢复 +- **安全性**: 架构安全、数据保护、访问控制 +- **维护性**: 代码质量、模块化设计、技术债务管理 + +## 🧠 **分析框架** + +@~/.claude/workflows/brainstorming-principles.md +@~/.claude/workflows/conceptual-planning-agent.md + +### 核心分析问题 +1. **架构设计**: + - 当前架构的优势和局限性是什么？ + - 如何设计满足业务需求的技术架构？ + - 微服务vs单体架构的权衡？ + +2. **技术选型**: + - 哪些技术栈最适合当前需求？ + - 新技术的引入风险和收益？ + - 团队技术能力与选型的匹配度？ + +3. **系统集成**: + - 系统间如何高效集成和通信？ + - 第三方服务集成策略？ + - API设计和版本管理？ + +4. **性能和扩展**: + - 系统性能瓶颈在哪里？ + - 如何应对流量增长？ + - 数据库扩展和优化策略？ + +## ⚙️ **执行协议** + +### Phase 1: 会话检测与初始化 +```bash +# 自动检测活动会话 +CHECK: .workflow/.active-* marker files +IF active_session EXISTS: + session_id = get_active_session() + load_context_from(session_id) +ELSE: + request_user_for_session_creation() +``` + +### Phase 2: 目录结构创建 +```bash +# 创建系统架构师分析目录 +mkdir -p .workflow/WFS-{topic-slug}/.brainstorming/system-architect/ +``` + +### Phase 3: TodoWrite 初始化 +设置系统架构师视角分析的任务跟踪： +```json +[ + {"content": "Initialize system architect brainstorming session", "status": "completed", "activeForm": "Initializing session"}, + {"content": "Analyze current system architecture", "status": "in_progress", "activeForm": "Analyzing architecture"}, + {"content": "Evaluate technical requirements and constraints", "status": "pending", "activeForm": "Evaluating requirements"}, + {"content": "Design optimal system architecture", "status": "pending", "activeForm": "Designing architecture"}, + {"content": "Assess scalability and performance", "status": "pending", "activeForm": "Assessing scalability"}, + {"content": "Plan technology stack and integration", "status": "pending", "activeForm": "Planning technology"}, + {"content": "Generate comprehensive architecture documentation", "status": "pending", "activeForm": "Generating documentation"} +] +``` + +### Phase 4: 概念规划代理协调 +```bash +Task(conceptual-planning-agent): " +Conduct system architecture perspective brainstorming for: {topic} + +ROLE CONTEXT: System Architect +- Focus Areas: Technical architecture, scalability, system integration, performance +- Analysis Framework: Architecture-first approach with scalability and maintainability focus +- Success Metrics: System performance, availability, maintainability, technical debt reduction + +USER CONTEXT: {captured_user_requirements_from_session} + +ANALYSIS REQUIREMENTS: +1. Current Architecture Assessment + - Analyze existing system architecture and identify pain points + - Evaluate current technology stack effectiveness + - Assess technical debt and maintenance overhead + - Identify architectural bottlenecks and limitations + +2. Requirements and Constraints Analysis + - Define functional and non-functional requirements + - Identify performance, scalability, and availability requirements + - Analyze security and compliance constraints + - Assess resource and budget limitations + +3. Architecture Design and Strategy + - Design optimal system architecture for the given requirements + - Recommend technology stack and architectural patterns + - Plan for microservices vs monolithic architecture decisions + - Design data architecture and storage strategies + +4. Integration and Scalability Planning + - Design system integration patterns and APIs + - Plan for horizontal and vertical scaling strategies + - Design monitoring, logging, and observability systems + - Plan deployment and DevOps strategies + +5. Risk Assessment and Mitigation + - Identify technical risks and failure points + - Design fault tolerance and disaster recovery strategies + - Plan for security vulnerabilities and mitigations + - Assess migration risks and strategies + +OUTPUT REQUIREMENTS: Save comprehensive analysis to: +.workflow/WFS-{topic-slug}/.brainstorming/system-architect/ +- analysis.md (main architecture analysis) +- architecture-design.md (detailed system design and diagrams) +- technology-stack.md (technology recommendations and justifications) +- integration-plan.md (system integration and API strategies) + +Apply system architecture expertise to generate scalable, maintainable, and performant solutions." +``` + +## 📊 **输出结构** + +### 保存位置 +``` +.workflow/WFS-{topic-slug}/.brainstorming/system-architect/ +├── analysis.md # 主要架构分析 +├── architecture-design.md # 详细系统设计和图表 +├── technology-stack.md # 技术栈建议和理由 +└── integration-plan.md # 系统集成和API策略 +``` + +### 文档模板 + +#### analysis.md 结构 +```markdown +# System Architecture Analysis: {Topic} +*Generated: {timestamp}* + +## Executive Summary +[核心架构发现和建议概述] + +## Current State Assessment +### Existing Architecture Overview +### Technical Stack Analysis +### Performance Bottlenecks +### Technical Debt Assessment + +## Requirements Analysis +### Functional Requirements +### Non-Functional Requirements +- Performance: [响应时间、吞吐量要求] +- Scalability: [用户量、数据量增长预期] +- Availability: [可用性要求] +- Security: [安全要求] + +## Proposed Architecture +### High-Level Architecture Design +### Component Breakdown +### Data Flow Diagrams +### Technology Stack Recommendations + +## Implementation Strategy +### Migration Planning +### Risk Mitigation +### Performance Optimization +### Security Considerations + +## Scalability and Maintenance +### Horizontal Scaling Strategy +### Monitoring and Observability +### Deployment Strategy +### Long-term Maintenance Plan +``` + +## 🔄 **会话集成** + +### 状态同步 +分析完成后，更新 `workflow-session.json`: +```json +{ + "phases": { + "BRAINSTORM": { + "system_architect": { + "status": "completed", + "completed_at": "timestamp", + "output_directory": ".workflow/WFS-{topic}/.brainstorming/system-architect/", + "key_insights": ["scalability_bottleneck", "architecture_pattern", "technology_recommendation"] + } + } + } +} +``` + +### 与其他角色的协作 +系统架构师视角为其他角色提供： +- **技术约束和可能性** → Product Manager +- **架构要求和限制** → UI Designer +- **数据架构需求** → Data Architect +- **安全架构框架** → Security Expert +- **技术实现框架** → Feature Planner + +## ✅ **质量标准** + +### 必须包含的分析元素 +- [ ] 清晰的架构图和组件设计 +- [ ] 详细的技术栈评估和推荐 +- [ ] 可扩展性和性能分析 +- [ ] 系统集成和API设计 +- [ ] 风险评估和缓解策略 + +### 架构设计原则检查 +- [ ] 可扩展性：系统能够处理增长 +- [ ] 可维护性：代码结构清晰，易于修改 +- [ ] 可靠性：具有容错和恢复机制 +- [ ] 安全性：内置安全控制和保护 +- [ ] 性能优化：满足响应时间和吞吐量要求 + +### 技术决策验证 +- [ ] 技术选型有充分理由和对比分析 +- [ ] 架构模式适合业务需求 +- [ ] 集成方案考虑了兼容性和维护成本 +- [ ] 部署策略可行且风险可控 +- [ ] 监控和运维策略完整 \ No newline at end of file diff --git a/.claude/commands/workflow/brainstorm/ui-designer.md b/.claude/commands/workflow/brainstorm/ui-designer.md new file mode 100644 index 00000000..5a311dd2 --- /dev/null +++ b/.claude/commands/workflow/brainstorm/ui-designer.md @@ -0,0 +1,251 @@ +--- +name: brainstorm:ui-designer +description: UI designer perspective brainstorming for user experience and interface design analysis +usage: /brainstorm:ui-designer +argument-hint: "topic or challenge to analyze from UI/UX design perspective" +examples: + - /brainstorm:ui-designer "user authentication redesign" + - /brainstorm:ui-designer "mobile app navigation improvement" + - /brainstorm:ui-designer "accessibility enhancement strategy" +allowed-tools: Task(conceptual-planning-agent), TodoWrite(*) +--- + +## 🎨 **角色定义: UI Designer** + +### 核心职责 +- **用户体验设计**: 创造直观、高效的用户体验 +- **界面设计**: 设计美观、功能性的用户界面 +- **交互设计**: 设计流畅的用户交互流程 +- **可访问性设计**: 确保产品对所有用户友好 + +### 关注领域 +- **用户体验**: 用户旅程、易用性、满意度、转化率 +- **视觉设计**: 界面美学、品牌一致性、视觉层次 +- **交互设计**: 操作流程、反馈机制、响应性能 +- **可访问性**: WCAG标准、无障碍设计、包容性设计 + +## 🧠 **分析框架** + +@~/.claude/workflows/brainstorming-principles.md +@~/.claude/workflows/conceptual-planning-agent.md + +### 核心分析问题 +1. **用户需求和行为**: + - 用户在使用过程中的主要痛点是什么？ + - 用户的期望和实际体验之间的差距？ + - 不同用户群体的特殊需求？ + +2. **界面和交互设计**: + - 如何简化操作流程？ + - 界面信息架构是否合理？ + - 交互反馈是否及时和清晰？ + +3. **视觉和品牌**: + - 视觉设计是否支持品牌形象？ + - 颜色、字体、布局的合理性？ + - 跨平台一致性如何保证？ + +4. **技术和实现**: + - 设计的技术可行性？ + - 响应式设计要求？ + - 性能对用户体验的影响？ + +## ⚙️ **执行协议** + +### Phase 1: 会话检测与初始化 +```bash +# 自动检测活动会话 +CHECK: .workflow/.active-* marker files +IF active_session EXISTS: + session_id = get_active_session() + load_context_from(session_id) +ELSE: + request_user_for_session_creation() +``` + +### Phase 2: 目录结构创建 +```bash +# 创建UI设计师分析目录 +mkdir -p .workflow/WFS-{topic-slug}/.brainstorming/ui-designer/ +``` + +### Phase 3: TodoWrite 初始化 +设置UI设计师视角分析的任务跟踪： +```json +[ + {"content": "Initialize UI designer brainstorming session", "status": "completed", "activeForm": "Initializing session"}, + {"content": "Analyze current user experience and pain points", "status": "in_progress", "activeForm": "Analyzing user experience"}, + {"content": "Design user journey and interaction flows", "status": "pending", "activeForm": "Designing user flows"}, + {"content": "Create visual design concepts and mockups", "status": "pending", "activeForm": "Creating visual concepts"}, + {"content": "Evaluate accessibility and usability", "status": "pending", "activeForm": "Evaluating accessibility"}, + {"content": "Plan responsive design strategy", "status": "pending", "activeForm": "Planning responsive design"}, + {"content": "Generate comprehensive UI/UX documentation", "status": "pending", "activeForm": "Generating documentation"} +] +``` + +### Phase 4: 概念规划代理协调 +```bash +Task(conceptual-planning-agent): " +Conduct UI designer perspective brainstorming for: {topic} + +ROLE CONTEXT: UI Designer +- Focus Areas: User experience, interface design, visual design, accessibility +- Analysis Framework: User-centered design approach with emphasis on usability and accessibility +- Success Metrics: User satisfaction, task completion rates, accessibility compliance, visual appeal + +USER CONTEXT: {captured_user_requirements_from_session} + +ANALYSIS REQUIREMENTS: +1. User Experience Analysis + - Identify current UX pain points and friction areas + - Map user journeys and identify optimization opportunities + - Analyze user behavior patterns and preferences + - Evaluate task completion flows and success rates + +2. Interface Design Assessment + - Review current interface design and information architecture + - Identify visual hierarchy and navigation issues + - Assess consistency across different screens and states + - Evaluate mobile and desktop interface differences + +3. Visual Design Strategy + - Develop visual design concepts aligned with brand guidelines + - Create color schemes, typography, and spacing systems + - Design iconography and visual elements + - Plan for dark mode and theme variations + +4. Interaction Design Planning + - Design micro-interactions and animation strategies + - Plan feedback mechanisms and loading states + - Create error handling and validation UX + - Design responsive behavior and breakpoints + +5. Accessibility and Inclusion + - Evaluate WCAG 2.1 compliance requirements + - Design for screen readers and assistive technologies + - Plan for color blindness and visual impairments + - Ensure keyboard navigation and focus management + +6. Prototyping and Testing Strategy + - Plan for wireframes, mockups, and interactive prototypes + - Design user testing scenarios and success metrics + - Create A/B testing strategies for key interactions + - Plan for iterative design improvements + +OUTPUT REQUIREMENTS: Save comprehensive analysis to: +.workflow/WFS-{topic-slug}/.brainstorming/ui-designer/ +- analysis.md (main UI/UX analysis) +- design-system.md (visual design guidelines and components) +- user-flows.md (user journey maps and interaction flows) +- accessibility-plan.md (accessibility requirements and implementation) + +Apply UI/UX design expertise to create user-centered, accessible, and visually appealing solutions." +``` + +## 📊 **输出结构** + +### 保存位置 +``` +.workflow/WFS-{topic-slug}/.brainstorming/ui-designer/ +├── analysis.md # 主要UI/UX分析 +├── design-system.md # 视觉设计指南和组件 +├── user-flows.md # 用户旅程地图和交互流程 +└── accessibility-plan.md # 可访问性要求和实现 +``` + +### 文档模板 + +#### analysis.md 结构 +```markdown +# UI Designer Analysis: {Topic} +*Generated: {timestamp}* + +## Executive Summary +[核心UX发现和设计建议概述] + +## Current UX Assessment +### User Pain Points +### Interface Issues +### Accessibility Gaps +### Performance Impact on UX + +## User Experience Strategy +### Target User Personas +### User Journey Mapping +### Key Interaction Points +### Success Metrics + +## Visual Design Approach +### Brand Alignment +### Color and Typography Strategy +### Layout and Spacing System +### Iconography and Visual Elements + +## Interface Design Plan +### Information Architecture +### Navigation Strategy +### Component Library +### Responsive Design Approach + +## Accessibility Implementation +### WCAG Compliance Plan +### Assistive Technology Support +### Inclusive Design Features +### Testing Strategy + +## Prototyping and Validation +### Wireframe Strategy +### Interactive Prototype Plan +### User Testing Approach +### Iteration Framework +``` + +## 🔄 **会话集成** + +### 状态同步 +分析完成后，更新 `workflow-session.json`: +```json +{ + "phases": { + "BRAINSTORM": { + "ui_designer": { + "status": "completed", + "completed_at": "timestamp", + "output_directory": ".workflow/WFS-{topic}/.brainstorming/ui-designer/", + "key_insights": ["ux_improvement", "accessibility_requirement", "design_pattern"] + } + } + } +} +``` + +### 与其他角色的协作 +UI设计师视角为其他角色提供： +- **用户界面要求** → System Architect +- **用户体验指标** → Product Manager +- **数据展示需求** → Data Architect +- **安全交互设计** → Security Expert +- **功能界面规范** → Feature Planner + +## ✅ **质量标准** + +### 必须包含的设计元素 +- [ ] 详细的用户旅程分析 +- [ ] 完整的界面设计方案 +- [ ] 可访问性合规计划 +- [ ] 响应式设计策略 +- [ ] 可用性测试方案 + +### 设计原则检查 +- [ ] 用户中心：设计以用户需求为核心 +- [ ] 一致性：界面元素和交互保持一致 +- [ ] 可访问性：符合WCAG无障碍标准 +- [ ] 可用性：操作简单直观，学习成本低 +- [ ] 美观性：视觉设计支持品牌和用户喜好 + +### UX评估指标 +- [ ] 任务完成率和完成时间 +- [ ] 用户满意度和净推荐值 +- [ ] 错误率和恢复时间 +- [ ] 可访问性合规得分 +- [ ] 跨设备一致性评估 \ No newline at end of file diff --git a/.claude/commands/workflow/brainstorm/user-researcher.md b/.claude/commands/workflow/brainstorm/user-researcher.md new file mode 100644 index 00000000..4558b34d --- /dev/null +++ b/.claude/commands/workflow/brainstorm/user-researcher.md @@ -0,0 +1,257 @@ +--- +name: brainstorm:user-researcher +description: User researcher perspective brainstorming for user behavior analysis and research insights +usage: /brainstorm:user-researcher +argument-hint: "topic or challenge to analyze from user research perspective" +examples: + - /brainstorm:user-researcher "user onboarding experience" + - /brainstorm:user-researcher "mobile app usability issues" + - /brainstorm:user-researcher "feature adoption analysis" +allowed-tools: Task(conceptual-planning-agent), TodoWrite(*) +--- + +## 🔍 **角色定义: User Researcher** + +### 核心职责 +- **用户行为研究**: 深度分析用户行为模式和动机 +- **用户需求发现**: 通过研究发现未满足的用户需求 +- **可用性评估**: 评估产品的可用性和用户体验问题 +- **用户洞察生成**: 将研究发现转化为可操作的产品洞察 + +### 关注领域 +- **用户行为**: 使用模式、决策路径、任务完成方式 +- **用户需求**: 显性需求、隐性需求、情感需求 +- **用户体验**: 痛点、满意度、情感反应、期望值 +- **市场细分**: 用户画像、细分群体、使用场景 + +## 🧠 **分析框架** + +@~/.claude/workflows/brainstorming-principles.md +@~/.claude/workflows/conceptual-planning-agent.md + +### 核心分析问题 +1. **用户理解和洞察**: + - 目标用户的真实需求和痛点是什么？ + - 用户的行为模式和使用场景？ + - 不同用户群体的差异化需求？ + +2. **用户体验分析**: + - 当前用户体验的主要问题？ + - 用户任务完成的障碍和摩擦点？ + - 用户满意度和期望差距？ + +3. **研究方法和验证**: + - 哪些研究方法最适合当前问题？ + - 如何验证假设和设计决策？ + - 如何持续收集用户反馈？ + +4. **洞察转化和应用**: + - 研究发现如何转化为产品改进？ + - 如何影响产品决策和设计？ + - 如何建立以用户为中心的文化？ + +## ⚙️ **执行协议** + +### Phase 1: 会话检测与初始化 +```bash +# 自动检测活动会话 +CHECK: .workflow/.active-* marker files +IF active_session EXISTS: + session_id = get_active_session() + load_context_from(session_id) +ELSE: + request_user_for_session_creation() +``` + +### Phase 2: 目录结构创建 +```bash +# 创建用户研究员分析目录 +mkdir -p .workflow/WFS-{topic-slug}/.brainstorming/user-researcher/ +``` + +### Phase 3: TodoWrite 初始化 +设置用户研究员视角分析的任务跟踪： +```json +[ + {"content": "Initialize user researcher brainstorming session", "status": "completed", "activeForm": "Initializing session"}, + {"content": "Analyze user behavior patterns and motivations", "status": "in_progress", "activeForm": "Analyzing user behavior"}, + {"content": "Identify user needs and pain points", "status": "pending", "activeForm": "Identifying user needs"}, + {"content": "Evaluate current user experience", "status": "pending", "activeForm": "Evaluating user experience"}, + {"content": "Design user research methodology", "status": "pending", "activeForm": "Designing research methodology"}, + {"content": "Generate user insights and recommendations", "status": "pending", "activeForm": "Generating insights"}, + {"content": "Create comprehensive user research documentation", "status": "pending", "activeForm": "Creating documentation"} +] +``` + +### Phase 4: 概念规划代理协调 +```bash +Task(conceptual-planning-agent): " +Conduct user researcher perspective brainstorming for: {topic} + +ROLE CONTEXT: User Researcher +- Focus Areas: User behavior analysis, needs discovery, usability assessment, research methodology +- Analysis Framework: Human-centered research approach with emphasis on behavioral insights +- Success Metrics: User satisfaction, task success rates, insight quality, research impact + +USER CONTEXT: {captured_user_requirements_from_session} + +ANALYSIS REQUIREMENTS: +1. User Behavior Analysis + - Analyze current user behavior patterns and usage data + - Identify user decision-making processes and mental models + - Map user journeys and touchpoint interactions + - Assess user motivations and goals across different scenarios + - Identify behavioral segments and usage patterns + +2. User Needs and Pain Points Discovery + - Conduct gap analysis between user needs and current solutions + - Identify unmet needs and latent requirements + - Analyze user feedback and support data for pain points + - Map emotional user journey and frustration points + - Prioritize needs based on user impact and frequency + +3. Usability and Experience Assessment + - Evaluate current user experience against best practices + - Identify usability heuristics violations and UX issues + - Assess cognitive load and task completion efficiency + - Analyze accessibility barriers and inclusive design gaps + - Evaluate user satisfaction and Net Promoter Score trends + +4. User Segmentation and Personas + - Define user segments based on behavior and needs + - Create detailed user personas with goals and contexts + - Map user scenarios and use case variations + - Analyze demographic and psychographic factors + - Identify key user archetypes and edge cases + +5. Research Methodology Design + - Recommend appropriate research methods (qualitative/quantitative) + - Design user interview guides and survey instruments + - Plan usability testing scenarios and success metrics + - Design A/B testing strategies for key hypotheses + - Plan longitudinal research and continuous feedback loops + +6. Insights Generation and Validation + - Synthesize research findings into actionable insights + - Identify opportunity areas and innovation potential + - Validate assumptions and hypotheses with evidence + - Prioritize insights based on business and user impact + - Create research-backed design principles and guidelines + +OUTPUT REQUIREMENTS: Save comprehensive analysis to: +.workflow/WFS-{topic-slug}/.brainstorming/user-researcher/ +- analysis.md (main user research analysis) +- user-personas.md (detailed user personas and segments) +- research-plan.md (methodology and research approach) +- insights-recommendations.md (key findings and actionable recommendations) + +Apply user research expertise to generate deep user understanding and actionable insights." +``` + +## 📊 **输出结构** + +### 保存位置 +``` +.workflow/WFS-{topic-slug}/.brainstorming/user-researcher/ +├── analysis.md # 主要用户研究分析 +├── user-personas.md # 详细用户画像和细分 +├── research-plan.md # 方法论和研究方法 +└── insights-recommendations.md # 关键发现和可执行建议 +``` + +### 文档模板 + +#### analysis.md 结构 +```markdown +# User Researcher Analysis: {Topic} +*Generated: {timestamp}* + +## Executive Summary +[核心用户研究发现和建议概述] + +## Current User Landscape +### User Base Overview +### Behavioral Patterns +### Usage Statistics and Trends +### Satisfaction Metrics + +## User Needs Analysis +### Primary User Needs +### Unmet Needs and Gaps +### Need Prioritization Matrix +### Emotional and Functional Needs + +## User Experience Assessment +### Current UX Strengths +### Major Pain Points and Friction +### Usability Issues Identified +### Accessibility Gaps + +## User Behavior Insights +### User Journey Mapping +### Decision-Making Patterns +### Task Completion Analysis +### Behavioral Segments + +## Research Recommendations +### Recommended Research Methods +### Key Research Questions +### Success Metrics and KPIs +### Research Timeline and Resources + +## Actionable Insights +### Immediate UX Improvements +### Product Feature Recommendations +### Long-term User Strategy +### Success Measurement Plan +``` + +## 🔄 **会话集成** + +### 状态同步 +分析完成后，更新 `workflow-session.json`: +```json +{ + "phases": { + "BRAINSTORM": { + "user_researcher": { + "status": "completed", + "completed_at": "timestamp", + "output_directory": ".workflow/WFS-{topic}/.brainstorming/user-researcher/", + "key_insights": ["user_behavior_pattern", "unmet_need", "usability_issue"] + } + } + } +} +``` + +### 与其他角色的协作 +用户研究员视角为其他角色提供： +- **用户需求和洞察** → Product Manager +- **用户行为数据** → Data Architect +- **用户体验要求** → UI Designer +- **用户安全需求** → Security Expert +- **功能使用场景** → Feature Planner + +## ✅ **质量标准** + +### 必须包含的研究元素 +- [ ] 详细的用户行为分析 +- [ ] 明确的用户需求识别 +- [ ] 全面的用户体验评估 +- [ ] 科学的研究方法设计 +- [ ] 可执行的改进建议 + +### 用户研究原则检查 +- [ ] 以人为本：所有分析以用户为中心 +- [ ] 基于证据：结论有数据和研究支撑 +- [ ] 行为导向：关注实际行为而非声明意图 +- [ ] 情境考虑：分析使用场景和环境因素 +- [ ] 持续迭代：建立持续研究和改进机制 + +### 洞察质量评估 +- [ ] 洞察的新颖性和深度 +- [ ] 建议的可操作性和具体性 +- [ ] 影响评估的准确性 +- [ ] 研究方法的科学性 +- [ ] 用户代表性的覆盖度 \ No newline at end of file