docs: 更新文档,支持多个分析文件的动态发现和加载,增强任务生成和合成文档的灵活性

This commit is contained in:
catlog22
2025-10-23 09:48:32 +08:00
parent d9cee7f17a
commit 12d010c1d8
2 changed files with 13 additions and 11 deletions

View File

@@ -87,7 +87,7 @@ IF NOT original_user_prompt:
# Dynamically discover available role analyses # Dynamically discover available role analyses
SCAN_DIRECTORY: .workflow/WFS-{session}/.brainstorming/ SCAN_DIRECTORY: .workflow/WFS-{session}/.brainstorming/
FIND_ANALYSES: [ 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 Extract role names from directory names
] ]
@@ -105,13 +105,14 @@ FIND_ANALYSES: [
LOAD_DOCUMENTS: { LOAD_DOCUMENTS: {
"original_user_prompt": original_user_prompt (from session metadata), "original_user_prompt": original_user_prompt (from session metadata),
"topic_framework": topic-framework.md, "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], "participating_roles": [extract role names from discovered directories],
"existing_synthesis": synthesis-specification.md (if exists) "existing_synthesis": synthesis-specification.md (if exists)
} }
# Note: Not all roles participate in every brainstorming session # 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 # 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 - Note: Validate alignment with original_user_prompt
3. **discover_role_analyses** 3. **discover_role_analyses**
- Action: Dynamically discover all participating role analysis files - Action: Dynamically discover all participating role analysis files (supports multiple files per role)
- Command: Glob(.workflow/WFS-{session}/.brainstorming/*/analysis.md) - Command: Glob(.workflow/WFS-{session}/.brainstorming/*/analysis*.md)
- Output: role_analysis_paths, participating_roles - 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** 4. **load_role_analyses**
- Action: Load all discovered role analysis documents - 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/ .workflow/WFS-{topic-slug}/.brainstorming/
├── topic-framework.md # Input: Framework structure ├── 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 └── synthesis-specification.md # ★ OUTPUT: Complete integrated specification
``` ```

View File

@@ -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" "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", "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", "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", "step": "load_role_analysis_artifacts",
"action": "Load role-specific analysis documents for technical details", "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.", "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": [ "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/system-architect/analysis.md)",
"Read(.workflow/WFS-[session]/.brainstorming/ui-designer/analysis.md)", "Read(.workflow/WFS-[session]/.brainstorming/ui-designer/analysis.md)",
"Read(.workflow/WFS-[session]/.brainstorming/product-manager/analysis.md)" "Read(.workflow/WFS-[session]/.brainstorming/product-manager/analysis.md)"