mcpField
7
704-technologies-sql

704-technologies-sql

github.com/jabrena数据与数据库456209 次安装1 天前更新
代码仓库

关于 704-technologies-sql

面向 Java 应用团队的 SQL 技能,涵盖关系型数据库中的可维护性、安全性与性能。内容聚焦数据库设计和查询,并强调方言及运维约束。

主要功能

  1. 01关系型模式设计
  2. 02编写清晰高效的查询
  3. 03索引策略
  4. 04SQL 安全与事务
  5. 05迁移、测试和监控指导

适用场景

  1. 01审查模式和迁移
  2. 02提升查询可读性或性能
  3. 03设计表和索引
  4. 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 最佳实践

工作流

  1. 阅读参考资料并评估数据库环境

阅读 references/704-technologies-sql.md,并在提出变更之前检查当前架构、迁移、SQL 查询、测试和数据库配置。

  1. 确定方言和运维约束

确认目标数据库引擎、迁移工具、数据量预期、可用性要求和影响 SQL 设计的兼容性约束。

  1. 实施符合 SQL 规范的变更

遵循参考资料中的模式和项目约定,实现或重构 SQL 工件;除非用户明确要求,否则不涉及 Java 框架集成。

  1. 运行验证并报告结果

执行适当的构建、迁移、SQL 验证和测试检查;总结变更内容、验证结果以及任何尚存的数据库风险。

参考资料

详细指导、示例和约束请参阅 references/704-technologies-sql.md。

评论

支持 Markdown