Update README with clearer Windows instructions

- Add prominent warning about platform differences
- Add Windows-specific FAQ entry
- Add Windows update commands
- Improve visual separation with section dividers
- Add -Force flag to Copy-Item for better reliability

Co-Authored-By: Claude <noreply@anthropic.com>

README.md

@@ -10,7 +10,7 @@ Skills 是 Claude Code 的扩展模块，为特定的领域或任务提供专业
 
 由于 Claude Code 目前仅支持 GitHub 格式的技能仓库，本仓库需要**手动安装**。
 
-### 一键安装脚本
+### 一键安装脚本（推荐）
 
 **macOS / Linux:**
 ```bash
@@ -25,9 +25,14 @@ irm https://git.let5see.xyz/let5see/skills/raw/main/install.ps1 | iex
 **Windows (批处理):**
 下载 `install.bat` 文件，双击运行
 
+---
+
 ### 手动安装步骤
 
-**macOS / Linux:**
+> ⚠️ **注意**：不同平台的命令语法不同，请根据你的系统选择对应的命令。
+
+#### macOS / Linux
+
 ```bash
 # 1. 克隆仓库
 git clone https://git.let5see.xyz/let5see/skills.git ~/tmp-skills
@@ -42,13 +47,14 @@ rm -rf ~/tmp-skills
 ls ~/.claude/skills/
 ```
 
-**Windows:**
+#### Windows (PowerShell)
+
 ```powershell
 # 1. 克隆仓库
 git clone https://git.let5see.xyz/let5see/skills.git $env:TEMP\tmp-skills
 
 # 2. 复制所有 skills 到本地
-Copy-Item -Recurse $env:TEMP\tmp-skills\* $env:USERPROFILE\.claude\skills\
+Copy-Item -Recurse -Force $env:TEMP\tmp-skills\* $env:USERPROFILE\.claude\skills\
 
 # 3. 清理临时文件
 Remove-Item -Recurse -Force $env:TEMP\tmp-skills
@@ -57,6 +63,13 @@ Remove-Item -Recurse -Force $env:TEMP\tmp-skills
 dir $env:USERPROFILE\.claude\skills\
 ```
 
+> **Windows 用户注意**：
+> - PowerShell 中 `~` 符号**不会**自动展开
+> - 必须使用 `$env:USERPROFILE` 或 `$HOME` 表示用户主目录
+> - 必须使用 `$env:TEMP` 表示临时目录
+
+---
+
 ## 可用 Skills
 
 ### codex-collab
@@ -77,6 +90,8 @@ dir $env:USERPROFILE\.claude\skills\
 - Bug 诊断
 - 架构优化
 
+---
+
 ## 如何使用
 
 安装后，Claude Code 会自动加载 skills。当你提出相关需求时，Claude Code 会自动触发相应的 skill。
@@ -90,6 +105,8 @@ Claude Code：[自动触发 codex-collab skill]
 正在调用 Codex 进行调试分析...
 ```
 
+---
+
 ## 目录结构
 
 **macOS / Linux:**
@@ -118,20 +135,36 @@ Claude Code：[自动触发 codex-collab skill]
 │       └── complete-session.md
 ```
 
+---
+
 ## 更新 Skills
 
+### macOS / Linux
+
 ```bash
-# 更新所有 skills
 cd ~/.claude/skills
 git pull
 ```
 
+### Windows (PowerShell)
+
+```powershell
+cd $env:USERPROFILE\.claude\skills
+git pull
+```
+
+---
+
 ## 常见问题
 
 ### Q: 为什么不能直接在 Claude Code 中添加这个仓库？
 
 A: Claude Code 目前仅支持 GitHub URL 格式的技能仓库。自托管仓库需要手动安装。
 
+### Q: Windows 下提示找不到路径怎么办？
+
+A: 确保使用 `$env:USERPROFILE` 和 `$env:TEMP` 而不是 `~` 符号。PowerShell 不会自动展开 `~`。
+
 ### Q: 如何卸载某个 skill？
 
 **macOS / Linux:**
@@ -148,6 +181,8 @@ Remove-Item -Recurse -Force $env:USERPROFILE\.claude\skills\skill-name
 
 A: 欢迎提交 Pull Request！
 
+---
+
 ## 许可证
 
 各 skill 的许可证请参考其各自的说明文件。