query-database
SKILL.md
查询 mercury-server 的 SQLite 数据库,获取真实的运行数据来回答用户问题。当用户的问题涉及数据库查询时,直接执行查询,不需要先问用户是否需要帮忙查。
使用步骤
- 了解表结构:先用 Read 工具读取
$PROJECT_DIR/docs/db-schema.md,了解可用的表和字段 - 定位数据库:通过 Bash 执行
echo $SQLITE_DB_PATH获取路径 - 执行查询:使用 sqlite3 命令行工具
安全规则
- 必须加 -readonly 参数,防止误操作
- 仅允许 SELECT 查询,禁止任何写操作(INSERT/UPDATE/DELETE/DROP 等)
- 必须加 LIMIT,避免大结果集(建议 LIMIT 50)
查询命令格式
sqlite3 -readonly -header -column "$SQLITE_DB_PATH" "SELECT ... LIMIT 50"
注意事项
- 时间字段为 UTC+8 格式(
YYYY-MM-DD HH:MM:SS) messages字段是 JSON 数组,内容可能很长,查询时建议只取length(messages)或不 SELECT 该字段- 使用中文回复查询结果的含义,不要直接输出原始 JSON