hiroki ito c872debe4b feat: コミットレポートツール（コミネコ）初期コミット

Made-with: Cursor

2026-04-03 19:31:32 +09:00

3.9 KiB

Raw Blame History

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	※未設定時はデバッグチャンネル

デバッグ用チャンネル: YOUR_DEBUG_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` を確認

3.9 KiB Raw Blame History