mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-12 02:37:45 +08:00

Files

catlog22 54c3234d84 fix: 为所有 skill 的 .workflow/ 路径添加 projectRoot 前缀

从子目录执行 skill 时，相对路径 .workflow/ 会导致产物落到错误位置。
通过 git rev-parse --show-toplevel || pwd 检测项目根目录，
所有 .workflow/ 路径引用统一加上 {projectRoot} 前缀确保路径正确。

涉及 72 个文件，覆盖 20+ 个 skill。

2026-02-08 13:46:48 +08:00

11 KiB

Raw Blame History

Phase 1: Discovery & Initialization

Source: Fused from commands/workflow/review-session-cycle.md Phase 1 + commands/workflow/review-module-cycle.md Phase 1

Overview

Detect review mode (session or module), resolve target files, create workflow session, initialize output directory structure and state files.

Mode Detection

The review mode is determined by the input arguments:

Session mode: No path pattern provided, OR a WFS-* session ID is provided. Reviews all changes within an existing workflow session (git-based change detection).
Module mode: Glob/path patterns are provided (e.g., src/auth/**, src/payment/processor.ts). Reviews specific files/directories regardless of session history.

Session Mode (review-session-cycle)

Step 1.1: Session Discovery

// If session ID not provided, auto-detect
if (!providedSessionId) {
  // Check for active sessions
  const activeSessions = Glob('${projectRoot}/.workflow/active/WFS-*');
  if (activeSessions.length === 1) {
    sessionId = activeSessions[0].match(/WFS-[^/]+/)[0];
  } else if (activeSessions.length > 1) {
    // List sessions and prompt user
    error("Multiple active sessions found. Please specify session ID.");
  } else {
    error("No active session found. Create session first.");
  }
} else {
  sessionId = providedSessionId;
}

// Validate session exists
Bash(`test -d ${projectRoot}/.workflow/active/${sessionId} && echo "EXISTS"`);

Step 1.2: Session Validation

Ensure session has implementation artifacts (check .summaries/ or .task/ directory)
Extract session creation timestamp from workflow-session.json
Use timestamp for git log filtering: git log --since="${sessionCreatedAt}"

Step 1.3: Changed Files Detection

# Get files changed since session creation
git log --since="${sessionCreatedAt}" --name-only --pretty=format: | sort -u

Module Mode (review-module-cycle)

Step 1.1: Session Creation

// Create workflow session for this review (type: review)
// Orchestrator handles session creation directly
Bash(`mkdir -p ${projectRoot}/.workflow/active/WFS-review-${Date.now()}`);

// Initialize workflow-session.json
const sessionId = `WFS-review-${Date.now()}`;
Write(`${projectRoot}/.workflow/active/${sessionId}/workflow-session.json`, JSON.stringify({
  session_id: sessionId,
  type: "review",
  description: `Code review for ${targetPattern}`,
  created_at: new Date().toISOString()
}, null, 2));

Step 1.2: Path Resolution & Validation

# Expand glob pattern to file list (relative paths from project root)
find . -path "./src/auth/**" -type f | sed 's|^\./||'

# Validate files exist and are readable
for file in ${resolvedFiles[@]}; do
  test -r "$file" || error "File not readable: $file"
done

Parse and expand file patterns (glob support): src/auth/** -> actual file list
Validation: Ensure all specified files exist and are readable
Store as relative paths from project root (e.g., src/auth/service.ts)
Agents construct absolute paths dynamically during execution

Syntax Rules:

All paths are relative from project root (e.g., src/auth/** not /src/auth/**)
Multiple patterns: comma-separated, no spaces (e.g., src/auth/**,src/payment/**)
Glob and specific files can be mixed (e.g., src/auth/**,src/config.ts)

Supported Patterns:

Pattern Type	Example	Description
Glob directory	`src/auth/**`	All files under src/auth/
Glob with extension	`src/*/.ts`	All .ts files under src/
Specific file	`src/payment/processor.ts`	Single file
Multiple patterns	`src/auth/,src/payment/`	Comma-separated (no spaces)

Resolution Process:

Parse input pattern (split by comma, trim whitespace)
Expand glob patterns to file list via find command
Validate all files exist and are readable
Error if pattern matches 0 files
Store resolved file list in review-state.json

Common Steps (Both Modes)

Step 1.4: Output Directory Setup

Output directory: ${projectRoot}/.workflow/active/${sessionId}/.review/

Create directory structure:

mkdir -p ${sessionDir}/.review/{dimensions,iterations,reports}

Step 1.5: Initialize Review State

State initialization: Create review-state.json with metadata, dimensions, max_iterations (merged metadata + state)
Session mode includes git_changes in metadata
Module mode includes target_pattern and resolved_files in metadata
Progress tracking: Create review-progress.json for progress tracking

Step 1.6: Initialize Review Progress

Create review-progress.json for real-time dashboard updates via polling
See Review Progress JSON schema below

Step 1.7: Progress Tracking Initialization

Set up progress tracking with hierarchical structure
Mark Phase 1 completed, Phase 2 in_progress

Review State JSON (Session Mode)

Purpose: Unified state machine and metadata (merged from metadata + state)

{
  "session_id": "WFS-payment-integration",
  "review_id": "review-20250125-143022",
  "review_type": "session",
  "metadata": {
    "created_at": "2025-01-25T14:30:22Z",
    "git_changes": {
      "commit_range": "abc123..def456",
      "files_changed": 15,
      "insertions": 342,
      "deletions": 128
    },
    "dimensions": ["security", "architecture", "quality", "action-items", "performance", "maintainability", "best-practices"],
    "max_iterations": 3
  },
  "phase": "parallel|aggregate|iterate|complete",
  "current_iteration": 1,
  "dimensions_reviewed": ["security", "architecture", "quality", "action-items", "performance", "maintainability", "best-practices"],
  "selected_strategy": "comprehensive",
  "next_action": "execute_parallel_reviews|aggregate_findings|execute_deep_dive|generate_final_report|complete",
  "severity_distribution": {
    "critical": 2,
    "high": 5,
    "medium": 12,
    "low": 8
  },
  "critical_files": [
    {
      "file": "src/payment/processor.ts",
      "finding_count": 5,
      "dimensions": ["security", "architecture", "quality"]
    }
  ],
  "iterations": [
    {
      "iteration": 1,
      "findings_analyzed": ["uuid-1", "uuid-2"],
      "findings_resolved": 1,
      "findings_escalated": 1,
      "severity_change": {
        "before": {"critical": 2, "high": 5, "medium": 12, "low": 8},
        "after": {"critical": 1, "high": 6, "medium": 12, "low": 8}
      },
      "timestamp": "2025-01-25T14:30:00Z"
    }
  ],
  "completion_criteria": {
    "target": "no_critical_findings_and_high_under_5",
    "current_status": "in_progress",
    "estimated_completion": "2 iterations remaining"
  }
}

Field Descriptions:

phase: Current execution phase (state machine pointer)
current_iteration: Iteration counter (used for max check)
next_action: Next step orchestrator should execute
severity_distribution: Aggregated counts across all dimensions
critical_files: Files appearing in 3+ dimensions with metadata
iterations[]: Historical log for trend analysis

Review State JSON (Module Mode)