@musashishao/agent-kit 1.8.2 → 1.9.1

package/.agent/skills/game-development/compliance-rating/SKILL.md

@@ -0,0 +1,277 @@
+---
+name: compliance-rating
+description: Age rating, legal compliance, and store policies for game publishing. IARC, ESRB, PEGI, COPPA, GDPR, and platform-specific requirements for iOS and Android.
+---
+
+# Game Compliance & Rating Skill
+
+> **Purpose**: Navigate legal requirements and store policies for game publishing.
+
+## When to Use
+- Preparing for store submission
+- Implementing age-appropriate content
+- Handling player data
+- Disclosing monetization practices
+
+---
+
+## 1. Age Rating Systems
+
+### Major Rating Bodies
+| System | Region | Ages |
+|--------|--------|------|
+| **IARC** | Global (Mobile) | 3, 7, 12, 16, 18 |
+| **ESRB** | North America | E, E10+, T, M, AO |
+| **PEGI** | Europe | 3, 7, 12, 16, 18 |
+| **CERO** | Japan | A, B, C, D, Z |
+| **ACB** | Australia | G, PG, M, MA15+ |
+
+### IARC Questionnaire Topics
+1. **Violence** - Type and intensity
+2. **Fear** - Scary content
+3. **Sexuality** - Sexual content/themes
+4. **Language** - Profanity
+5. **Drugs** - Drug/alcohol references
+6. **Gambling** - Real/simulated gambling
+7. **User Interaction** - Online features
+8. **In-App Purchases** - Monetization
+
+### Rating Questionnaire Tips
+- Answer based on **all possible content**
+- Include user-generated content if applicable
+- Consider worst-case scenarios
+- Re-rate when adding mature content
+
+---
+
+## 2. COPPA Compliance (Kids' Games)
+
+### What is COPPA?
+> Children's Online Privacy Protection Act (USA)
+> Applies to games targeting children under 13
+
+### COPPA Requirements
+| Requirement | Implementation |
+|-------------|----------------|
+| **Parental Consent** | Before collecting any data |
+| **Data Minimization** | Collect only what's necessary |
+| **No Behavioral Ads** | Use contextual ads only |
+| **Delete on Request** | Provide data deletion |
+
+### COPPA Checklist
+- [ ] No personal data collection without consent
+- [ ] Age gate at app start
+- [ ] No targeted advertising
+- [ ] No social features without parental approval
+- [ ] Privacy policy for children
+- [ ] COPPA-approved ad networks only
+
+### COPPA-Safe Analytics
+```csharp
+// Firebase Analytics for kids apps
+FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);
+// Use aggregate analytics only
+```
+
+---
+
+## 3. GDPR Compliance (EU)
+
+### GDPR Requirements
+| Right | Implementation |
+|-------|----------------|
+| **Right to Access** | Export player data |
+| **Right to Deletion** | Delete all player data |
+| **Right to Consent** | Clear opt-in for data |
+| **Right to Portability** | Data in readable format |
+
+### Consent Flow
+```csharp
+public class GDPRConsentManager : MonoBehaviour
+{
+    public void ShowConsentDialog()
+    {
+        // Show UI with:
+        // - What data is collected
+        // - Why it's collected
+        // - Who receives it
+        // - How to withdraw consent
+    }
+    
+    public void SetConsent(bool analytics, bool ads, bool crashReporting)
+    {
+        PlayerPrefs.SetInt("consent_analytics", analytics ? 1 : 0);
+        PlayerPrefs.SetInt("consent_ads", ads ? 1 : 0);
+        PlayerPrefs.SetInt("consent_crash", crashReporting ? 1 : 0);
+        
+        // Apply settings
+        FirebaseAnalytics.SetAnalyticsCollectionEnabled(analytics);
+    }
+}
+```
+
+### Privacy Policy Requirements
+- [ ] What data is collected
+- [ ] Purpose of collection
+- [ ] Third parties receiving data
+- [ ] Data retention period
+- [ ] Contact for data requests
+- [ ] Last updated date
+
+---
+
+## 4. Loot Box / Gacha Disclosure
+
+### Disclosure Requirements by Region
+| Region | Requirement |
+|--------|-------------|
+| **China** | Publish exact drop rates |
+| **Japan** | Publish rates + no kompu gacha |
+| **Belgium** | Banned (considered gambling) |
+| **Netherlands** | Banned in some cases |
+| **Apple (Global)** | Disclose rates before purchase |
+| **Google (Global)** | Disclose rates before purchase |
+
+### Implementation
+```csharp
+// Display before purchase
+public class GachaDisclosure : MonoBehaviour
+{
+    [System.Serializable]
+    public struct DropRate
+    {
+        public string itemName;
+        public float percentage;
+    }
+    
+    [SerializeField] private DropRate[] _rates;
+    
+    public void ShowDropRates()
+    {
+        // Display UI with all rates
+        // Total must equal 100%
+        // Show before ANY purchase
+    }
+}
+```
+
+### Gacha Compliance Checklist
+- [ ] Display drop rates before purchase
+- [ ] Rates are accurate and complete
+- [ ] No psychological manipulation (pity timers must be disclosed)
+- [ ] Minors cannot purchase without parental consent
+
+---
+
+## 5. Apple App Store Policies
+
+### Key Requirements
+| Policy | Detail |
+|--------|--------|
+| **IAP Requirement** | All digital purchases via Apple IAP |
+| **Subscription Disclosure** | Clear pricing and renewal terms |
+| **Privacy Labels** | App Store privacy questionnaire |
+| **Sign in with Apple** | Required if social login exists |
+| **Health Claims** | No unverified health claims |
+
+### Apple Rejection Reasons (Games)
+1. **Incomplete metadata** - Missing screenshots/descriptions
+2. **Placeholder content** - Lorem ipsum, "coming soon"
+3. **Crashes** - Crashes during review
+4. **Broken functionality** - Features don't work
+5. **Privacy violations** - Undisclosed data collection
+
+---
+
+## 6. Google Play Policies
+
+### Key Requirements
+| Policy | Detail |
+|--------|--------|
+| **Target API Level** | Must meet current requirements |
+| **Data Safety Section** | Declare all data collection |
+| **Family Policy** | Extra requirements for kids apps |
+| **Real Money Gambling** | Restricted by region |
+| **Subscription Transparency** | Clear cancellation flow |
+
+### Google Play Data Safety Questionnaire
+- [ ] Data collected (location, contacts, etc.)
+- [ ] Data shared with third parties
+- [ ] Data encryption in transit
+- [ ] Data deletion available
+- [ ] Independent security review (optional)
+
+---
+
+## 7. Mobile Ads Compliance
+
+### Ad Content Guidelines
+| Allowed | Prohibited |
+|---------|------------|
+| Interstitial with clear X | Auto-click ads |
+| Rewarded video | Deceptive close buttons |
+| Banner (non-obstructive) | Inappropriate for rating |
+| Skip after 5s | Unskippable >30s |
+
+### Ad Implementation Checklist
+- [ ] Clear close button (not hidden)
+- [ ] No ads during gameplay without pause
+- [ ] No incentivized installs
+- [ ] No adult ads in kids games
+- [ ] Frequency caps respected
+
+---
+
+## Compliance Checklist Template
+
+```markdown
+## Pre-Submission Compliance: [Game Name]
+
+### Age Rating
+- [ ] IARC questionnaire completed
+- [ ] Content descriptors accurate
+- [ ] Rating displayed in-game
+
+### Privacy
+- [ ] Privacy policy URL in store listing
+- [ ] Privacy policy URL in-game settings
+- [ ] GDPR consent dialog (EU)
+- [ ] Data deletion request method
+
+### Monetization
+- [ ] IAP through official store
+- [ ] Drop rates disclosed (gacha)
+- [ ] Subscription terms clear
+
+### Platform-Specific
+- [ ] Apple: Privacy labels complete
+- [ ] Apple: Sign in with Apple (if social login)
+- [ ] Google: Data safety section complete
+- [ ] Google: Target API level met
+
+### Child Safety (if applicable)
+- [ ] COPPA compliant
+- [ ] Age gate implemented
+- [ ] No targeted ads
+```
+
+---
+
+## Anti-Patterns
+
+| ❌ Don't | ✅ Do |
+|----------|-------|
+| Hide drop rates | Disclose before purchase |
+| Collect data without consent | Ask permission first |
+| Ignore regional laws | Research per market |
+| Use deceptive ads | Clear close buttons |
+| Skip privacy policy | Maintain up-to-date policy |
+
+---
+
+## Related Skills
+- `game-development/game-economy-designer`
+- `game-development/liveops`
+
+## Related Workflows
+- `/game-launch` - Phase 1 includes compliance review

