mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-05 01:50:27 +08:00
feat: add /memory:load-skill-memory command for progressive SKILL loading
New command for loading SKILL package documentation with intelligent level selection:
**Two-Step Process**:
1. Validate SKILL existence in .claude/skills/{skill_name}/
2. Load documentation based on task requirements and complexity
**Progressive Loading Levels**:
- Level 0: Quick Start (~2K tokens) - Overview exploration
- Level 1: Core Modules (~10K tokens) - Module analysis
- Level 2: Complete (~25K tokens) - Code modification
- Level 3: Deep Dive (~40K tokens) - Feature implementation
**Auto-Level Selection**:
- Keyword-based detection from task description
- "快速了解" → Level 0
- "分析" → Level 1
- "修改" → Level 2
- "实现" → Level 3
**Key Features**:
- SKILL existence validation with available SKILLs listing
- Task-driven level auto-selection
- Token budget estimation
- Error handling for missing SKILLs/documentation
- Explicit --level override support
**Usage Examples**:
```bash
/memory:load-skill-memory hydro_generator_module "分析热模型"
/memory:load-skill-memory Claude_dms3 --level 2 "修改workflow"
/memory:load-skill-memory multiphysics_network "实现耦合器"
```
**Integration**:
- Works with SKILL packages generated by /memory:skill-memory
- Optimizes token usage through progressive loading
- Supports workflow planning and execution commands
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
catlog22
332
.claude/commands/memory/load-skill-memory.md
Normal file
332
.claude/commands/memory/load-skill-memory.md
Normal file
@@ -0,0 +1,332 @@
|
||||
---
|
||||
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(*)
|
||||
examples:
|
||||
- /memory:load-skill-memory hydro_generator_module "分析热模型实现"
|
||||
- /memory:load-skill-memory workflow-system --level 2 "修改任务调度逻辑"
|
||||
- /memory:load-skill-memory Claude_dms3 "学习文档生成流程"
|
||||
---
|
||||
|
||||
# Memory Load SKILL Command (/memory:load-skill-memory)
|
||||
|
||||
## 1. Overview
|
||||
|
||||
The `memory:load-skill-memory` command loads SKILL package documentation with **progressive levels** (0-3) based on task requirements. It validates SKILL existence and intelligently selects appropriate documentation depth.
|
||||
|
||||
**Core Philosophy**:
|
||||
- **Two-Step Validation**: Check SKILL existence before loading
|
||||
- **Progressive Loading**: Load only necessary documentation based on task complexity
|
||||
- **Token Optimization**: Start with minimal context, expand as needed
|
||||
- **Task-Driven Selection**: Automatically select level based on task description
|
||||
|
||||
## 2. Parameters
|
||||
|
||||
- `<skill_name>` (Required): Name of SKILL package to load
|
||||
- Example: `hydro_generator_module`
|
||||
- Example: `Claude_dms3`
|
||||
- Example: `multiphysics_network`
|
||||
|
||||
- `--level <0|1|2|3>` (Optional): Force specific documentation level
|
||||
- Level 0: Quick Start (~2K tokens) - Overview only
|
||||
- Level 1: Core Modules (~10K tokens) - Key module APIs
|
||||
- Level 2: Complete (~25K tokens) - All modules + architecture
|
||||
- Level 3: Deep Dive (~40K tokens) - Everything including examples
|
||||
- Default: Auto-select based on task description
|
||||
|
||||
- `[task description]` (Optional): Task context for auto-level selection
|
||||
- Example: "分析热模型实现"
|
||||
- Example: "修改builder pattern"
|
||||
- Example: "学习参数系统设计"
|
||||
|
||||
## 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
|
||||
- Claude_dms3
|
||||
- multiphysics_network
|
||||
|
||||
Use: /memory:load-skill-memory <skill_name> [task description]
|
||||
```
|
||||
|
||||
### Step 2: Load Documentation by Level
|
||||
|
||||
**Level Selection Logic**:
|
||||
|
||||
1. **Explicit Level** (--level specified): Use specified level directly
|
||||
2. **Task-Based Auto-Selection**:
|
||||
- **Level 0** (Quick Start):
|
||||
- Keywords: "overview", "介绍", "what is", "概述", "快速了解"
|
||||
- Use case: Initial exploration, understanding basic capabilities
|
||||
|
||||
- **Level 1** (Core Modules):
|
||||
- Keywords: "分析", "analyze", "review", "理解", "understand", "API"
|
||||
- Use case: Deep analysis of specific modules, API review
|
||||
|
||||
- **Level 2** (Complete):
|
||||
- Keywords: "修改", "modify", "重构", "refactor", "设计", "architecture"
|
||||
- Use case: Modifying code, understanding system design
|
||||
|
||||
- **Level 3** (Deep Dive):
|
||||
- Keywords: "实现", "implement", "开发", "develop", "示例", "example"
|
||||
- Use case: New feature implementation, need complete context
|
||||
|
||||
3. **Default**: Level 1 if no task description and no --level flag
|
||||
|
||||
**Loading Implementation**:
|
||||
|
||||
```bash
|
||||
# Read SKILL.md to get documentation structure
|
||||
Read(.claude/skills/{skill_name}/SKILL.md)
|
||||
|
||||
# Based on selected level, read corresponding files
|
||||
case $level in
|
||||
0)
|
||||
Read(../../../.workflow/docs/{skill_name}/README.md)
|
||||
;;
|
||||
1)
|
||||
Read(../../../.workflow/docs/{skill_name}/README.md)
|
||||
# Read Core Module README.md files listed in SKILL.md Level 1
|
||||
;;
|
||||
2)
|
||||
# Load all Level 1 docs
|
||||
Read(../../../.workflow/docs/{skill_name}/ARCHITECTURE.md)
|
||||
# Read all module README.md + API.md files
|
||||
;;
|
||||
3)
|
||||
# Load all Level 2 docs
|
||||
Read(../../../.workflow/docs/{skill_name}/EXAMPLES.md)
|
||||
# Read complete documentation set
|
||||
;;
|
||||
esac
|
||||
```
|
||||
|
||||
## 4. Output Format
|
||||
|
||||
**Success Output**:
|
||||
```
|
||||
✅ Loaded SKILL: {skill_name} (Level {level})
|
||||
|
||||
📦 Documentation Loaded:
|
||||
- README.md (~2K tokens)
|
||||
[Level 1+]
|
||||
- analysis/README.md
|
||||
- builders/README.md
|
||||
- params/README.md
|
||||
[Level 2+]
|
||||
- ARCHITECTURE.md
|
||||
- Complete module APIs
|
||||
[Level 3+]
|
||||
- EXAMPLES.md
|
||||
|
||||
💡 Token Budget: ~{token_count}K
|
||||
|
||||
🎯 Task Context: {task_description}
|
||||
```
|
||||
|
||||
## 5. Usage Examples
|
||||
|
||||
### Example 1: Quick Overview
|
||||
|
||||
```bash
|
||||
/memory:load-skill-memory hydro_generator_module "快速了解模块功能"
|
||||
```
|
||||
|
||||
**Auto-Selected Level**: 0 (keyword: "快速了解")
|
||||
|
||||
**Loaded Files**:
|
||||
- `.workflow/docs/hydro_generator_module/README.md`
|
||||
|
||||
**Token Budget**: ~2K
|
||||
|
||||
### Example 2: Module Analysis
|
||||
|
||||
```bash
|
||||
/memory:load-skill-memory hydro_generator_module "分析builder pattern实现"
|
||||
```
|
||||
|
||||
**Auto-Selected Level**: 1 (keyword: "分析")
|
||||
|
||||
**Loaded Files**:
|
||||
- README.md
|
||||
- builders/README.md
|
||||
- builders/API.md
|
||||
- interfaces/README.md
|
||||
- params/README.md
|
||||
|
||||
**Token Budget**: ~10K
|
||||
|
||||
### Example 3: Code Modification
|
||||
|
||||
```bash
|
||||
/memory:load-skill-memory Claude_dms3 --level 2 "修改文档生成workflow"
|
||||
```
|
||||
|
||||
**Explicit Level**: 2
|
||||
|
||||
**Loaded Files**:
|
||||
- README.md
|
||||
- All module README.md + API.md
|
||||
- ARCHITECTURE.md
|
||||
|
||||
**Token Budget**: ~25K
|
||||
|
||||
### Example 4: New Feature Implementation
|
||||
|
||||
```bash
|
||||
/memory:load-skill-memory multiphysics_network "实现新的电磁耦合器"
|
||||
```
|
||||
|
||||
**Auto-Selected Level**: 3 (keyword: "实现")
|
||||
|
||||
**Loaded Files**:
|
||||
- Complete documentation set
|
||||
- EXAMPLES.md with 20+ examples
|
||||
|
||||
**Token Budget**: ~40K
|
||||
|
||||
## 6. Level Selection Matrix
|
||||
|
||||
| Task Type | Keywords | Auto Level | Token Budget |
|
||||
|-----------|----------|------------|--------------|
|
||||
| **Explore** | overview, 介绍, what is, 概述 | 0 | ~2K |
|
||||
| **Analyze** | 分析, analyze, review, 理解 | 1 | ~10K |
|
||||
| **Modify** | 修改, modify, 重构, refactor | 2 | ~25K |
|
||||
| **Implement** | 实现, implement, 开发, develop | 3 | ~40K |
|
||||
|
||||
## 7. Implementation Steps
|
||||
|
||||
**Pseudo-code**:
|
||||
|
||||
```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: Determine level
|
||||
if (--level specified) {
|
||||
level = specified_level
|
||||
} else if (task_description) {
|
||||
level = auto_select_level(task_description)
|
||||
} else {
|
||||
level = 1 // Default
|
||||
}
|
||||
|
||||
// Step 3: Read SKILL.md structure
|
||||
skill_content = Read(skill_path)
|
||||
doc_structure = parse_progressive_loading(skill_content)
|
||||
|
||||
// Step 4: Load documentation by level
|
||||
loaded_docs = []
|
||||
for (doc in doc_structure[level]) {
|
||||
loaded_docs.push(Read(doc.path))
|
||||
}
|
||||
|
||||
// Step 5: Calculate token count
|
||||
token_count = estimate_tokens(loaded_docs)
|
||||
|
||||
// Step 6: Output summary
|
||||
output_success_message(skill_name, level, loaded_docs, token_count, task_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)
|
||||
|
||||
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
|
||||
```
|
||||
|
||||
### Invalid Level
|
||||
```
|
||||
❌ Invalid level: 4
|
||||
|
||||
Valid levels:
|
||||
- Level 0: Quick Start (~2K)
|
||||
- Level 1: Core Modules (~10K)
|
||||
- Level 2: Complete (~25K)
|
||||
- Level 3: Deep Dive (~40K)
|
||||
```
|
||||
|
||||
## 9. Integration with Other Commands
|
||||
|
||||
**Workflow Integration**:
|
||||
```bash
|
||||
# 1. Load SKILL context
|
||||
/memory:load-skill-memory hydro_generator_module "修改thermal template"
|
||||
|
||||
# 2. Use loaded context for planning
|
||||
/workflow:plan "增强thermal template支持动态阻抗"
|
||||
|
||||
# 3. Execute implementation
|
||||
/workflow:execute
|
||||
```
|
||||
|
||||
**Memory Refresh**:
|
||||
```bash
|
||||
# Load fresh context after code changes
|
||||
/memory:load-skill-memory hydro_generator_module --level 2 "review recent changes"
|
||||
```
|
||||
|
||||
## 10. Token Optimization Strategy
|
||||
|
||||
**Progressive Loading Pattern**:
|
||||
1. Start with Level 0 for exploration
|
||||
2. Escalate to Level 1 for analysis
|
||||
3. Load Level 2 for modification tasks
|
||||
4. Use Level 3 only for complex implementations
|
||||
|
||||
**Token Budget Guidelines**:
|
||||
- **Simple queries**: Level 0-1 (2-10K)
|
||||
- **Code review**: Level 1-2 (10-25K)
|
||||
- **Feature development**: Level 2-3 (25-40K)
|
||||
|
||||
**Reload Strategy**:
|
||||
- Reload with higher level if insufficient context
|
||||
- Use explicit --level to override auto-selection
|
||||
|
||||
## 11. Notes
|
||||
|
||||
- **Read-Only**: Does not modify SKILL files or documentation
|
||||
- **Session-Scoped**: Loaded documentation valid for current session
|
||||
- **Auto-Selection**: Keywords matched case-insensitively
|
||||
- **Path Relative**: All documentation paths relative to SKILL.md location
|
||||
- **Token Aware**: Automatically estimates token consumption
|
||||
- **Fallback**: Defaults to Level 1 if auto-selection unclear
|
||||
Reference in New Issue
Block a user