关于 704-technologies-sql
面向 Java 应用团队的 SQL 技能,涵盖关系型数据库中的可维护性、安全性与性能。内容聚焦数据库设计和查询,并强调方言及运维约束。
主要功能
- 01关系型模式设计
- 02编写清晰高效的查询
- 03索引策略
- 04SQL 安全与事务
- 05迁移、测试和监控指导
适用场景
- 01审查模式和迁移
- 02提升查询可读性或性能
- 03设计表和索引
- 04评估数据库安全与运维
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ jabrena/ plinth --skill 704-technologies-sql安装后在 Claude Code 中输入/704-technologies-sql确认已加载。
附带文件references/704-technologies-sql.md
详细介绍
SQL 最佳实践
帮助团队为 Java 应用编写可维护、安全且高性能的 SQL,适用于各种关系型数据库引擎。
此技能涵盖哪些内容?
- 表、列、索引、约束、视图、触发器和例程的命名约定
- 关系型表设计:键、约束、时间戳、软删除、规范化和适配方言的数据类型
- 查询编写:清晰的格式、显式列清单、连接、CTE、绑定参数和执行计划审查
- 索引策略:外键、筛选/排序路径、复合索引、索引过多的风险和索引生命周期
- 生产数据库工作中的安全、事务、迁移、测试和监控实践
范围: 与框架无关的 SQL 质量。对于 Java 数据访问 API,请参考相应的 JDBC、Spring Data JDBC、Panache 或 Micronaut Data 技能。
约束
除非用户明确要求集成 Java 框架,否则请将建议限定在 SQL 和数据库设计层面。编辑此仓库的 XML 源文件后,请重新生成技能并验证构建。
- MANDATORY:在同一变更集中提出 Java 或 Maven 变更之前,运行
./mvnw compile或mvn compile - SQL INJECTION:切勿将不可信输入拼接到 SQL 字符串中;请通过应用的数据访问 API 使用绑定参数
- DIALECTS:使用 PostgreSQL、MySQL、Oracle、SQL Server、H2 或其他引擎时,说明数据库特有的语法和可移植性方面的取舍
- FRAMEWORK:Spring JDBC 请参阅
@311-frameworks-spring-jdbc,Quarkus JDBC 请参阅@411-frameworks-quarkus-jdbc,Micronaut JDBC 请参阅@511-frameworks-micronaut-jdbc;框架特定的迁移请参阅对应的 Flyway 技能 - VERIFY:在推广变更之前,运行
./mvnw clean verify或mvn clean verify - EDGE CASE:如果缺少目标数据库方言、迁移工具或生产约束,且这会影响建议,请在编辑 SQL 之前提出澄清问题
- EDGE CASE:如果请求的变更与数据安全、向后兼容性或零停机部署约束冲突,请说明取舍并征求确认
何时使用此技能
- 审查 SQL 架构或迁移
- 提升 SQL 查询的性能和可读性
- 设计关系型表和索引
- 审查数据库事务、安全或监控实践
- 在数据库 DDL 或 DML 中应用 SQL 最佳实践
工作流
- 阅读参考资料并评估数据库环境
阅读 references/704-technologies-sql.md,并在提出变更之前检查当前架构、迁移、SQL 查询、测试和数据库配置。
- 确定方言和运维约束
确认目标数据库引擎、迁移工具、数据量预期、可用性要求和影响 SQL 设计的兼容性约束。
- 实施符合 SQL 规范的变更
遵循参考资料中的模式和项目约定,实现或重构 SQL 工件;除非用户明确要求,否则不涉及 Java 框架集成。
- 运行验证并报告结果
执行适当的构建、迁移、SQL 验证和测试检查;总结变更内容、验证结果以及任何尚存的数据库风险。
参考资料
详细指导、示例和约束请参阅 references/704-technologies-sql.md。
评论
支持 Markdown