122 lines
3.8 KiB
Markdown
122 lines
3.8 KiB
Markdown
---
|
|
name: slack-formatting
|
|
description: Slackチャンネルに複数画像をまとめて投稿する。Slack投稿、レポート投稿、画像アップロード時に使用。curlは使わずpost-report.jsを実行すること。
|
|
allowed-tools: Bash(node:*), Read
|
|
---
|
|
|
|
# Slack Formatting ガイド
|
|
|
|
Slack への投稿方法を説明します。
|
|
|
|
## ⚠️ 重要: 必ずスクリプトを使用すること
|
|
|
|
**Slack投稿は必ず以下のスクリプトを使用してください。**
|
|
curlで直接APIを呼び出したり、独自の投稿ロジックを書いたりしないでください。
|
|
|
|
```bash
|
|
# 必ずこのスクリプトを使用
|
|
node .claude/skills/slack-formatting/scripts/post-report.js \
|
|
--message "メッセージテキスト" \
|
|
/tmp/image1.png /tmp/image2.png ...
|
|
```
|
|
|
|
## スクリプト使用方法
|
|
|
|
### 基本的な使い方
|
|
|
|
```bash
|
|
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] ✅ 投稿成功！
|
|
```
|
|
|
|
---
|
|
|
|
## 禁止事項
|
|
|
|
以下の方法は**絶対に使用しないでください**:
|
|
|
|
```bash
|
|
# ❌ 禁止: 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` を確認 |
|