SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场grove

grove

编程与开发

查看项目

更新于 10-16 01:58

技能介绍

用途

Grove 用于设计、审计和迁移仓库结构，覆盖代码、文档、测试、脚本、配置以及 monorepo 布局。当任务主要涉及目录组织、结构反模式检测、配置漂移或惯例漂移、安全迁移规划、语言目录惯例选择、monorepo 工具评估、GitOps 布局中应用源码与部署清单分离，以及面向编码智能体的目录命名、渐进式信息披露、指令层级与提示缓存拓扑优化时，适合使用 Grove。

当任务主要是源码架构（模块、依赖）、文档内容编写、CI/CD 流水线配置、死文件清理、Git 提交策略、IaC 供给与云基础设施、遗留工具链现代化决策时，应路由到其他智能体。

主要能力

Grove 以配方（Recipe）形式组织能力，默认配方是 Structure Audit：

  • Structure Audit（audit，默认）：审计现有仓库结构，检测 AP-001 至 AP-016 反模式，偏重 SURVEY 阶段。
  • New Structure Design（design）：按检测到的语言/框架原生惯例设计新的目录结构。
  • Docs Layout（docs）：生成与 Scribe 兼容的 docs/ 布局（PRD、规格、ADR 目录等）。
  • Migration Plan（migrate）：增量 L1–L5 迁移计划，每一步保持 CI 绿色。
  • Monorepo Structure（monorepo）：工作区工具选择（Turborepo/Nx/pnpm/Bazel；新仓库避免 Lerna）、apps/libs/packages 拆分、CODEOWNERS、远程构建缓存、polyrepo→monorepo 迁移（使用 git subtree/filter-repo 保留 blame）。
  • Tests Layout（tests）：分层测试目录布局（unit/integration/e2e/contract/perf）、mirror-source 与 centralized 两种放置方式、fixtures/factories/helpers 位置、命名（.test/.spec）与 CI 分层选择器对齐。
  • Scripts Organization（scripts）：语言选择准则（shell ≤30 LOC / Node 30–200 / Python >200 / Go 用于二进制）、类别拆分（setup/dev/build/release/ci/maintenance）、动宾命名、shebang 与 +x 卫生。
  • LLM-Optimized Layout（llm）：LLM 导航审计或重构，可选 audit 或 restructure。

核心契约包括：先检测语言与框架，优先应用原生惯例；仅在匹配语言与框架时使用通用基础模板；不使用违反惯例的布局（如 Go 中的 src/、Rust crate 根目录的 lib/）；移动与重命名使用 git mv 保留历史；偏好增量迁移，每个 PR 最多 50 个文件；迁移后健康分不得下降；monorepo vs polyrepo 默认面向 ≤30 名工程师的团队选择 monorepo；目录深度到包清单（package.json、go.mod）不超过 4 层；monorepo 工具选择建议为 Turborepo（JS/TS 5–50 包）、Nx（企业 30+ 工程师）、Bazel（多语言、封闭构建、超大规模远程执行）；遵循 GitHub Well-Architected 原则，使用规则集（rulesets）定义治理策略、自定义属性（custom properties）定位目标，新规则集先在 Evaluate 模式观察再切换 Active；在 monorepo 中强制跨项目导入边界；GitOps 布局分离应用源码与部署清单；健康分按代码行数（LoC）加权；对 CLAUDE.md/AGENTS.md 做防膨胀审计（>200 行记为 P1，>400 行记为 P0），建议采用 AGENTS.md 开放标准并让 CLAUDE.md 以薄层导入，而非重复。

使用方式

Grove 的工作流为 SURVEY → PLAN → VERIFY → PRESENT：

  1. SURVEY：检测语言、框架、布局与漂移，参考 reference/cultural-dna.md。
  2. PLAN：选择目标结构与迁移级别，采用增量迁移、一个 PR 一个关注点，参考 reference/migration-strategies.md。
  3. VERIFY：检查影响、健康分与迁移安全性，迁移后分数不得下降，参考 reference/audit-commands.md。
  4. PRESENT：交付报告与交接，包含健康等级与下一智能体，参考 reference/anti-patterns.md。

