flutter-china-deploy

DevOps Community

Repo stars 0
Author repo skills-registry

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: 当用户需要部署 Flutter 项目时，按以下步骤执行：在终端执行或写入 ~/.zshrc： export PUBHOSTEDURL=https://pub.flutter-io.cn export FLUTTERSTORAGEBASE_URL=http…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “快速开始”, “1. 设置环境变量镜像”, “2. 项目初始化 (FVM 版)”, “Gradle 配置优化”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name flutter-china-deploy directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “快速开始 / 1. 设置环境变量镜像 / 2. 项目初始化 (FVM 版)” before expanding.

Boundaries And Review

Dependencies: It usually needs no extra API key, so start with a small validation task.
Permissions: Declared permissions include read / shell-exec; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

Flutter 中国环境部署加速

快速开始

当用户需要部署 Flutter 项目时，按以下步骤执行：

1. 设置环境变量镜像

在终端执行或写入 ~/.zshrc：

export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

2. 项目初始化 (FVM 版)

fvm install stable
fvm use stable --force
fvm flutter pub get

Gradle 配置优化

gradle-wrapper.properties

修改 android/gradle/wrapper/gradle-wrapper.properties：

distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.10.2-all.zip

settings.gradle.kts

在 android/settings.gradle.kts 的 repositories 块添加：

repositories {
    maven { url = uri("https://storage.flutter-io.cn/download.flutter.io") }
    maven { url = uri("https://maven.aliyun.com/repository/google") }
    maven { url = uri("https://maven.aliyun.com/repository/public") }
    maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
    google()
    mavenCentral()
}

build.gradle.kts

在 android/build.gradle.kts 同样配置 Maven 镜像。

gradle.properties

在 android/gradle.properties 添加优化配置：

kotlin.compiler.execution.strategy=in-process
org.gradle.daemon=false
android.useAndroidX=true
android.enableJetifier=true

Android SDK 配置

local.properties

创建或修改 android/local.properties：

sdk.dir=/Volumes/MacOS/Android/sdk

环境变量

在 ~/.zshrc 添加：

export ANDROID_HOME=/Volumes/MacOS/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools

运行项目

export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn && \
export PUB_HOSTED_URL=https://pub.flutter-io.cn && \
fvm flutter run -d <设备ID>

常见问题排查

错误信息	解决方案
Timeout waiting to lock build logic queue	`pkill -f gradle` 并删除 `android/.gradle`
Could not find io.flutter:...	检查 `settings.gradle.kts` 是否包含 `download.flutter.io` 镜像
Operation not permitted	检查 `GRADLE_USER_HOME` 路径权限

配置脚本

使用 scripts/configure_mirrors.py 自动配置：

# 检查当前配置状态
python3 scripts/configure_mirrors.py --check

# 配置 Shell 环境变量
python3 scripts/configure_mirrors.py --shell

# 配置 Gradle 镜像 (指定项目路径)
python3 scripts/configure_mirrors.py --project /path/to/flutter/project --gradle

# 执行所有配置
python3 scripts/configure_mirrors.py --project /path/to/flutter/project --all

Source: boshi-xixixi/TraeSkill — distributed by TomeVault.

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: DevOps
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @tomevault-io · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Guided setup
External API key: No requirement detected
Detected OS requirements: macOS
Runtime requirements: Unspecified
Detected file/system behavior: Read-only
Shell exec
Detected network behavior: Local-only
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview flutter-china-deploy.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# Flutter 中国环境部署加速

## 快速开始

当用户需要部署 Flutter 项目时，按以下步骤执行：

### 1. 设置环境变量镜像

在终端执行或写入 `~/.zshrc`：

```bash
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
```

### 2. 项目初始化 (FVM 版)

```bash
fvm install stable
fvm use stable --force
fvm flutter pub get
```

## Gradle 配置优化

### gradle-wrapper.properties

修改 `android/gradle/wrapper/gradle-wrapper.properties`：

```properties
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.10.2-all.zip
```

### settings.gradle.kts

在 `android/settings.gradle.kts` 的 `repositories` 块添加：

```kotlin
repositories {
    maven { url = uri("https://storage.flutter-io.cn/download.flutter.io") }
    maven { url = uri("https://maven.aliyun.com/repository/google") }
    maven { url = uri("https://maven.aliyun.com/repository/public") }
    maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
    google()
    mavenCentral()
}
```

### build.gradle.kts

在 `android/build.gradle.kts` 同样配置 Maven 镜像。

### gradle.properties

在 `android/gradle.properties` 添加优化配置：

```properties
kotlin.compiler.execution.strategy=in-process
org.gradle.daemon=false
android.useAndroidX=true
android.enableJetifier=true
```

## Android SDK 配置

### local.properties

创建或修改 `android/local.properties`：

```properties
sdk.dir=/Volumes/MacOS/Android/sdk
```

### 环境变量

在 `~/.zshrc` 添加：

```bash
export ANDROID_HOME=/Volumes/MacOS/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools
```

## 运行项目

```bash
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn && \
export PUB_HOSTED_URL=https://pub.flutter-io.cn && \
fvm flutter run -d <设备ID>
```

## 常见问题排查

| 错误信息 | 解决方案 |
|---------|---------|

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> 快速开始 → 1. 设置环境变量镜像 → 2. 项目初始化 (FVM 版) → Gradle 配置优化 → gradle-wrapper.properties → settings.gradle.kts
terms    -> 在 android/build.gradle.kts 同样配置 Maven 镜像。 · --- > Source: [boshi-xixixi/TraeSkill](https://github.com/boshi-xixixi/TraeSkill) — distributed by [TomeVault](https://tomevault.io).
files/cmd -> ~/.zshrc · android/gradle/wrapper/gradle-wrapper.properties · android/settings.gradle.kts · repositories · android/build.gradle.kts · android/gradle.properties · android/local.properties · pkill -f gradle
body sha256 -> 546528c9e5b3