关于 platform-database
platform-database 是面向数据库相关任务的技能,指导 Agent 判断适用范围、应用规则索引中的模式并检查输出。示例强调数据库架构与迁移评审,不适用于无关的界面任务。
主要功能
- 01识别数据库任务触发条件
- 02应用规则索引中的指导
- 03按工作流执行并验证结果
适用场景
- 01评审数据库架构和迁移计划
- 02排查技能未触发或指导冲突
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ ravnhq/ ai-toolkit --skill platform-database安装后在 Claude Code 中输入/platform-database确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
rules/_sections.mdindex-concurrent-creation.mdindex-covering-queries.mdindex-foreign-keys.mdmigration-add-columns-safely.mdmigration-forward-only.mdmigration-one-change.mdmigration-review-generated-sql.mdmigration-separate-data-schema.mdquery-avoid-functions-on-indexed.mdquery-avoid-leading-wildcards.mdquery-filter-early.mdquery-n-plus-one.mdquery-prefer-exists-over-in.mdquery-select-columns.mdquery-use-explain.mdschema-timestamps.mdschema-use-appropriate-types.mdtransaction-keep-short.mdtransaction-wrap-related-mutations.md详细介绍
原则
- 除非确实需要去重,否则优先使用 UNION ALL,而非 UNION
规则
详细模式请参阅规则索引。
示例
正向触发
用户:“请审查此架构和迁移计划,确保实现零停机发布。”
预期行为:使用 platform-database 指南,遵循其工作流,并给出可执行的结果。
不触发
用户:“为此模态框实现 ARIA 标签和焦点环。”
预期行为:不要优先使用 platform-database;选择更相关的技能,或不使用技能直接处理。
故障排查
技能未触发
- 错误:未按预期选择该技能。
- 原因:请求措辞与描述中的触发条件不够明确地匹配。
- 解决方案:使用描述中的明确领域/任务关键词重新表述,然后重试。
指南与其他技能冲突
- 错误:同一任务中的多项技能指令相互冲突。
- 原因:已加载技能的适用范围重叠。
- 解决方案:说明当前步骤以哪项技能为准,并优先应用其工作流。
输出过于笼统
- 错误:结果缺少具体、可执行的细节。
- 原因:任务输入缺少上下文、约束条件或目标格式。
- 解决方案:添加具体约束(环境、范围、格式、成功标准)并重新运行。
工作流
- 确认请求是否明确符合
platform-database的适用范围和触发条件。 - 应用技能规则和引用的指南,生成具体结果。
- 根据约束验证输出质量;如仍有不足,使用明确假设再完善一次。
评论
支持 Markdown