这个项目能做什么

Project Calavera 是一款开源 CLI 工具，用于为 Web 项目搭建 Linter、Formatter、TypeScript 配置、AI 代理技能、Hooks 及其他常见项目基础设施。它既可独立用于原生 JavaScript、TypeScript 和库项目，也可配合 Vite+ 等框架脚手架工具使用。 核心功能包括管理 Linting 和 Formatting 工具链（可选择使用 Oxlint/Oxfmt/Stylelint 的 Modern 配置，或使用 ESLint/Prettier/Stylelint 的 Classic 配置），生成检查 `.js`、`.jsx`、`.ts` 和 `.tsx` 文件的 TypeScript 配置，以及设置带有 CSS 质量插件的 Stylelint。它还支持在 `.agents/` 目录下安装 AI 技能和代理，管理 `package.json` 脚本，并生成可重复的 `calavera.config.json` 配方文件。 该工具集成了多种包管理器——npm、pnpm、Yarn 和 Bun，并为每种管理器记录了命令变体。它支持 Claude Code、Codex、Cursor 和 OpenCode 的项目级 MCP 服务器配置，暴露 `inspect_project`、`list_profiles`、`compose_recipe`、`dry_run_apply` 和 `apply_recipe` 等工具，以实现代理原生工作流。 Calavera 包含一个集成目录，涵盖 React 最佳实践（含 React Doctor 诊断）、导入/模块规则、Promise 安全性、Node 包规则、测试规则、通过 Knip 进行的未使用文件/依赖分析、HTML 验证、CSS 基线和属性验证，以及通过 Varlock 进行的环境变量模式验证。可选的 GitHub 仓库控制功能可生成策略文件、Dependabot 配置，以及用于漂移检查的可移植 Node.js 管理脚本。 该 CLI 提供了用于配方组合（`init`）、应用配方并预览干运行（`apply --dry-run`）、检查当前项目工具（`doctor`）、更新托管工具（`update`）以及移除陈旧文件（`clean`）的命令。它同时支持交互式和脚本化模式，并提供用于基于浏览器的配方组合的 Web UI。 MCP 服务器注册仅限于项目级；Calavera 绝不会写入全局或用户级的 MCP 配置。该工具尊重现有的项目包管理器以避免预检失败，特别是在 Bun 管理的项目中，因为 npm 11 会强制执行 `devEngines.packageManager` 检查。