package/.agent/skills/game-development/crossplatform-build/SKILL.md

@@ -0,0 +1,386 @@
+---
+name: crossplatform-build
+description: Multi-platform build management for games. Unity Addressables, platform-specific code, CI/CD pipelines, build size optimization, and conditional compilation patterns.
+---
+
+# Cross-Platform Build Skill
+
+> **Purpose**: Ship your game to multiple platforms efficiently.
+
+## When to Use
+- Setting up multi-platform project
+- Optimizing platform-specific builds
+- Configuring CI/CD for game builds
+- Managing platform-specific code
+
+---
+
+## 1. Platform-Specific Code Patterns
+
+### Preprocessor Directives
+```csharp
+public class PlatformManager : MonoBehaviour
+{
+    public void Initialize()
+    {
+        #if UNITY_IOS
+            InitializeIOS();
+        #elif UNITY_ANDROID
+            InitializeAndroid();
+        #elif UNITY_WEBGL
+            InitializeWebGL();
+        #elif UNITY_STANDALONE_WIN
+            InitializeWindows();
+        #elif UNITY_STANDALONE_OSX
+            InitializeMac();
+        #else
+            InitializeDefault();
+        #endif
+    }
+    
+    #if UNITY_IOS
+    private void InitializeIOS()
+    {
+        // iOS-specific: Haptics, Game Center, etc.
+        Application.targetFrameRate = 60;
+    }
+    #endif
+    
+    #if UNITY_ANDROID
+    private void InitializeAndroid()
+    {
+        // Android-specific: Vibration, Play Games, etc.
+        Screen.sleepTimeout = SleepTimeout.NeverSleep;
+    }
+    #endif
+}
+```
+
+### Available Platform Defines
+| Define | Platform |
+|--------|----------|
+| `UNITY_IOS` | iOS |
+| `UNITY_ANDROID` | Android |
+| `UNITY_WEBGL` | WebGL |
+| `UNITY_STANDALONE_WIN` | Windows |
+| `UNITY_STANDALONE_OSX` | macOS |
+| `UNITY_STANDALONE_LINUX` | Linux |
+| `UNITY_EDITOR` | Unity Editor |
+
+---
+
+## 2. Addressables for Platform Assets
+
+### Why Addressables?
+| Without Addressables | With Addressables |
+|---------------------|-------------------|
+| All assets in build | Load on demand |
+| Large initial download | Smaller install size |
+| Same assets all platforms | Platform-specific variants |
+
+### Platform-Specific Asset Labels
+```csharp
+// In Addressables Groups settings
+// Label assets: "ios", "android", "hd", "sd"
+
+public class AssetLoader : MonoBehaviour
+{
+    public async void LoadPlatformAsset(string key)
+    {
+        string label = GetPlatformLabel();
+        
+        var handle = Addressables.LoadAssetAsync<GameObject>(key, label);
+        var asset = await handle.Task;
+        Instantiate(asset);
+    }
+    
+    private string GetPlatformLabel()
+    {
+        #if UNITY_IOS
+            return "ios";
+        #elif UNITY_ANDROID
+            return "android";
+        #else
+            return "default";
+        #endif
+    }
+}
+```
+
+### Addressables Group Strategy
+```
+Groups/
+├── Core/              # Always included in build
+│   ├── Player.prefab
+│   ├── UI.prefab
+│   └── Audio.bundle
+├── Levels/            # Loaded per level
+│   ├── Level_01.bundle
+│   └── Level_02.bundle
+├── HD-Assets/         # Label: "hd" (tablets, high-end)
+│   └── Textures_HD.bundle
+└── SD-Assets/         # Label: "sd" (phones, low-end)
+    └── Textures_SD.bundle
+```
+
+---
+
+## 3. Build Size Optimization
+
+### Size Reduction Strategies
+| Strategy | Savings |
+|----------|---------|
+| **Strip Unused Code** | 20-40% |
+| **Compress Textures** | 50-70% |
+| **Use Addressables** | 30-50% initial |
+| **Audio Compression** | 60-80% |
+| **Font Subsetting** | 80-90% |
+
+### Texture Settings by Platform
+```csharp
+// Editor/PlatformTextureSettings.cs
+using UnityEditor;
+
+public class PlatformTextureSettings : AssetPostprocessor
+{
+    void OnPreprocessTexture()
+    {
+        TextureImporter importer = (TextureImporter)assetImporter;
+        
+        // iOS: ASTC
+        var iosSettings = new TextureImporterPlatformSettings
+        {
+            name = "iPhone",
+            overridden = true,
+            format = TextureImporterFormat.ASTC_6x6,
+            maxTextureSize = 1024
+        };
+        importer.SetPlatformTextureSettings(iosSettings);
+        
+        // Android: ETC2
+        var androidSettings = new TextureImporterPlatformSettings
+        {
+            name = "Android",
+            overridden = true,
+            format = TextureImporterFormat.ETC2_RGBA8,
+            maxTextureSize = 1024
+        };
+        importer.SetPlatformTextureSettings(androidSettings);
+    }
+}
+```
+
+### Build Report Analysis
+```csharp
+// After build, check Editor.log for:
+// "Used Assets and files from the Resources folder"
+// Sort by size to identify optimization targets
+```
+
+---
+
+## 4. CI/CD Pipeline
+
+### GitHub Actions for Unity
+```yaml
+# .github/workflows/build.yml
+name: Build Game
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build-android:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          lfs: true
+          
+      - uses: game-ci/unity-builder@v4
+        env:
+          UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
+        with:
+          targetPlatform: Android
+          androidAppBundle: true
+          androidKeystoreName: release.keystore
+          androidKeystoreBase64: ${{ secrets.KEYSTORE_BASE64 }}
+          androidKeystorePass: ${{ secrets.KEYSTORE_PASS }}
+          androidKeyaliasName: ${{ secrets.KEY_ALIAS }}
+          androidKeyaliasPass: ${{ secrets.KEY_ALIAS_PASS }}
+          
+      - uses: actions/upload-artifact@v4
+        with:
+          name: android-build
+          path: build/Android
+          
+  build-ios:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          lfs: true
+          
+      - uses: game-ci/unity-builder@v4
+        env:
+          UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
+        with:
+          targetPlatform: iOS
+          
+      - uses: actions/upload-artifact@v4
+        with:
+          name: ios-build
+          path: build/iOS
+```
+
+### Codemagic for Mobile Games
+```yaml
+# codemagic.yaml
+workflows:
+  unity-android:
+    name: Android Build
+    environment:
+      unity: 2022.3.x
+      groups:
+        - unity_credentials
+        - android_signing
+    scripts:
+      - name: Build Android
+        script: |
+          $UNITY_HOME/Contents/MacOS/Unity -batchmode -quit \
+            -projectPath . \
+            -executeMethod BuildPipeline.BuildAndroidProd \
+            -buildTarget Android
+    artifacts:
+      - build/**/*.aab
+    publishing:
+      google_play:
+        credentials: $GPLAY_CREDENTIALS
+        track: internal
+```
+
+---
+
+## 5. Platform-Specific Plugins
+
+### Plugin Organization
+```
+Assets/Plugins/
+├── iOS/
+│   ├── GameCenter.framework
+│   └── Haptics.mm
+├── Android/
+│   ├── libs/
+│   └── AndroidManifest.xml
+└── Shared/
+    └── NativePlugin.cs
+```
+
+### Native Plugin Bridge
+```csharp
+public static class NativeHaptics
+{
+    public static void Vibrate(float intensity)
+    {
+        #if UNITY_IOS && !UNITY_EDITOR
+            iOSVibrate(intensity);
+        #elif UNITY_ANDROID && !UNITY_EDITOR
+            AndroidVibrate(intensity);
+        #endif
+    }
+    
+    #if UNITY_IOS
+    [DllImport("__Internal")]
+    private static extern void iOSVibrate(float intensity);
+    #endif
+    
+    #if UNITY_ANDROID
+    private static void AndroidVibrate(float intensity)
+    {
+        using var vibrator = new AndroidJavaObject("android.os.Vibrator");
+        // Android vibration logic
+    }
+    #endif
+}
+```
+
+---
+
+## 6. Build Configuration Matrix
+
+### Per-Platform Settings
+| Setting | iOS | Android | WebGL |
+|---------|-----|---------|-------|
+| **Scripting Backend** | IL2CPP | IL2CPP | IL2CPP |
+| **Architecture** | ARM64 | ARM64 | WASM |
+| **API Level** | Latest | API 24+ | N/A |
+| **Stripping** | High | Medium | Low |
+| **Compression** | LZ4HC | LZ4 | Brotli |
+
+### Player Settings Script
+```csharp
+// Editor/BuildConfiguration.cs
+public static class BuildConfiguration
+{
+    [MenuItem("Build/Configure Android")]
+    public static void ConfigureAndroid()
+    {
+        PlayerSettings.Android.minSdkVersion = AndroidSdkVersions.AndroidApiLevel24;
+        PlayerSettings.Android.targetSdkVersion = AndroidSdkVersions.AndroidApiLevel34;
+        PlayerSettings.SetScriptingBackend(BuildTargetGroup.Android, ScriptingImplementation.IL2CPP);
+        PlayerSettings.Android.targetArchitectures = AndroidArchitecture.ARM64;
+        EditorUserBuildSettings.androidBuildType = AndroidBuildType.Release;
+    }
+    
+    [MenuItem("Build/Configure iOS")]
+    public static void ConfigureiOS()
+    {
+        PlayerSettings.iOS.targetOSVersionString = "13.0";
+        PlayerSettings.SetScriptingBackend(BuildTargetGroup.iOS, ScriptingImplementation.IL2CPP);
+        PlayerSettings.iOS.appleEnableAutomaticSigning = true;
+    }
+}
+```
+
+---
+
+## 7. Testing Across Platforms
+
+### Test Matrix
+| Test | Editor | Device | Cloud |
+|------|--------|--------|-------|
+| **Unit Tests** | ✅ | ❌ | ✅ |
+| **Play Mode** | ✅ | ❌ | ✅ |
+| **Performance** | ⚠️ | ✅ | ❌ |
+| **Touch Input** | ⚠️ | ✅ | ❌ |
+| **Crash** | ❌ | ✅ | ❌ |
+
+### Device Farm Services
+- **Firebase Test Lab** (Android)
+- **AWS Device Farm** (iOS/Android)
+- **BrowserStack** (Multiple platforms)
+
+---
+
+## Anti-Patterns
+
+| ❌ Don't | ✅ Do |
+|----------|-------|
+| Same assets all platforms | Platform-specific variants |
+| Build manually | CI/CD automation |
+| Ignore build size | Monitor and optimize |
+| Platform code in main logic | Isolate platform code |
+| Skip device testing | Test on real devices |
+
+---
+
+## Related Skills
+- `game-development/unity-mobile-optimization`
+- `game-development/unity-integration`
+- `devops-engineer`
+
+## Related Workflows
+- `/game-launch` - Phase 3 is Build & Sign