moai-project-template-optimizer

Handle template comparison and optimization workflows including backup detection, smart merging, and update completion reporting. Enhanced with Context7 MCP for up-to-date documentation.

Zur Installation springen

Repository: AJBcoding/claude-skill-eval
Letzte Quellaktivität: 18. November 2025 um 19:33
Erkannte Sprache von SKILL.md: Englisch
Sterne: 4
Forks: 1

Installationsoptionen

Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.

Quelldateien prüfen

Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.

Zurück zur Suche Zurück zur Installation

name	moai-project-template-optimizer
version	4.0.0
created	2025-11-12T00:00:00.000Z
updated	2025-11-12T00:00:00.000Z
status	stable
tier	specialization
description	Handle template comparison and optimization workflows including backup detection, smart merging, and update completion reporting. Enhanced with Context7 MCP for up-to-date documentation.
allowed-tools	Read, Glob, Grep, WebSearch, WebFetch, mcp__context7__resolve-library-id, mcp__context7__get-library-docs
primary-agent	alfred
secondary-agents	[]
keywords	["project","template","optimizer","test"]
tags	["project","template","optimization","backup","merge","comparison"]
orchestration	null
can_resume	true
typical_chain_position	middle
depends_on	[]

moai-project-template-optimizer

Project Template Optimizer

Primary Agent: alfred
Secondary Agents: none
Version: 4.0.0
Keywords: project, template, optimizer, test

📖 Progressive Disclosure

Level 1: Quick Reference (Core Concepts)

Purpose: Handle template comparison and optimization workflows including backup detection, smart merging, and update completion reporting. Enhanced with Context7 MCP for up-to-date documentation.

When to Use:

✅ [Use case 1]
✅ [Use case 2]
✅ [Use case 3]

Quick Start Pattern:

# Basic example
# TODO: Add practical example

Level 2: Practical Implementation (Common Patterns)

Workflow Phases

Phase 1: Backup Discovery & Analysis

Purpose: Automatically discover and analyze existing project backups Trigger: Skill invocation or moai-adk version update detection

Process:

Backup Directory Scan

# Check for .moai-backups/ directory
if [ -d ".moai-backups/" ]; then
    # List available backups with timestamps
    ls -la .moai-backups/ | grep "backup-"
fi

Backup Content Analysis
- Read backup metadata and configuration files
- Identify template files vs user customizations
- Analyze backup creation timestamps and versions
- Detect backup completeness and integrity
Backup Selection Strategy
- Most recent backup (default)
- User-specified backup version
- Backup with specific features or configurations

Phase 2: Template Comparison Engine

: Detect differences between current templates and backup versions : Intelligent file comparison with template-aware parsing

File Type          | Comparison Strategy     | Merge Priority
------------------ | ----------------------- | --------------
.claude/settings.json | Structured JSON diff   | Template defaults
.moai/config.json   | User config preservation | User customizations
CLAUDE.md          | Section-based diff      | User content
Hook files         | Code-aware diff         | Template updates
Skills             | Content analysis        | Template defaults

Extraction Phase

# Extract user customizations from backup
user_customizations = extract_user_content(backup_files)

# Get latest template defaults
template_defaults = get_current_templates()

# Analyze current project state
current_state = analyze_current_project()

Merge Strategy
- Template defaults: Always use latest template version
- User configurations: Preserve from backup with compatibility updates
- Custom content: Extract and merge with new structure
- Deprecated features: Flag and offer migration options
Conflict Resolution
- Template conflicts: Prefer latest template
- User config conflicts: Preserve user choice with warnings
- Structural conflicts: Create merge report with resolution options

Template Indicators          | User Content Indicators
---------------------------- | -------------------------
"{{PROJECT_NAME}}"          | Specific project names
"{{CONVERSATION_LANGUAGE}}" | Actual language codes
"src/moai_adk/templates/"  | Custom file paths
Template placeholders       | Real configuration values
Default examples           | Custom implementations

{
  "template_version": "0.17.0",
  "previous_version": "0.16.0",
  "update_timestamp": "2025-11-05T12:00:00Z",
  "backup_used": "backup-2025-10-15-v0.16.0",
  "optimization_applied": true
}

{
  "template_optimization": {
    "last_optimized": "2025-11-05T12:00:00Z",
    "backup_version": "backup-2025-10-15-v0.16.0",
    "template_version": "0.17.0",
    "customizations_preserved": ["language", "team_settings", "domains"],
    "optimization_flags": {
      "merge_applied": true,
      "conflicts_resolved": 0,
      "user_content_extracted": true
    }
  }
}

# Complete optimization workflow
Skill("moai-project-template-optimizer")

# Executes: Backup Discovery → Template Comparison → Smart Merge → Configuration Update

# Analyze existing backups without making changes
Skill("moai-project-template-optimizer", mode="analyze_only")

# Restore from specific backup
Skill("moai-project-template-optimizer", 
       mode="restore", 
       backup="backup-2025-10-15-v0.16.0")

# Rollback to previous state
Skill("moai-project-template-optimizer", mode="rollback")

Template Optimization Report
Generated: 2025-11-05T12:00:00Z

Backup Analysis:
- Backups found: 3
- Selected backup: backup-2025-10-15-v0.16.0
- Backup integrity: 100%

Template Comparison:
- Files compared: 47
- Differences found: 12
- Conflicts detected: 0

Smart Merge Results:
- User customizations preserved: 8
- Template updates applied: 12
- Files modified: 15

Configuration Updates:
- Optimization flags set: true
- Version tracking updated: true
- History section updated: true

Performance:
- Total time: 2.3 seconds
- Success rate: 100%

# Fetch latest documentation
from moai_adk.integrations import Context7Helper

helper = Context7Helper()
docs = await helper.get_docs(
    library_id="/org/library",
    topic="project",
    tokens=5000
)

Start
  ├─ Need project?
  │   ├─ YES → Use this skill
  │   └─ NO → Consider alternatives
  └─ Complex scenario?
      ├─ YES → See Level 3
      └─ NO → Start with Level 1