Claude-Code-Workflow/.claude/commands/memory/load-skill-memory.md

---
name: load-skill-memory
description: Load SKILL package documentation with progressive levels based on task requirements
argument-hint: "<skill_name> [--level 0|1|2|3] [task description]"
allowed-tools: Bash(*), Read(*), Glob(*), Skill(*)
examples:
  - Skill(command: "hydro_generator_module")
  - Skill(command: "Claude_dms3")
  - Skill(command: "multiphysics_network")
---

# Memory Load SKILL Command (/memory:load-skill-memory)

## 1. Overview

The `memory:load-skill-memory` command **activates SKILL packages** generated by `/memory:skill-memory`. It validates SKILL existence and uses the `Skill()` tool to load comprehensive documentation context.

**Core Philosophy**:
- **Two-Step Process**: Validate SKILL existence → Activate via Skill tool
- **Automatic Context Loading**: SKILL system loads appropriate documentation automatically
- **No Manual Reading**: Use Skill tool instead of manual Read operations
- **Task-Driven Activation**: System automatically determines required context based on SKILL description triggers

## 2. Parameters

- `<skill_name>` (Required): Name of SKILL package to activate
  - Example: `hydro_generator_module`
  - Example: `Claude_dms3`
  - Example: `multiphysics_network`

## 3. Two-Step Execution Flow

### Step 1: Validate SKILL Existence

**Check SKILL.md File**:
```bash
bash(test -f .claude/skills/{skill_name}/SKILL.md && echo "exists" || echo "not_found")
```

**Validation Logic**:
- If `exists`: Continue to Step 2
- If `not_found`: Return error message with available SKILLs:
  ```bash
  bash(ls -1 .claude/skills/ 2>/dev/null || echo "No SKILLs available")
  ```

**Error Message Format**:
```
❌ SKILL '{skill_name}' not found.

Available SKILLs:
- hydro_generator_module (D:\dongdiankaifa9\hydro_generator_module)
- Claude_dms3 (D:\Claude_dms3)

Use: Skill(command: "skill_name")
Generate new SKILL: /memory:skill-memory [path]
```

### Step 2: Activate SKILL Package

**Use Skill Tool to Activate**:
```javascript
Skill(command: "{skill_name}")
```

**What Happens**:
1. Claude's SKILL system reads `.claude/skills/{skill_name}/SKILL.md`
2. Automatically loads appropriate documentation based on:
   - SKILL description triggers (analyzing, modifying, learning)
   - Current conversation context
   - Memory gaps detection
3. Progressive loading levels (0-3) handled automatically by system
4. Context loaded directly into conversation memory

**No Manual Reading Required**: The Skill tool handles all documentation loading automatically based on SKILL.md configuration.

## 4. Output Format

**Success Output**:
```
✅ Activated SKILL: {skill_name}

📦 SKILL Package Information:
- Location: {project_path}
- Description: {description from SKILL.md}
- Documentation: .workflow/docs/{skill_name}/

💡 Context loaded automatically by SKILL system based on:
- Current task requirements
- Conversation memory gaps
- SKILL description triggers

🎯 Ready for: analyzing, modifying, or learning about {domain_description}
```

## 5. Usage Examples

### Example 1: Activate Hydro Generator Module SKILL

**User Request**: "分析热模型builder pattern实现"

**Command Execution**:
```javascript
// Step 1: Validate
bash(test -f .claude/skills/hydro_generator_module/SKILL.md && echo "exists")
// Output: exists

// Step 2: Activate
Skill(command: "hydro_generator_module")
```

**SKILL Activation**:
- System reads `.claude/skills/hydro_generator_module/SKILL.md`
- Description triggers match: "analyzing" + "hydro-generator thermal modeling"
- Automatically loads appropriate documentation (Level 1-2)
- Context available for subsequent analysis

### Example 2: Activate Workflow System SKILL

**User Request**: "修改文档生成workflow调度逻辑"

**Command Execution**:
```javascript
// Step 1: Validate
bash(test -f .claude/skills/Claude_dms3/SKILL.md && echo "exists")
// Output: exists

// Step 2: Activate
Skill(command: "Claude_dms3")
```

**SKILL Activation**:
- Description triggers match: "modifying" + "workflow management"
- System loads comprehensive documentation (Level 2-3)
- Ready for workflow modification tasks

### Example 3: Activate Multi-Physics Network SKILL

