diff --git a/README.md b/README.md index 7e648e5..c8279f1 100644 --- a/README.md +++ b/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 的许可证请参考其各自的说明文件。