mcpField
P
platform-database

platform-database

github.com/ravnhq数据与数据库1640 次安装21 周前更新
代码仓库

关于 platform-database

platform-database 是面向数据库相关任务的技能,指导 Agent 判断适用范围、应用规则索引中的模式并检查输出。示例强调数据库架构与迁移评审,不适用于无关的界面任务。

主要功能

  1. 01识别数据库任务触发条件
  2. 02应用规则索引中的指导
  3. 03按工作流执行并验证结果

适用场景

  1. 01评审数据库架构和迁移计划
  2. 02排查技能未触发或指导冲突

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ravnhq/ai-toolkit --skill platform-database

安装后在 Claude Code 中输入/platform-database确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

rules/
_sections.md
index-concurrent-creation.md
index-covering-queries.md
index-foreign-keys.md
migration-add-columns-safely.md
migration-forward-only.md
migration-one-change.md
migration-review-generated-sql.md
migration-separate-data-schema.md
query-avoid-functions-on-indexed.md
query-avoid-leading-wildcards.md
query-filter-early.md
query-n-plus-one.md
query-prefer-exists-over-in.md
query-select-columns.md
query-use-explain.md
schema-timestamps.md
schema-use-appropriate-types.md
transaction-keep-short.md
transaction-wrap-related-mutations.md

详细介绍

原则

  • 除非确实需要去重,否则优先使用 UNION ALL,而非 UNION

规则

详细模式请参阅规则索引。

示例

正向触发

用户:“请审查此架构和迁移计划,确保实现零停机发布。”

预期行为:使用 platform-database 指南,遵循其工作流,并给出可执行的结果。

不触发

用户:“为此模态框实现 ARIA 标签和焦点环。”

预期行为:不要优先使用 platform-database;选择更相关的技能,或不使用技能直接处理。

故障排查

技能未触发
  • 错误:未按预期选择该技能。
  • 原因:请求措辞与描述中的触发条件不够明确地匹配。
  • 解决方案:使用描述中的明确领域/任务关键词重新表述,然后重试。
指南与其他技能冲突
  • 错误:同一任务中的多项技能指令相互冲突。
  • 原因:已加载技能的适用范围重叠。
  • 解决方案:说明当前步骤以哪项技能为准,并优先应用其工作流。
输出过于笼统
  • 错误:结果缺少具体、可执行的细节。
  • 原因:任务输入缺少上下文、约束条件或目标格式。
  • 解决方案:添加具体约束(环境、范围、格式、成功标准)并重新运行。

工作流

  1. 确认请求是否明确符合 platform-database 的适用范围和触发条件。
  2. 应用技能规则和引用的指南,生成具体结果。
  3. 根据约束验证输出质量;如仍有不足,使用明确假设再完善一次。

评论

支持 Markdown