**User Request**: "学习电磁域组件设计模式"

**Command Execution**:
```javascript
// Step 1: Validate
bash(test -f .claude/skills/multiphysics_network/SKILL.md && echo "exists")
// Output: exists

// Step 2: Activate
Skill(command: "multiphysics_network")
```

**SKILL Activation**:
- Description triggers match: "learning" + "multi-physics"
- System provides overview and core module docs (Level 0-1)
- Context available for exploration

## 6. SKILL Trigger Mechanism

**How SKILL System Determines Context Loading**:

The SKILL.md description includes trigger patterns that automatically activate when:

1. **Keyword Matching**:
   - User mentions domain keywords (e.g., "热模型", "workflow", "多物理场")
   - Description keywords match task requirements

2. **Action Detection**:
   - "analyzing" triggers for analysis tasks
   - "modifying" triggers for code modification
   - "learning" triggers for exploration

3. **Memory Gap Detection**:
   - "especially when no relevant context exists in memory"
   - System prioritizes SKILL loading when conversation lacks context

4. **Path-Based Triggering**:
   - User mentions file paths matching SKILL location
   - "files under this path" clause activates

**Progressive Loading (Automatic)**:
- Level 0: ~2K tokens (Quick overview)
- Level 1: ~10K tokens (Core modules)
- Level 2: ~25K tokens (Complete system)
- Level 3: ~40K tokens (Full documentation)

System automatically selects appropriate level based on task complexity and context requirements.

## 7. Implementation Steps

**Execution Logic**:

```javascript
// Step 1: Validate SKILL existence
skill_path = `.claude/skills/${skill_name}/SKILL.md`
if (!exists(skill_path)) {
  list_available_skills()
  return error_message
}

// Step 2: Activate SKILL
Skill(command: skill_name)

// Step 3: System handles automatically
// - Reads SKILL.md description
// - Matches triggers with task context
// - Loads appropriate documentation level
// - Injects context into conversation memory

// Step 4: Confirm activation
output_success_message(skill_name, project_path, description)
```

## 8. Error Handling

### SKILL Not Found
```
❌ SKILL 'unknown_module' not found.

Available SKILLs:
- hydro_generator_module (D:\dongdiankaifa9\hydro_generator_module)
- Claude_dms3 (D:\Claude_dms3)

Activate SKILL: Skill(command: "skill_name")
Generate new SKILL: /memory:skill-memory [path]
```

### Documentation Missing
```
⚠️  SKILL 'hydro_generator_module' exists but documentation incomplete.

Missing files:
- .workflow/docs/hydro_generator_module/ARCHITECTURE.md

Regenerate documentation: /memory:skill-memory --regenerate
```

## 9. Integration with Other Commands

**Workflow Integration**:
```javascript
// 1. Activate SKILL context
Skill(command: "hydro_generator_module")

// 2. Use loaded context for planning
SlashCommand(command: "/workflow:plan \"增强thermal template支持动态阻抗\"")

// 3. Execute implementation
SlashCommand(command: "/workflow:execute")
```

**Memory Refresh Pattern**:
```javascript
// Refresh SKILL context after code changes
Skill(command: "hydro_generator_module")
// System automatically detects changes and loads updated documentation
```

## 10. Token Optimization Strategy

**Automatic Progressive Loading**:
The SKILL system automatically handles token optimization:

1. **Initial Load**: Starts with minimum required context
2. **On-Demand Escalation**: Loads more documentation if needed
3. **Task-Driven**: Adjusts depth based on task complexity
4. **Memory-Aware**: Avoids loading redundant context

**Token Budget (Automatic)**:
- **Simple queries**: ~2-10K tokens
- **Code analysis**: ~10-25K tokens
- **Implementation**: ~25-40K tokens

**Optimization Benefits**:
- No manual level selection required
- System learns from conversation context
- Efficient memory usage
- Automatic reload when context insufficient

## 11. Notes

- **Validation First**: Always checks SKILL existence before activation
- **Automatic Loading**: Skill tool handles all documentation reading
- **Session-Scoped**: Activated SKILL context valid for current session
- **Trigger-Based**: Description patterns drive automatic activation
- **Path-Aware**: Triggers on project path mentions
- **Memory-Smart**: Prioritizes loading when conversation lacks context
- **Read-Only**: Does not modify SKILL files or documentation
- **Reactivation**: Can re-activate SKILL to refresh context after changes