groove-admin-install

用途

groove-admin-install 是 groove 技能体系的仓库级安装初始化技能，目标是在一个仓库里一次性完成 groove 的安装与引导配置，让仓库进入可用状态。它的预期结果包括：所有 groove 后端按依赖顺序安装完成；配套技能（companion skills）与 groove 技能符号链接就位（首次安装若缺少这些步骤即视为未完成）；AGENTS.md 中包含会话引导；仓库可正常使用。

验收标准

• 任务后端与记忆后端已安装（若某步骤失败需清晰报告）。
• 配套技能已安装（find-skills、agent-browser、pdf-to-markdown）——为必需项；需在第 4 步后逐一验证对应 SKILL.md 是否存在。
• 平台符号链接就位——.claude/skills/groove* 与 .cursor/skills/groove* 指向 .agents/skills/groove*——每次安装运行都必须完成。
• 用户能看到安装内容摘要，其中包含配套技能与符号链接的 ✓/✗ 状态。

执行步骤

按顺序运行：

1. 若 .groove/index.md 不存在，运行 /groove-admin-config --defaults，以全部默认值创建它（无交互提示）。
2. 运行 /groove-utilities-task-install —— 安装配置好的任务后端（例如 beans）。
3. 运行 /groove-utilities-memory-install —— 创建记忆目录。
4. 安装配套技能（强制，不可跳过）：在首次安装及之后每次运行时，确保以下技能存在于 .agents/skills/ 下。若 SKILL.md 缺失，运行对应的 npx skills add 命令；遇到瞬时失败可重试一次，仍失败则报告失败（三项全部成功前安装不算完成）。
   • find-skills（下载）：test -f .agents/skills/find-skills/SKILL.md 或 npx skills add https://github.com/vercel-labs/skills --skill find-skills
   • agent-browser（下载）：test -f .agents/skills/agent-browser/SKILL.md 或 npx skills add https://github.com/vercel-labs/agent-browser --skill agent-browser
   • pdf-to-markdown（内置）：test -f .agents/skills/pdf-to-markdown/SKILL.md 或 npx skills add andreadellacorte/groove --skill pdf-to-markdown 随后验证三个 SKILL.md 路径是否存在——若任一缺失，停止并报告安装未完成（不得声称成功）。将每项报告为 installed / already-present / failed。
5. 通过符号链接同步平台技能目录（强制，不可跳过）：groove 技能必须链接到各编辑器的技能树中，使 groove-* 命令可被解析。
   • 若父目录缺失则创建：mkdir -p .claude/skills .cursor/skills（Claude Code 期望 .claude/skills/；Cursor 期望 .cursor/skills/）。
   • 对 .agents/skills/ 下每个以 groove 开头的目录：创建 .claude/skills/<name> 作为指向 ../../.agents/skills/<name> 的符号链接；创建 .cursor/skills/<name> 作为指向 ../../.agents/skills/<name> 的符号链接。
   • 运行：mkdir -p .claude/skills .cursor/skills && for skill in .agents/skills/groove*; do name=$(basename "$skill"); ln -sfn "../../.agents/skills/$name" ".claude/skills/$name"; ln -sfn "../../.agents/skills/$name" ".cursor/skills/$name"; done
   • 注意：使用 ln -sfn（no-dereference）——对已存在的目录符号链接使用 ln -sf 会跟随该链接并在目标目录内创建嵌套符号链接。
   • 验证：.agents/skills/ 下至少存在一个 groove-* 名称，且 .claude/skills/ 与 .cursor/skills/ 下存在对应符号链接。
   • 报告："✓ platform symlinks updated (.claude/skills/, .cursor/skills/)" 或报告失败。
6. 搭建钩子与缓存目录：
   • 若 .groove/hooks/ 不存在则创建。
   • 若 .groove/.cache/ 不存在则创建（带一个 .gitkeep）。
   • 若 .groove/hooks/start.md 不存在，创建它，内容为：

# Hook: Session Start

Runs automatically at the end of `/groove-daily-start`.
Add items to `## Actions` to automate session-start tasks.

## Actions

<!-- Add actions here, one per line. Examples:
- Run `git fetch --all` to refresh remote refs
- Print "Good morning — groove is ready"
-->

• 若 .groove/hooks/end.md 不存在，创建它，内容为：

# Hook: Session End

Runs automatically at the end of `/groove-daily-end`.
Add items to `## Actions` to automate session-end tasks.

## Actions

<!-- Add actions here, one per line. Examples:
- Run `git push` to push today's commits
- Print "Session closed — see you tomorrow"
-->

• 报告钩子：created / already-present。

1. 应用 git 策略——根据 .groove/index.md 中的 git.* 子键写入 .groove/.gitignore（规则见 /groove-admin-config）。

约束

• 运行前读取 .groove/index.md 中的 tasks.backend 与 git.* 配置。
• 若 .groove/index.md 不存在，先运行 /groove-admin-config（第 1 步）创建它。
• 必须遵守后端依赖顺序：task → memory → companions。
• 每个步骤报告 installed / already-present / failed。
• AGENTS.md 更新为按分区的增量更新——保留所有其他内容。
• 若任务或记忆安装失败，清晰报告并继续——用户仍可能需要配套技能与符号链接。
• 第 4–5 步（配套技能 + 符号链接）是安装成功所必需的：两步都成功前不得报告"安装完成"。这是有意设计：首次引导必须让技能在 Cursor 与 Claude Code 中可被发现。
• 配套技能（find-skills、agent-browser、pdf-to-markdown）在此硬编码，不从任何配置文件读取。
• 报告最终摘要（包含平台符号链接一行）：

✓ task backend (beans)
✓ memory backend — memory dirs ready
✓ companion: find-skills
✓ companion: agent-browser
✓ companion: pdf-to-markdown
✓ platform symlinks (.claude/skills/, .cursor/skills/)
✓ hooks: .groove/hooks/ ready

适用场景

适用于已使用 groove 技能体系的仓库，在首次接入或需要重新安装时运行，每个仓库运行一次。运行后仓库应具备可用的任务与记忆后端、配套技能、平台符号链接、钩子目录与 git 忽略策略。

限制

配套技能列表为硬编码，未在配置文件中定义；任务的记忆后端安装失败时不会阻断后续步骤；首次安装未完成配套技能与符号链接两步时不视为安装成功；关于收费、价格、平台支持范围等其他信息，资料暂未提供。