From 12d010c1d8bf8dccf0d668c8bd144eb2cadec3fe Mon Sep 17 00:00:00 2001 From: catlog22 Date: Thu, 23 Oct 2025 09:48:32 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E6=96=87=E6=A1=A3?= =?UTF-8?q?=EF=BC=8C=E6=94=AF=E6=8C=81=E5=A4=9A=E4=B8=AA=E5=88=86=E6=9E=90?= =?UTF-8?q?=E6=96=87=E4=BB=B6=E7=9A=84=E5=8A=A8=E6=80=81=E5=8F=91=E7=8E=B0?= =?UTF-8?q?=E5=92=8C=E5=8A=A0=E8=BD=BD=EF=BC=8C=E5=A2=9E=E5=BC=BA=E4=BB=BB?= =?UTF-8?q?=E5=8A=A1=E7=94=9F=E6=88=90=E5=92=8C=E5=90=88=E6=88=90=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E7=9A=84=E7=81=B5=E6=B4=BB=E6=80=A7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .claude/commands/workflow/brainstorm/synthesis.md | 14 ++++++++------ .claude/commands/workflow/tools/task-generate.md | 10 +++++----- 2 files changed, 13 insertions(+), 11 deletions(-) diff --git a/.claude/commands/workflow/brainstorm/synthesis.md b/.claude/commands/workflow/brainstorm/synthesis.md index 226a37c6..0fa5505d 100644 --- a/.claude/commands/workflow/brainstorm/synthesis.md +++ b/.claude/commands/workflow/brainstorm/synthesis.md @@ -87,7 +87,7 @@ IF NOT original_user_prompt: # Dynamically discover available role analyses SCAN_DIRECTORY: .workflow/WFS-{session}/.brainstorming/ FIND_ANALYSES: [ - Scan all subdirectories for */analysis.md files + Scan all subdirectories for */analysis*.md files (supports analysis.md, analysis-1.md, analysis-2.md, analysis-3.md) Extract role names from directory names ] @@ -105,13 +105,14 @@ FIND_ANALYSES: [ LOAD_DOCUMENTS: { "original_user_prompt": original_user_prompt (from session metadata), "topic_framework": topic-framework.md, - "role_analyses": [dynamically discovered analysis.md files], + "role_analyses": [dynamically discovered analysis*.md files], "participating_roles": [extract role names from discovered directories], "existing_synthesis": synthesis-specification.md (if exists) } # Note: Not all roles participate in every brainstorming session -# Only synthesize roles that actually produced analysis.md files +# Only synthesize roles that actually produced analysis*.md files +# Each role may have 1-3 analysis files: analysis.md OR analysis-1.md, analysis-2.md, analysis-3.md # CRITICAL: Original user prompt MUST be primary reference for synthesis ``` @@ -165,9 +166,10 @@ All synthesis MUST align with user's original intent. Topic framework and role a - Note: Validate alignment with original_user_prompt 3. **discover_role_analyses** - - Action: Dynamically discover all participating role analysis files - - Command: Glob(.workflow/WFS-{session}/.brainstorming/*/analysis.md) + - Action: Dynamically discover all participating role analysis files (supports multiple files per role) + - Command: Glob(.workflow/WFS-{session}/.brainstorming/*/analysis*.md) - Output: role_analysis_paths, participating_roles + - Note: Each role may have 1-3 files (analysis.md OR analysis-1.md, analysis-2.md, analysis-3.md) 4. **load_role_analyses** - Action: Load all discovered role analysis documents @@ -256,7 +258,7 @@ The synthesis process creates **one consolidated document** that integrates all ``` .workflow/WFS-{topic-slug}/.brainstorming/ ├── topic-framework.md # Input: Framework structure -├── [role]/analysis.md # Input: Role analyses (multiple) +├── [role]/analysis*.md # Input: Role analyses (supports analysis.md or analysis-1/2/3.md per role) └── synthesis-specification.md # ★ OUTPUT: Complete integrated specification ``` diff --git a/.claude/commands/workflow/tools/task-generate.md b/.claude/commands/workflow/tools/task-generate.md index 4416ecaf..498a8b69 100644 --- a/.claude/commands/workflow/tools/task-generate.md +++ b/.claude/commands/workflow/tools/task-generate.md @@ -203,9 +203,9 @@ This enhanced 5-field schema embeds all necessary context, artifacts, and execut "usage": "Smart context with focus paths, module structure, dependency graph, existing patterns. Use for: environment setup, dependency resolution, pattern discovery" }, { - "path": ".workflow/WFS-[session]/.brainstorming/[role-name]/analysis.md", + "path": ".workflow/WFS-[session]/.brainstorming/[role-name]/analysis*.md", "priority": "high", - "usage": "Technical/design/business details from specific roles. Common roles: system-architect (ADRs, APIs, caching), ui-designer (design tokens, layouts), product-manager (user stories, metrics)" + "usage": "Technical/design/business details from specific roles (may have multiple files: analysis.md OR analysis-1/2/3.md). Common roles: system-architect (ADRs, APIs, caching), ui-designer (design tokens, layouts), product-manager (user stories, metrics)" }, { "path": ".workflow/WFS-[session]/.brainstorming/topic-framework.md", @@ -228,10 +228,10 @@ This enhanced 5-field schema embeds all necessary context, artifacts, and execut }, { "step": "load_role_analysis_artifacts", - "action": "Load role-specific analysis documents for technical details", - "note": "These artifacts contain implementation details not in synthesis. Consult when needing: API schemas, caching configs, design tokens, ADRs, performance metrics.", + "action": "Load role-specific analysis documents for technical details (supports multiple files per role)", + "note": "These artifacts contain implementation details not in synthesis. Consult when needing: API schemas, caching configs, design tokens, ADRs, performance metrics. Each role may have analysis.md OR analysis-1/2/3.md.", "commands": [ - "bash(find .workflow/WFS-[session]/.brainstorming/ -name 'analysis.md' 2>/dev/null | head -8)", + "bash(find .workflow/WFS-[session]/.brainstorming/ -name 'analysis*.md' 2>/dev/null | sort | head -24)", "Read(.workflow/WFS-[session]/.brainstorming/system-architect/analysis.md)", "Read(.workflow/WFS-[session]/.brainstorming/ui-designer/analysis.md)", "Read(.workflow/WFS-[session]/.brainstorming/product-manager/analysis.md)"