docs: 重构命令和技能文档体系，规范化文档格式和内容组织

skill/gitea/SKILL.md

@@ -7,6 +7,51 @@ description: Comprehensive Gitea management tool for creating runners, workflows
 
 完整的 Gitea 管理工具，提供 Runner、Workflow、仓库的创建和管理功能。
 
+## 工作目录
+
+**重要：该技能和所有相关命令的工作目录统一为：**
+
+### macOS / Linux
+```bash
+~/.config/gitea/
+```
+
+### Windows
+```powershell
+# PowerShell
+$env:USERPROFILE\.config\gitea\
+
+# CMD
+%USERPROFILE%\.config\gitea\
+
+# 完整路径示例
+C:\Users\YourUsername\.config\gitea\
+```
+
+所有配置文件、Runner 目录、日志文件都存储在此目录下。请确保该目录具有适当的读写权限。
+
+**目录结构（所有平台通用）：**
+```
+.config/gitea/
+├── config.env          # 主配置文件（Gitea URL、Token、默认组织等）
+├── runners/            # Runner 配置目录
+│   └── runner-*/       # 各个 runner 的独立目录
+└── .gitignore          # Git 忽略文件（保护敏感信息）
+```
+
+**平台兼容性：**
+- **macOS**: `~/.config/gitea/`（完全支持）
+- **Linux**: `~/.config/gitea/`（完全支持）
+- **Windows**: `%USERPROFILE%\.config\gitea\`（Act Runner 支持，但该技能的命令和脚本需要适配）
+
+**Windows 用户注意事项：**
+- Gitea Act Runner 官方支持 Windows 平台（包括 Host 模式）
+- 该技能文档中的命令和脚本主要基于 Bash，Windows 用户需要：
+  - 使用 PowerShell 或 Git Bash 执行命令
+  - 调整路径格式（如将 `~/.config/gitea` 改为 `%USERPROFILE%\.config\gitea`）
+  - 在 workflow 中指定 `shell: powershell`
+- Windows 安装 act_runner：从 [官方 Releases](https://gitea.com/gitea/act_runner/releases) 下载 Windows 二进制文件
+
 ## 功能概览
 
 | 功能模块 | 文档 | 说明 |