关于 bootstrap-check
bootstrap-check 是用于只读检查 Symfony 应用配置的清单式技能,适合陌生或刚克隆的项目。它检查环境变量、依赖、启动与容器编译、数据库映射,以及可选的 API Platform 或 Messenger 组件。
主要功能
- 01检查必需的环境变量
- 02验证依赖安装和应用启动
- 03编译容器并列出服务与路由
- 04检查数据库连接和映射结构
- 05检查可选的 API Platform 与 Messenger
适用场景
- 01检查刚克隆的 Symfony 项目
- 02排查应用启动或容器错误
- 03修改前核对配置
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ dev-toolings/ superpowers-symfony --skill bootstrap-check安装后在 Claude Code 中输入/bootstrap-check确认已加载。
附带文件reference.md
详细介绍
引导检查(Symfony)
适用场景
- 开始处理不熟悉或刚克隆的 Symfony 项目时。
- 应用无法启动、容器无法编译或路由缺失时。
- 修改前检查
.env、config/packages/*、Doctrine、API Platform 或 Messenger 配置。
默认工作流
- 确认
.env存在,并定义了APP_SECRET、DATABASE_URL以及各个 Bundle 所需的变量。 - 确认已安装
vendor/,且bin/console about可以运行。 - 编译容器(
cache:clear),并列出服务和路由。 - 检查数据库连接,以及数据库架构是否与映射一致。
- 检查已启用的可选组件:API Platform 资源、Messenger 传输。
安全约束
- 仅进行读取:报告缺少的内容,检查时不要重写配置。
- 切勿打印
.env或保险库中的机密值。 - 处理缓存权限问题时,优先使用 ACL 或正确的用户,而不是
chmod 777。 - 使用 Doctrine 检查时应连接开发数据库,绝不要连接生产数据库。
渐进式披露
- 使用此文件了解执行原则和风险控制。
- 需要深入了解实现细节时,打开参考资料。
输出约定
- 检查清单中的每一项都标记为通过或失败。
- 列出每项失败对应的确切修复方法(命令或需要修改的文件)。
- 说明未检查的内容及原因。
参考资料
reference.md
评论
支持 Markdown