workflow

belta-workflow-agent（Belta 業務アシスタント）

ひとことで言うと — いつもの言葉で「これやっといて」と頼むだけで、4 つのアプリ（Notion・Slack・GitHub・Google Drive）への入力や整理を代わりにやってくれる、あなた専用のアシスタントです。

たとえるなら、4 つの道具を使い分けられる優秀な秘書。「どのアプリを開いて、どこに何を入力するか」を、あなたが考えなくてよくなります。

例：

• 「来週の打ち合わせメモを整理して」と話しかける → メモアプリ（Notion）に自動で整理して保存
• 「インフラチームに共有して」と話しかける → チャット（Slack）に自動で投稿

いまの状態：お試し中の段階です。情報システム部の 2〜3 名が実際に使って動作を確認しています（2026-06-14 まで）。ここで集めた「どれだけ仕事が楽になったか」の記録を、2026-06-10 の経営会議に提出します。

---

できること

話しかけた内容に合わせて、行き先のアプリを自動で選んで処理します。

あなたが話しかけること	アシスタントがやること
「来週の MTG メモを整理して」	メモアプリ（Notion）にまとめる
「インフラチームに共有して」	チャット（Slack）に投稿する
「先週の作業をまとめて」	開発記録（GitHub）から要約する
「議事録 PDF を取り込んで」	ファイル置き場（Google Drive）から読み込む

さらに、使えば使うほどあなたに合わせて賢くなります。

• 同じ言い方で何度か直すと、「次はこうしますね」と覚えてくれます。
• よく頼む種類の仕事は、その仕事の「専門アシスタント」が自動で用意されます。

---

使い始める（3 ステップ・約 5 分）

ステップ 1：道具を入れる

下のコマンドを 1 回実行します（情シス担当が代行することもできます）。

/plugin marketplace add belta-group/belta-workflow-agent
/plugin install workflow@belta-workflow-agent

入れる範囲（スコープ）は「このフォルダだけ（Local）」を選んでください。 このアシスタントは、あなた専用のフォルダ（~/my-agent）の中でだけ働く設計です。「すべての場所（User）」で入れてしまうと、関係ない作業中にも秘書が顔を出してしまいます。間違って全体に入れても、次のステップで専用フォルダだけに付け替えられます。

ステップ 2：自己紹介に答える

道具を入れたあと、最初に画面を開いたときに、案内が自動で始まります。 案内ではまず あなた専用のフォルダ（~/my-agent）を自動で用意し、そのフォルダの中だけでアシスタントを有効にします（同名フォルダが既にあれば my-agent-2 のように別名で作ります）。続けて、氏名・部署・メール・扱う情報の重要度・つなぎたいアプリを、対話形式で聞かれるので答えるだけです。

もし案内が出ないときは /workflow-setup と打てば、いつでも始められます。 一度終えれば次からは自動で始まりません。途中でやめた場合は、次に開いたときにまた続きから案内されます。 セットアップが終わったら、次回からは ~/my-agent フォルダを開いて使ってください（POSIX: $HOME/my-agent / Windows: %USERPROFILE%\my-agent）。アシスタントはそのフォルダの中でだけ働きます。

ステップ 3：4 つのアプリと「つなぐ」許可をする

パスワードを入力したり、難しい接続キーをコピーしたりする必要はありません。 各アプリの「許可」ボタンを押すだけで安全につながります（この仕組みを OAuth と呼びます）。

アプリ	つなぎ方
Notion	claude.ai の設定画面 → Connectors → Notion を「許可」
Slack	claude.ai の設定画面 → Connectors → Slack を「許可」
Google Drive	claude.ai の設定画面 → Connectors → Google Drive を「許可」
GitHub	gh auth login --web というコマンドを 1 回実行（GitHub 用の小さな道具 gh が未導入でも、セットアップが自動で入れてくれます）

必要なもの：claude.ai の Max / Team / Enterprise いずれかの契約（本リポジトリは Max 契約を前提に作られています）。

これで準備は完了です。あとは ~/my-agent フォルダを開いて /workflow と打って話しかけるだけです。

---

使い方の例

> /workflow

アシスタント: はじめまして。まず簡単に教えてください。
  1. お名前
  2. 部署
  3. 主な業務（3 つまで）
  4. 扱う情報の重要度（公開 / 社外秘 / 極秘）
  5. つなぎたいアプリ（Notion / Slack / GitHub / Google Drive）

このあとは、ふつうに話しかけるだけ。内容に応じて、自動で行き先のアプリが選ばれます。

---

以下は、導入や保守を担当する 情報システム部・技術担当者向け の詳細です。利用するだけの方は読まなくて構いません。

技術メモ（担当者向け）

しくみの要点

• スコープはローカル限定運用。/plugin install の既定は User スコープ（全ディレクトリ発火）だが、本エージェントは専用フォルダ（~/my-agent）限定で使う。/workflow-setup（scripts/setup-agent-home.js）が専用フォルダを作り、その <folder>/.claude/settings.local.json に enabledPlugins + extraKnownMarketplaces を冪等マージして局所有効化する。SessionStart フックは、ユーザースコープで有効化されていれば警告して付け替えを促す（設定は自動で書き換えない）。
• 初回セットアップは SessionStart フックで once-only 起動（Claude Code にインストール時フックが無いための代替手段）。完了時に ~/.belta/.onboarded が作成され、以降は自動案内されない。未完了のうちは毎回のセッション開始時に再案内される（やり残しの自己修復）。
• 認証はすべて OAuth ベース（PAT・API キーの手動コピペ不要）。Notion / Slack / Google Drive は claude.ai Connector OAuth、GitHub は gh CLI の device flow OAuth。
• GitHub のみ MCP サーバを置かず、gh CLI を Bash 経由で直接呼び出す（理由：監査経路の一元化 + ユーザ向け操作の最小化）。
• データ配置はハイブリッド：機密データ（profile・notes・audit・config・rules）はホームの ~/.belta/、自動生成される subagent / skill の実体は専用フォルダの ~/my-agent/.claude/agents・.claude/skills（索引はホームに残す）。
• パーソナライズの内部動作：
  • 発話 → ルール蓄積：「次回からは」「毎回」等のフレーズや同じ訂正 2 回検出で、~/.belta/rules/ にルールを提案・蓄積。
  • 業務領域 → 専用エージェント生成：同じ業務領域（例: Notion DB 設計 / 営業案件レビュー）が 5 営業日以内に 2 回出現すると、専用 Claude Code subagent を専用フォルダの ~/my-agent/.claude/agents/<slug>.md に直接生成し、そのフォルダのセッションから標準 Agent ツールで呼び出せるようにする（~/.claude/ への symlink 公開は廃止）。

構成