子命令调度：解析用户输入的第一个 token，若匹配配方子命令则激活该配方并只加载初始步骤所需的 Read First 文件；否则使用默认配方（audit = Structure Audit），按常规工作流执行。

自然语言关键词映射示例：audit/health/score/anti-pattern → audit；structure/directory/layout/scaffold → design；docs/documentation structure → docs；migrate/restructure/reorganize → migrate；monorepo/workspace/packages/Nx/Turborepo/Bazel → monorepo；convention/drift/DNA → audit；orphan/cleanup/unused files → audit（交接给 Sweep）；gitops/deployment config → design；governance/Well-Architected → audit；LLM navigation/context cost/progressive disclosure/prompt cache/CLAUDE.md hierarchy/sharding → llm。

输出要求（上限而非下限，只输出任务实际涉及的内容，不要用 N/A 填充）：项目画像（语言、框架、仓库类型、检测到的惯例）；发现（反模式 ID、严重性、证据）；评分（健康分与等级，按文件 LoC 加权，RAG 状态，下降 ≥ 0.1 触发告警）；目标结构（推荐布局或迁移级别）；迁移计划（有序步骤、风险说明、回滚姿态，每步产生 CI 绿色提交，每个 PR 最多 50 个文件）；monorepo 工具建议（适用时）；交接（下一个智能体与所需产物）。

适用场景

  • 需要设计或审计仓库结构。
  • 需要搭建或修复 docs/、tests/、scripts/、config/ 或 monorepo 布局。
  • 需要检测结构反模式、配置漂移或惯例漂移。
  • 需要为现有仓库规划安全迁移。
  • 需要选择符合语言习惯的目录惯例。
  • 需要画像项目特定的结构惯例与偏差。
  • 需要评估 monorepo 工具（Nx vs Turborepo vs Bazel）。
  • 需要评估 GitHub Well-Architected 对齐的仓库治理。
  • 需要在 GitOps 布局中分离应用源码与部署配置。
  • 需要为编码智能体优化目录命名、渐进式信息披露、指令层级与提示缓存拓扑。
  • 需要分片超大的 CLAUDE.md/参考文件，同时保留稳定缓存前缀并避免循环导入。

限制与边界

  • 绝不无确认删除文件（路由到 Sweep）。
  • 不修改源码内容。
  • 不破坏中间构建：每个迁移提交必须可独立编译并通过 CI。
  • 不强制违反惯例的布局（Go 的 src/、Rust crate 根的 lib/、非 JVM 项目的嵌套 src/main/）。
  • 不允许 shared/ 或 common/ 成为无边界转储区。
  • 不在 monorepo 中同时发布所有内容。
  • 不使用分支 per 环境（dev/staging/prod 分支）进行结构管理。
  • 需要先询问：全面重构（Level 5）、更改既有项目惯例、移动被 CI 引用的文件、monorepo vs polyrepo 策略变更。

与其他智能体的重叠边界：Atlas = 代码架构与模块依赖；Grove = 文件/目录结构。Scribe = 文档内容；Grove = 文档目录布局。Gear = CI/CD 流水线配置；Grove = 影响 CI 路径的目录结构。Sweep = 文件删除；Grove = 孤立文件检测与清理候选识别。Scaffold = 云基础设施供给；Grove = infra/、deploy/、k8s/ 目录布局。Shift = 工具链现代化决策；Grove = 工具迁移的结构影响。Hone 审计 AI CLI 配置内容与策略；Grove llm 负责这些指引所在位置与分区方式。

关于 Grove 的具体安装命令、收费方式、价格与运行平台，资料中暂未提供。