commit-report-tool/.claude/skills/slack-formatting/SKILL.md

name	description	allowed-tools
slack-formatting	Slackチャンネルに複数画像をまとめて投稿する。Slack投稿、レポート投稿、画像アップロード時に使用。curlは使わずpost-report.jsを実行すること。	Bash(node:*), Read

Slack Formatting ガイド

Slack への投稿方法を説明します。

⚠️ 重要: 必ずスクリプトを使用すること

Slack投稿は必ず以下のスクリプトを使用してください。 curlで直接APIを呼び出したり、独自の投稿ロジックを書いたりしないでください。

# 必ずこのスクリプトを使用
node .claude/skills/slack-formatting/scripts/post-report.js \
  --message "メッセージテキスト" \
  /tmp/image1.png /tmp/image2.png ...

スクリプト使用方法

基本的な使い方

node .claude/skills/slack-formatting/scripts/post-report.js \
  --message "📊 今日のコミットレポート

期間: 2026-01-06 00:00 〜 23:59 (JST)
対象: 1ブランチ / 18コミット / 5名

🐱 コミネコ で自動生成" \
  /tmp/daily-summary.png \
  /tmp/branch-summary-main.png \
  /tmp/by-app.png \
  /tmp/timeline.png \
  /tmp/tips.png

環境変数

環境変数	用途	必須
SLACK_BOT_TOKEN	Bot User OAuth Token	✅
SLACK_CHANNEL	投稿先チャンネルID	必須

スクリプトが行うこと

• ✅ 複数画像を1メッセージにまとめて投稿
• ✅ チャンネルに直接投稿（スレッドではない）
• ✅ 詳細なログ出力（原因特定用）
• ✅ エラーハンドリング

スクリプトの出力例

========================================
=== SLACK投稿開始 ===
========================================
[2026-01-07T07:15:00.000Z] 投稿先チャンネル: C0XXXXXXXXX
[2026-01-07T07:15:00.000Z] 画像数: 5
[2026-01-07T07:15:00.000Z] メッセージ: 📊 今日のコミットレポート...
[2026-01-07T07:15:00.000Z]   [1] daily-summary.png
[2026-01-07T07:15:00.000Z]   [2] branch-summary-main.png
...
========================================
=== SLACK投稿完了 ===
========================================
[2026-01-07T07:15:10.000Z] チャンネル: C0XXXXXXXXX
[2026-01-07T07:15:10.000Z] 画像数: 5
[2026-01-07T07:15:10.000Z] ✅ 投稿成功！

---

禁止事項

以下の方法は絶対に使用しないでください:

# ❌ 禁止: curlで直接APIを呼び出す
curl -X POST https://slack.com/api/chat.postMessage ...

# ❌ 禁止: スレッドに投稿する
curl ... -d '{"thread_ts": "xxx"}' ...

# ❌ 禁止: テキストと画像を別々に投稿
curl ... chat.postMessage  # テキスト
curl ... files.upload      # 画像（スレッドに）

---

Block Kit 構造（参考）

テキストメッセージのフォーマットに使用できます。

mrkdwn 記法

書式	記法	例
太字	*text*	太字
イタリック	_text_	イタリック
取消線	~text~	~取消線~
コード	`code`	code
リンク	<URL|テキスト>	https://github.com\|GitHub
メンション	<@USER_ID>	<@U1234>
チャンネル	<#CHANNEL_ID>	<#C1234>

---

トラブルシューティング

症状	原因	対処
画像がスレッドに投稿された	スクリプトを使っていない	post-report.js を使用する
画像が1枚しか投稿されない	スクリプトを使っていない	post-report.js を使用する
3回投稿された	投稿処理が複数回呼ばれた	ログで SLACK投稿開始 の回数を確認
not_authed エラー	環境変数が渡されていない	SLACK_BOT_TOKEN を確認