feat(gitea): 为 runner 创建添加前置条件检查

添加网络和硬件配置的前置条件检查：
- 网络连接检查：确保能访问外网（google.com）
- 硬件资源检查：确保满足最低配置 2C4G
- 新增命令行选项用于跳过检查
- 更新文档说明前置条件要求

skill/gitea/create-runner.md

@@ -7,8 +7,21 @@ agent: general
 
 本文档提供了多种创建 Gitea Actions Runner 的方式，支持 Host 模式和 Docker 模式。
 
-## ⚠️ 重要：网络模式要求
+## ⚠️ 重要：前置条件
 
+**创建 Runner 前请确保满足以下条件：**
+
+### 1. 网络访问要求
+- **必须能够访问外网**（如 google.com）
+- Runner 需要从 Docker Hub、GitHub 等拉取镜像和依赖
+- 如果无法访问外网，workflow 执行会失败
+
+### 2. 硬件配置要求
+- **最低配置：2C4G**（2 核 CPU + 4GB 内存）
+- **推荐配置：4C8G** 或更高
+- 配置过低会导致 workflow 执行缓慢或失败
+
+### 3. 网络模式要求
 **两种模式都必须使用 host 网络模式，否则缓存功能无法正常工作！**
 
 - **Docker 模式**：Runner 容器和 Job 容器都使用 host 网络
@@ -96,6 +109,10 @@ Docker 模式使用预定义的镜像映射：
 
 ## 📦 快速使用
 
+**使用前请确认：**
+1. ✅ 主机能访问外网（如 google.com）
+2. ✅ 硬件配置满足 2C4G（推荐 4C8G）
+
 ### 方法一：直接执行（推荐）
 复制以下命令到终端执行，可指定参数：
 
@@ -382,6 +399,8 @@ RUNNER_NAME=""
 ALL_MODE=false
 INTERACTIVE=false
 SKIP_CHECKS=false
+SKIP_NETWORK_CHECK=false
+SKIP_RESOURCE_CHECK=false
 
 # 显示帮助
 show_help() {
@@ -397,7 +416,9 @@ Gitea Actions Runner 创建脚本
   --token TOKEN        Gitea 注册令牌 (必需)
   --gitea-url URL      Gitea 实例地址 (默认: https://git.shigongcao.com)
   --name NAME         Runner 名称 (默认: hostname)
-  --skip-checks       跳过依赖检查
+  --skip-checks       跳过所有检查
+  --skip-network-check 跳过网络连接检查
+  --skip-resource-check 跳过硬件资源检查
   --interactive        交互模式 (传统方式)
   --help               显示此帮助信息
 
@@ -423,7 +444,9 @@ while [[ $# -gt 0 ]]; do
     --token) GITEA_TOKEN="$2"; shift ;;
     --gitea-url) GITEA_URL="$2"; shift ;;
     --name) RUNNER_NAME="$2"; shift ;;
-    --skip-checks) SKIP_CHECKS=true ;;
+    --skip-checks) SKIP_CHECKS=true; SKIP_NETWORK_CHECK=true; SKIP_RESOURCE_CHECK=true ;;
+    --skip-network-check) SKIP_NETWORK_CHECK=true ;;
+    --skip-resource-check) SKIP_RESOURCE_CHECK=true ;;
     --interactive) INTERACTIVE=true ;;
     --help) show_help ;;
     *) echo "❌ 未知参数: $1"; echo "使用 --help 查看帮助"; exit 1 ;;
@@ -439,7 +462,95 @@ if [ -z "$GITEA_TOKEN" ] && [ "$INTERACTIVE" = false ]; then
 fi
 
 # ==========================================
