@ignission/slack-task-mcp 0.2.7 → 0.2.8

package/README.ja.md

@@ -34,6 +34,113 @@ Slackでメンションがたまると、どこから手を付けていいか迷
 
 ---
 
+## Before / After
+
+```
+❌ Before
+メンション来る → 「何求められてる？」 → 固まる → 後回し → 忘れる
+
+✅ After
+メンション来る → スレッドURLを渡す → 目的・不明点・次のアクションが整理される → すぐ着手
+```
+
+---
+
+## こんな人におすすめ
+
+- 💭 Slackのメッセージを何度読んでも、どこから手を付けていいかわからない
+- 📝 返信を書くのに時間がかかる（言い回しを考えすぎる）
+- 🔄 難しい依頼は後回しにして、結局忘れてしまう
+- 🧠 ADHDの特性があり、タスクの着手が苦手
+
+---
+
+## ユースケース
+
+### 1. 曖昧な依頼を分解する
+
+> 「四半期レポートお願いできる？」
+
+**このツールがやること:**
+- 「お願い」の意味を明確化（作成？レビュー？プレゼン？）
+- 不明点を特定（期限は？フォーマットは？誰向け？）
+- 適切な確認メッセージを生成
+- 明確になったら5分単位のステップに分解
+
+### 2. 雑な返信を構造化する
+
+> 「できました。添付します。確認お願いします。」
+
+**添削後:**
+> 「四半期レポートが完成しましたので添付いたします。お手すきの際にご確認いただけますでしょうか。修正点があればお知らせください。」
+
+- 結論 → 根拠 → アクション の構造
+- 丁寧だけど簡潔なトーン
+
+### 3. 中断後に作業を再開する
+
+> 「あのクライアントの依頼、どこまでやったっけ？」
+
+**このツールがやること:**
+- 過去のSlackスレッドを検索
+- タスクの進捗と次のステップを表示
+- スレッドを読み直す必要なし
+
+### 4. 大量のメンションをトリアージ
+
+未読メンションが10件以上あるとき:
+- 各スレッドを素早く分析
+- 優先度を特定（誰かをブロックしてる？期限近い？）
+- 不明確なものは確認メッセージを生成
+- タスクとして保存し、1つずつ片付ける
+
+---
+
+## デモ
+
+```
+あなた: このスレッドを分析して https://xxx.slack.com/archives/C123/p456
+
+Claude: ## 依頼の分析
+
+### 把握した内容
+- **目的**: Q4の売上レポートを作成
+- **成果物**: グラフ付きPDFレポート
+- **期限**: 来週金曜日
+
+### 不明点
+- ❓ どの指標を含めるか？
+  - 影響: これがわからないと着手できない
+  - 選択肢: 売上のみ / 売上+コスト / 完全なP&L
+
+### 確認メッセージ案
+「ご依頼ありがとうございます！確認させてください。
+売上のみで良いでしょうか、それともP&L全体を含めますか？
+また、Q3と同じテンプレートで良いでしょうか？」
+
+### ネクストアクション
+📌 確認メッセージを送る（2分）
+
+---
+
+あなた: P&L全体で、テンプレートは同じでいいって。分解して保存して。
+
+Claude: ✅ タスクを保存しました！
+
+### Q4売上レポート
+1. ☐ Q3テンプレートを開いて複製（2分）
+2. ☐ ダッシュボードからQ4データをエクスポート（3分）
+3. ☐ 売上数値を貼り付け（5分）
+4. ☐ コスト数値を貼り付け（5分）
+5. ☐ グラフを更新（5分）
+6. ☐ サマリー文を書く（5分）
+7. ☐ PDFでエクスポートして送信（2分）
+
+📌 まずステップ1から - たった2分です！
+```
+
+---
+
 ## アーキテクチャ
 
 ```
@@ -168,11 +275,24 @@ https://xxx.slack.com/archives/C12345678/p1234567890123456
 
 ## ADHD向け設計
 
+- **脳から追い出せる** — タスクを保存して忘れてOK。ワーキングメモリを解放
 - **5分以内のステップに分解** — 小さな達成感を積み上げる
 - **最初のステップは最も簡単に** — 着手のハードルを下げる
 - **明確な区切り** — 途中で止めても再開しやすい
 - **Slackを文脈DBとして活用** — 「あの話どうなったっけ」をClaudeに聞ける
 
+### 本当の価値：頭の中で抱えなくていい
+
+```
+❌ 頭の中で抱える
+「あれも忘れちゃダメ」+「これも」+「あとあれも...」→ 常にワーキングメモリ消費 → 疲弊
+
+✅ MCPに預ける
+タスク保存 → 忘れてOK → 脳のリソース解放 → 目の前の1つに集中できる
+```
+
+脳は考えるためのもの。覚えておくのはツールに任せよう。
+
 ---
 
 ## 技術スタック

package/README.md

@@ -34,6 +34,112 @@ When Slack mentions pile up, it's hard to know where to start. Complex requests
 
 ---
 
+## Before / After
+
+```
+❌ Before
+Mention arrives → "What do they want?" → Freeze → Postpone → Forget
+
+✅ After
+Mention arrives → Paste thread URL → Purpose, unknowns & next action organized → Start immediately
+```
+
+---
+
+## Who is this for?
+
+- 💭 You read a Slack message multiple times but still don't know where to start
+- 📝 Writing replies takes forever because you overthink the wording
+- 🔄 You postpone complex requests and end up forgetting them
+- 🧠 You have ADHD traits and struggle with task initiation
+
+---
+
+## Use Cases
+
+### 1. Break down a vague request
+
+> "Can you handle the quarterly report?"
+
+**What this tool does:**
+- Clarifies what "handle" means (create? review? present?)
+- Identifies unknowns (deadline? format? audience?)
+- Generates a confirmation message to ask the right questions
+- Breaks the task into 5-minute steps once clarified
+
+### 2. Structure a messy reply
+
+> "Done with the thing. Attached. Check it."
+
+**After editing:**
+> "I've completed the quarterly report and attached it. Could you review it when you have a moment? Let me know if any changes are needed."
+
+- Conclusion → Reasoning → Action structure
+- Polite but concise tone
+
+### 3. Resume work after interruption
+
+> "What was I working on for that client request?"
+
+**What this tool does:**
+- Searches past Slack threads
+- Shows task progress and next steps
+- No need to re-read the entire thread
+
+### 4. Triage multiple mentions
+
+When you have 10+ unread mentions:
+- Analyze each thread quickly
+- Identify priorities (blocking others? deadline?)
+- Generate confirmation messages for unclear ones
+- Save as tasks and tackle one by one
+
+---
+
+## Demo
+
+```
+You: Analyze this thread https://xxx.slack.com/archives/C123/p456
+
+Claude: ## Request Analysis
+
+### Summary
+- **Purpose**: Create sales report for Q4
+- **Deliverable**: PDF report with charts
+- **Deadline**: Next Friday
+
+### Unknowns
+- ❓ Which metrics to include?
+  - Impact: Can't start without this
+  - Options: Revenue only / Revenue + costs / Full P&L
+
+### Suggested Confirmation Message
+"Thanks for the request! Quick question - should I include just revenue,
+or the full P&L breakdown? Also, should I use the same template as Q3?"
+
+### Next Action
+📌 Send confirmation message (2 min)
+
+---
+
+You: They said full P&L, same template. Break it down and save.
+
+Claude: ✅ Task saved!
+
+### Q4 Sales Report
+1. ☐ Open Q3 template and duplicate (2 min)
+2. ☐ Export Q4 data from dashboard (3 min)
+3. ☐ Paste revenue numbers (5 min)
+4. ☐ Paste cost numbers (5 min)
+5. ☐ Update charts (5 min)
+6. ☐ Write summary paragraph (5 min)
+7. ☐ Export as PDF and send (2 min)
+
+📌 Start with step 1 - just 2 minutes!
+```
+
+---
+
 ## Architecture
 
 ```
@@ -168,11 +274,24 @@ Mark step 1 as complete
 
 ## ADHD-Friendly Design
 
+- **Offload from your brain** — Save tasks and forget them. Free up working memory.
 - **Break into <5 min steps** — Build small wins
 - **Easiest step first** — Lower the barrier to start
 - **Clear stopping points** — Easy to pause and resume
 - **Slack as context DB** — Ask Claude "what happened with that?"
 
+### The Real Value: Stop Carrying Everything in Your Head
+
+```
+❌ Keeping tasks in your head
+"Don't forget this" + "That too" + "And this..." → Constant working memory drain → Exhaustion
+
+✅ Offload to MCP
+Save task → OK to forget → Brain freed up → Focus on just one thing
+```
+
+Your brain is for thinking, not for storing. Let the tool remember so you don't have to.
+
 ---
 
 ## Tech Stack

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ignission/slack-task-mcp",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "MCP Server for Slack task management with Claude Code",
   "type": "module",
   "main": "src/index.js",