From 688411fac8ac55af957fdce7b9162a1e7534a263 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=B0=8F=E7=B3=AF=20=28Xiaonuo=29?= Date: Thu, 23 Apr 2026 17:57:48 +0800 Subject: [PATCH] =?UTF-8?q?feat(onboard):=20=E6=96=B0=E5=A2=9E=2010-cursor?= =?UTF-8?q?-agent=EF=BC=8Cskills-sync=20=E6=94=B9=E4=B8=BA=2011=EF=BC=8C?= =?UTF-8?q?=E5=8E=BB=E6=8E=89=20openclaw-imports?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增 10-cursor-agent.md: 安装 cursor-agent、配置 API Key、YOLO 模式 - 10-skills-sync → 11-skills-sync - skills 同步不再依赖 openclaw-imports 目录 - self-check.sh 同步更新 [小糯] --- hermes/shazhou-family-onboard/SKILL.md | 3 +- .../references/10-cursor-agent.md | 82 +++++++++++++++++++ .../references/10-skills-sync.md | 50 ----------- .../references/11-skills-sync.md | 46 +++++++++++ .../scripts/self-check.sh | 8 +- 5 files changed, 136 insertions(+), 53 deletions(-) create mode 100644 hermes/shazhou-family-onboard/references/10-cursor-agent.md delete mode 100644 hermes/shazhou-family-onboard/references/10-skills-sync.md create mode 100644 hermes/shazhou-family-onboard/references/11-skills-sync.md diff --git a/hermes/shazhou-family-onboard/SKILL.md b/hermes/shazhou-family-onboard/SKILL.md index b9a9055..ba2869f 100644 --- a/hermes/shazhou-family-onboard/SKILL.md +++ b/hermes/shazhou-family-onboard/SKILL.md @@ -41,7 +41,8 @@ skill_view("shazhou-family-onboard", "references/01-nvm-node.md") | 07 | Tailscale 组网 | `references/07-tailscale.md` | 加入 tailnet，验证互通 | | 08 | 家族成员互相认识 | `references/08-family-members.md` | 了解各设备和伙伴的联系方式 | | 09 | Hermes 基础配置 | `references/09-hermes-config.md` | hermes-har、auxiliary models、性格配置 | -| 10 | Skills 同步 | `references/10-skills-sync.md` | 克隆 skills repo，运行 sync.sh | +| 10 | Cursor Agent | `references/10-cursor-agent.md` | 安装 cursor-agent，配置 API Key | +| 11 | Skills 同步 | `references/11-skills-sync.md` | 克隆 skills repo，同步 skills | ## 自检模式 diff --git a/hermes/shazhou-family-onboard/references/10-cursor-agent.md b/hermes/shazhou-family-onboard/references/10-cursor-agent.md new file mode 100644 index 0000000..2d39c22 --- /dev/null +++ b/hermes/shazhou-family-onboard/references/10-cursor-agent.md @@ -0,0 +1,82 @@ +# 10. Cursor Agent (Coding Agent) + +## 检查 + +```bash +cursor-agent --version +echo $CURSOR_API_KEY | head -c 10 +``` + +✅ 达标：`cursor-agent` 可用，`CURSOR_API_KEY` 已配置 + +## 前置 + +- 已完成 01 (Node.js & nvm) +- 已完成 03 (cfg CLI) — API key 存入 cfg + +## 安装 + +### 1. 安装 cursor-agent + +```bash +# 下载最新版 +curl -fsSL https://www.cursor.com/agent/install.sh | bash +``` + +安装后确认： + +```bash +cursor-agent --version +``` + +### 2. 获取 API Key + +向主人 (沙洲) 索取 Cursor API Key。拿到后存入 cfg： + +```bash +cfg set CURSOR_API_KEY '拿到的key' --secret +``` + +### 3. 配置 YOLO 模式 + +编辑 `~/.cursor/cli-config.json`，设置： + +```json +{ + "approvalMode": "none" +} +``` + +这样 cursor-agent 执行命令时不需要逐条审批。 + +### 4. 环境变量 + +确认 `cfg env` 会导出 `CURSOR_API_KEY`： + +```bash +eval "$(cfg env)" +echo $CURSOR_API_KEY | head -c 10 +``` + +## 使用 + +Hermes 通过 delegate_tool 调用 cursor-agent 执行编码任务： + +```bash +# 直接使用 +cursor-agent "实现 xxx 功能" + +# 在指定目录工作 +cd /path/to/project && cursor-agent "修复 bug" +``` + +## 验证 + +```bash +cursor-agent --version +# 应显示版本号 + +eval "$(cfg env)" +echo $CURSOR_API_KEY | head -c 10 +# 应显示 key 前缀 +``` diff --git a/hermes/shazhou-family-onboard/references/10-skills-sync.md b/hermes/shazhou-family-onboard/references/10-skills-sync.md deleted file mode 100644 index 2f26336..0000000 --- a/hermes/shazhou-family-onboard/references/10-skills-sync.md +++ /dev/null @@ -1,50 +0,0 @@ -# 10. Skills 同步 - -## 检查 - -确认 skills repo 已克隆： - - ls ~/skills/sync.sh - -确认 skills 已同步到 Hermes： - - ls ~/.hermes/skills/openclaw-imports/ - -✅ 达标：`~/skills` 存在，`~/.hermes/skills/openclaw-imports/` 下有各 skill 目录 - -## 安装 - -### 克隆 skills repo - - cd ~ - git clone https://git.shazhou.work/shazhou/skills.git - -### 同步到 Hermes - - cd ~/skills - bash sync.sh - -### 目录结构 - -``` -~/skills/ -├── hermes/ # Hermes Agent skills -├── cursor/ # Cursor rules (.mdc) -├── sync.sh # hermes skills → ~/.hermes/skills/openclaw-imports/ -└── README.md -``` - -## 验证 - - ls ~/.hermes/skills/openclaw-imports/ - # 应该能看到 coding-workflow, wiki-writing 等目录 - -## 日常使用 - -有新 skill 更新时： - - cd ~/skills && git pull && bash sync.sh - -Cursor rules 需要手动复制到项目： - - cp ~/skills/cursor/gitea-review.mdc /path/to/project/.cursor/rules/ diff --git a/hermes/shazhou-family-onboard/references/11-skills-sync.md b/hermes/shazhou-family-onboard/references/11-skills-sync.md new file mode 100644 index 0000000..79dcedf --- /dev/null +++ b/hermes/shazhou-family-onboard/references/11-skills-sync.md @@ -0,0 +1,46 @@ +# 11. Skills 同步 + +## 检查 + +确认 skills repo 已克隆： + + ls ~/skills/sync.sh + +确认 skills 已同步到 Hermes： + + ls ~/.hermes/skills/ + +✅ 达标：`~/skills` 存在，`~/.hermes/skills/` 下有从 repo 同步过来的 skill 目录 + +## 安装 + +### 克隆 skills repo + + cd ~ + git clone https://git.shazhou.work/shazhou/skills.git + +### 同步到 Hermes + + cd ~/skills + bash sync.sh + +### 目录结构 + +``` +~/skills/ +├── hermes/ # Hermes Agent skills +├── cursor/ # Cursor rules +├── sync.sh # 同步脚本：hermes skills → ~/.hermes/skills/ +└── README.md +``` + +## 验证 + + ls ~/.hermes/skills/ + # 应该能看到从 repo 同步过来的 skill 目录 + +## 日常使用 + +有新 skill 更新时： + + cd ~/skills && git pull && bash sync.sh diff --git a/hermes/shazhou-family-onboard/scripts/self-check.sh b/hermes/shazhou-family-onboard/scripts/self-check.sh index 726cd1e..07f355c 100644 --- a/hermes/shazhou-family-onboard/scripts/self-check.sh +++ b/hermes/shazhou-family-onboard/scripts/self-check.sh @@ -68,9 +68,13 @@ check "config.yaml 存在" "test -f ~/.hermes/config.yaml" check "hermes-har 已安装" "command -v hermes-har" check "auxiliary models 已配置" "grep -q 'auxiliary' ~/.hermes/config.yaml 2>/dev/null" -echo "10. Skills" +echo "10. Cursor Agent" +check "cursor-agent 已安装" "command -v cursor-agent" +check "CURSOR_API_KEY 可用" "test -n \"\$CURSOR_API_KEY\"" + +echo "11. Skills" check "skills repo 已克隆" "test -d ~/skills/.git" -check "skills 已同步" "test -d ~/.hermes/skills/openclaw-imports" +check "skills 已同步" "ls ~/.hermes/skills/ | grep -qv '^$'" echo ""