mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-12 02:37:45 +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