-# 2. Interactive Mode (向后兼容)
+# 2. Pre-flight Checks (前置条件检查)
+# ==========================================
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "前置条件检查"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# 2.1 网络连接检查
+if [ "$SKIP_NETWORK_CHECK" = false ]; then
+  echo "检查外网连接..."
+  
+  # 尝试连接 Google（使用 curl 超时 5 秒）
+  if curl -s --connect-timeout 5 --max-time 10 https://www.google.com > /dev/null 2>&1; then
+    echo "✓ 外网连接正常 (google.com 可访问)"
+  else
+    echo "⚠️  警告：无法访问 google.com"
+    echo "   Runner 需要访问外网来拉取镜像和依赖"
+    echo "   如果你确认网络正常，可以使用 --skip-network-check 跳过检查"
+    read -p "   是否继续？[y/N]: " continue_choice
+    if [ "$continue_choice" != "y" ] && [ "$continue_choice" != "Y" ]; then
+      echo "❌ 已取消"
+      exit 1
+    fi
+  fi
+else
+  echo "⊘ 已跳过网络连接检查"
+fi
+echo ""
+
+# 2.2 硬件资源检查
+if [ "$SKIP_RESOURCE_CHECK" = false ]; then
+  echo "检查硬件资源..."
+  
+  # 检测 CPU 核心数
+  if command -v nproc > /dev/null 2>&1; then
+    cpu_cores=$(nproc)
+  elif command -v sysctl > /dev/null 2>&1; then
+    cpu_cores=$(sysctl -n hw.ncpu 2>/dev/null || echo "0")
+  else
+    cpu_cores=0
+  fi
+  
+  # 检测内存大小（GB）
+  if command -v free > /dev/null 2>&1; then
+    mem_gb=$(free -g | awk '/^Mem:/{print $2}')
+  elif command -v sysctl > /dev/null 2>&1; then
+    mem_bytes=$(sysctl -n hw.memsize 2>/dev/null || echo "0")
+    mem_gb=$((mem_bytes / 1024 / 1024 / 1024))
+  else
+    mem_gb=0
+  fi
+  
+  echo "  CPU: ${cpu_cores} 核"
+  echo "  内存: ${mem_gb}GB"
+  
+  # 检查是否满足最低配置
+  config_ok=true
+  if [ "$cpu_cores" -lt 2 ]; then
+    echo "⚠️  警告：CPU 核心数不足 (当前 ${cpu_cores} 核，建议至少 2 核)"
+    config_ok=false
+  fi
+  
+  if [ "$mem_gb" -lt 4 ]; then
+    echo "⚠️  警告：内存不足 (当前 ${mem_gb}GB，建议至少 4GB)"
+    config_ok=false
+  fi
+  
+  if [ "$config_ok" = false ]; then
+    echo ""
+    echo "   最低配置要求：2C4G (2 核 CPU + 4GB 内存)"
+    echo "   推荐配置：4C8G 或更高"
+    echo "   配置过低可能导致 workflow 执行失败或缓慢"
+    read -p "   是否继续？[y/N]: " continue_choice
+    if [ "$continue_choice" != "y" ] && [ "$continue_choice" != "Y" ]; then
+      echo "❌ 已取消"
+      exit 1
+    fi
+  else
+    echo "✓ 硬件资源满足要求"
+  fi
+else
+  echo "⊘ 已跳过硬件资源检查"
+fi
+echo ""
+
+# ==========================================
+# 3. Interactive Mode (向后兼容)
 # ==========================================
 
 if [ "$INTERACTIVE" = true ]; then
@@ -460,7 +571,7 @@ if [ "$INTERACTIVE" = true ]; then
 fi
 
 # ==========================================
-# 3. Load Gitea Configuration
+# 4. Load Gitea Configuration
 # ==========================================
 
 # 如果未通过命令行提供，尝试从配置文件加载
@@ -571,7 +682,7 @@ fi
 echo ""
 
 # ==========================================
-# 3. Load Gitea Configuration
+# 4. Load Gitea Configuration
 # ==========================================
 
 # 如果未通过命令行提供，尝试从配置文件加载
@@ -604,7 +715,7 @@ echo "  Token: ${GITEA_TOKEN:0:8}..."
 echo ""
 
 # ==========================================
-# 4. Generate Runner Name
+# 5. Generate Runner Name
 # ==========================================
 
 # 如果未指定名称，生成默认名称
@@ -629,7 +740,7 @@ fi
 echo ""
 
 # ==========================================
-# 5. Main Creation Function
+# 6. Main Creation Function
 # ==========================================
 
 create_runner() {
@@ -664,7 +775,7 @@ create_runner() {
   fi
   
   # ==========================================
-  # 5.1 Check Dependencies
+  # 6.1 Check Dependencies
   # ==========================================
   
   if [ "$SKIP_CHECKS" = false ]; then
@@ -693,7 +804,7 @@ create_runner() {
   fi
   
   # ==========================================
-  # 5.2 Detect System Environment & Labels
+  # 6.2 Detect System Environment & Labels
   # ==========================================
   
   echo "生成 Labels..."
@@ -778,7 +889,7 @@ create_runner() {
   echo ""
   
   # ==========================================
-  # 5.3 Create Runner Directory
+  # 6.3 Create Runner Directory
   # ==========================================
   
   echo "创建 Runner 目录..."
@@ -791,7 +902,7 @@ create_runner() {
   echo ""
   
   # ==========================================
-  # 5.4 Create Configuration File
+  # 6.4 Create Configuration File
   # ==========================================
   
   echo "创建配置文件..."
@@ -909,7 +1020,7 @@ EOF
   fi
   
 # ==========================================
-# 5.5 Display Runner Info
+# 6.5 Display Runner Info
 # ==========================================
   
   echo ""
@@ -930,7 +1041,7 @@ EOF
 }
 
 # ==========================================
-# 6. Main Execution Logic
+# 7. Main Execution Logic
 # ==========================================
 
 echo ""
@@ -1046,7 +1157,7 @@ echo "  $labels"
 echo ""
 
 # ==========================================
-# 6. Create Runner Directory
+# 7. Create Runner Directory
 # ==========================================
 
 echo "创建 Runner 目录..."