groove-admin-install

groove-admin-install

结果

所有 groove 后端均已按依赖顺序安装，配套技能和 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 路径分别运行 test -f；若有任何文件缺失，停止并报告安装未完成（不得宣称成功）。
   • 分别报告每项状态：已安装 / 已存在 / 失败
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（不跟随符号链接）——对现有目录符号链接使用 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
     
     
     

   • 如果 .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
     
     
     

   • 报告钩子状态：已创建 / 已存在
7. 应用 git 策略 — 根据 .groove/index.md 中的 git.* 子键写入 .groove/.gitignore（规则参见 /groove-admin-config）

约束

• 运行前，读取 .groove/index.md 中的 tasks.backend 和 git.* 配置
• 如果 .groove/index.md 不存在，先运行 /groove-admin-config（步骤 1）来创建它
• 必须遵循后端的依赖顺序：任务 → 记忆 → 配套技能
• 每个步骤都要报告已安装／已存在／失败
• 更新 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