SuperAPI AI 工具集

calavera

编程与开发

查看项目

更新于 10-16 08:45

技能介绍

Calavera 是一个面向项目工具链配置的技能,用于组合并应用 Calavera 管理的 JavaScript、TypeScript、CSS 与 AI 工具配置,适用于已有项目或新脚手架项目。它本身不是子代理,而是指导当前代理如何操作。

用途与能力:通过 MCP 工具(list_profiles、list_integrations、list_ai_artifacts、compose_recipe、dry_run_apply、apply_recipe)列出可选配置、集成与 AI 产物,组合并校验配方,先预览再应用更改。

使用方式:先确认 MCP 工具是否可用;检查 package.json、calavera.config.json、.editorconfig、eslint.config.js、oxlint.json、.prettierrc.json、.stylelintrc.json、tsconfig.json 等,发现潜在冲突时暂停并列出硬性阻断或迁移决策,用 dry_run_apply 展示影响。用户确认后再用 compose_recipe 组合,配合 validate_recipe、explain_recipe 校验说明,展示 dry-run 结果,仅在用户明确批准后调用 apply_recipe。

手动注册 MCP 时,npm 项目用 npx --package create-project-calavera@<version> create-project-calavera-mcp,pnpm 用 pnpm dlx --package create-project-calavera@<version> create-project-calavera-mcp,Yarn 用 yarn dlx --package create-project-calavera@<version> create-project-calavera-mcp,Bun 用 bunx --package create-project-calavera@<version> create-project-calavera-mcp。注册属于持久化代码执行变更,需用户明确批准。若无法注册,可用托管 Web UI:https://calavera.schalkneethling.com。

限制与注意事项:MCP 可用时不要手写 calavera.config.json;dry_run_apply 列出的文件(含 .calavera/run-if-files.mjs)属 Calavera 管理,不应手动编辑。若 apply_recipe 期间 MCP 传输关闭或报 -32000,应视为结果未知而非失败,先检查 calavera.config.json、.calavera/state.json、生成文件与包元数据再重试。