本文へ移動
cccskills
無料GitHub で公開日本語紹介

mysql reporter

MySQLのテーブルを確認して読み取り専用のSQLで必要な数値を集計し、売上や利用状況などを指標と結論付きのMarkdown表で報告します。

原文原文の説明を見る

生成 MySQL 查询报表。当用户需要查询 MySQL 数据库并以报表形式展示结果时使用此技能,包括:统计销售数据、分析用户行为、生成业务报表、查询业务指标等。

xerrors/Yuxiスター 7,543(GitHub 7,543 + cccskills 0)
連携ツールMySQL

実行スコア 未検証

インストール方法を見る

こんなときに便利

  • 月次売上を集計したいとき
  • ユーザー行動の傾向を見たいとき
  • 業務データの報告表を作りたいとき
  • 事業指標を確認したいとき

日本語での紹介

できること

MySQLデータベースのテーブルを確認し、依頼に合う読み取り専用のSQLを組み立てて集計します。結果はMarkdownの表にまとめ、主要な指標や変化、そこから分かる結論を説明します。売上の集計、ユーザー行動の分析、業務レポートや指標の確認などに使えます。SQLは全件走査を避けて効率よく実行し、報告では生のSQL文を出さず、レポートに必要な結果を伝えます。

こんなときに便利

売上や利用状況を数値で確認したいとき、業務データから定例レポートを作りたいとき、データベースの指標をもとに状況を把握したいときに向いています。

使い方の例

  • 「今月の売上を集計して、商品別の表にしてください」
  • 「ユーザーの利用状況を分析し、主な傾向をまとめてください」

注意点

実行にはAgentサンドボックスの環境変数 MYSQL_HOST、MYSQL_USER、MYSQL_PASSWORD、MYSQL_DATABASE が必要です。設定が不足している場合は、不足した変数名を伝えて設定を依頼します。

この紹介文は、公開されている SKILL.md をもとに AI(OpenAI Codex)が作成しました。正確な仕様は下の原文を確認してください。

含まれるファイル(5)

  • SKILL.md2.2 KB
  • scripts/_mysql_common.py1.8 KB
  • scripts/describe_table.py3.7 KB
  • scripts/list_tables.py1.3 KB
  • scripts/query.py7.9 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

MySQL 报表技能

根据用户的指令,通过终端脚本访问 MySQL 数据库,根据查询结果构建报表。

操作流程

  1. 理解用户的指令,明确报表的需求和目标
  2. 通过 terminal 进入技能目录:cd /home/user/skills/mysql-reporter
  3. 使用 uv run scripts/list_tables.py 查看可用表;如果脚本提示缺少 MySQL 配置,按“环境变量缺失处理”回复用户
  4. 必要时用 uv run scripts/describe_table.py --table 表名 查看表结构
  5. 生成正确且高效的只读 SQL,通过 uv run scripts/query.py --sql "SQL语句" --timeout 60 执行查询并获取结果
  6. 使用 Markdown 表格呈现查询结果,说明关键指标、变化与结论

环境变量缺失处理

脚本只读取 Agent 沙盒中的环境变量,不读取后端 .env 或 Docker Compose 变量。必填变量包括:

  • MYSQL_HOST
  • MYSQL_USER
  • MYSQL_PASSWORD
  • MYSQL_DATABASE

可选变量包括:

  • MYSQL_PORT:默认 3306
  • MYSQL_DATABASE_DESCRIPTION:数据库业务说明,用于辅助理解表和指标含义

如果执行脚本时出现 MySQL configuration missing required key,不要继续猜测连接信息或编造报表。应明确告诉用户:需要在个人设置中的「沙盒环境变量」里配置缺失的 MYSQL_* 变量;保存后仅对新建沙盒生效,需要重新发起任务或新建会话后再执行。

关键约束

  • 生成的 SQL 查询必须正确且高效,避免全表扫描
  • MySQL 操作必须通过本技能 scripts/ 下的 CLI 脚本执行,不要调用平台内置 MySQL tools
  • 不要在报表或错误说明中输出 MYSQL_PASSWORD 等敏感环境变量的值,只能说明缺少哪些变量名
  • 只返回报表相关的结论,不要返回原始 SQL 查询语句

允许的工具

  • terminal:执行 scripts/list_tables.py、scripts/describe_table.py、scripts/query.py
  • 网络检索工具:必要时补充背景信息

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

chat-widgets

無料概要あり

画像や数値を会話内でカードやグラフとして見やすく示し、必要な条件は短いフォームで尋ねるなど、目的に合う表示形式で回答を組み立てます。

  • 複数の画像を会話で見せたいとき
  • カテゴリ別の数値を比べたいとき
  • 時系列の変化を図で示したいとき
xerrors/Yuxi7,5432026年10月29日 更新

deep-research

無料概要あり

調査範囲を定めて問いを分解し、複数の情報源を調べて重要な主張を検証したうえで、出典を追える構成的なレポートにまとめます。

  • 研究テーマを複数資料から調べたいとき
  • 業界や競合を比較したいとき
  • 技術選定の根拠を整理したいとき
xerrors/Yuxi7,5432026年10月29日 更新

image-gen

無料概要あり

依頼内容に沿った画像やポスター、イラストを生成して作業フォルダに保存し、会話内で画像として確認できる形で提示します。

  • 文章からイラストを作りたいとき
  • 告知用ポスターの案を作りたいとき
  • Qwen-Imageで画像を生成したいとき
xerrors/Yuxi7,5432026年10月29日 更新

knowledge-base

無料概要あり

設定済みの知識ベースを検索し、文書を開いて該当箇所を探します。資料に基づく回答や内容の確認、根拠の引用に使えます。

  • 社内資料をもとに質問へ答えたいとき
  • 文書の記述を照合したいとき
  • 根拠となる段落を探したいとき
xerrors/Yuxi7,5432026年10月29日 更新

xerrors のスキルをすべて見る

このスキルの問題を報告する