AJBcoding avatar

moai-project-language-initializer

Handle comprehensive project language and user setup workflows including language selection, agent p

提供方 AJBcoding|开源

MoAI Project Language & User Initializer

A comprehensive MoAI-ADK skill for handling project initialization workflows including language selection, user setup, team configuration, and domain selection.

Quick Start

# Initialize your project with all settings
Skill("moai-project-language-initializer")

# Update existing settings only
Skill("moai-project-language-initializer", mode="settings")

# Configure team-specific settings
Skill("moai-project-language-initializer", mode="team_setup")

What It Does

This skill manages the complete project setup process:

✅ Language Selection - Choose conversation language (English, Korean, Japanese, Chinese)
✅ Agent Configuration - Set prompt language (English saves 15-20% tokens)
✅ User Profile - Set your nickname (max 20 characters)
✅ Team Setup - Configure GitHub workflows and branch management
✅ Report Settings - Control automatic report generation with cost awareness
✅ Domain Selection - Choose project domains for expert agent activation

Key Features

💡 Efficient Interactions

  • Reduces user interactions by 60% through batched questions
  • 3-4 questions instead of 8-10 separate interactions

💰 Cost Management

  • Token cost warnings for expensive operations
  • English prompt language saves 15-20% on API costs
  • Report generation controls to manage spending

🌍 Multi-language Support

  • 4 supported languages with full localization
  • Flexible prompt language configuration
  • Consistent experience across languages

👥 Team Collaboration

  • Multiple Git workflow options
  • GitHub integration settings
  • Team-specific configurations

Configuration Structure

The skill creates and manages .moai/config/config.json:

{
  "language": {
    "conversation_language": "ko",
    "conversation_language_name": "한국어",
    "agent_prompt_language": "english"
  },
  "user": {
    "nickname": "개발자",
    "selected_at": "2025-11-05T12:30:00Z"
  },
  "github": {
    "auto_delete_branches": true,
    "spec_git_workflow": "feature_branch"
  },
  "report_generation": {
    "enabled": true,
    "user_choice": "Minimal"
  },
  "stack": {
    "selected_domains": ["frontend", "backend"]
  }
}

Integration

This skill is automatically used by:

  • /alfred:0-project - Primary integration point
  • /alfred:1-plan - Uses domain selection for expert agents
  • /alfred:2-run - Applies language settings to sub-agents
  • /alfred:3-sync - Respects report generation settings

File Structure

moai-project-language-initializer/
├── SKILL.md          # Main skill implementation
├── examples.md       # Usage examples and workflows
├── reference.md      # Technical API reference
└── README.md         # This quick overview

Supported Languages

LanguageCodeConversationAgent PromptsCost Impact
EnglishenEnglishEnglishBaseline
Koreanko한국어English/Korean+15% if Korean
Japaneseja日本語English/Japanese+20% if Japanese
Chinesezh中文English/Chinese+18% if Chinese

Team Workflows

Feature Branch + PR (Recommended for Teams)

  • Creates feature branch for each SPEC
  • Requires pull request review
  • Best for code quality and team collaboration

Direct Commit to Develop (Fast Iteration)

  • Commits directly to develop branch
  • No PR process required
  • Best for prototypes and individual projects

Per-SPEC Decision (Maximum Flexibility)

  • Ask user to choose workflow for each SPEC
  • Adapts to different project needs
  • Good for mixed project types

Cost Optimization Tips

  1. Use English for agent prompts - Saves 15-20% on tokens
  2. Choose Minimal report generation - Reduces token usage by 80%
  3. Configure team settings upfront - Avoids reconfiguration costs

Error Handling

The skill includes comprehensive error handling:

  • Input validation with helpful error messages
  • Automatic recovery from missing configurations
  • Graceful degradation for system errors
  • Backup and restore capabilities

Getting Help

For detailed technical information:

  • See examples.md for practical usage patterns
  • See reference.md for complete API documentation
  • See SKILL.md for full implementation details

Version Information

  • Version: 1.0.0
  • Created: 2025-11-05
  • Status: Active
  • Tier: Alfred
  • Compatibility: MoAI-ADK v0.17.0+

This skill is part of the MoAI-ADK ecosystem and follows all official skill standards and best practices.

下载 Skill