osi-finance-onboarding

Imported from ai-osi-uri/ai-osi-uri-public (plugins/osi-finance/skills/osi-finance-onboarding/SKILL.md). Install upstream with npx skills add ai-osi-uri/ai-osi-uri-public --skill osi-finance-onboarding. Copyright stays with the author.

osi-finance-onboarding（OSI Finance を話しかけるだけで導入する）

原則

人にしかできないことだけを人に残し、それ以外を全部やる。

人にしかできないことは3つ：本人としてログインする／発行・同意・許可のボタンを押す／鍵の値を コピーして貼る（値は Claude を通さない）。 「○○の画面で設定してください」と文章で説明して止まるのは、仕事を人に投げ返している状態なので禁止。 画面までは Claude in Chrome で連れて行き、置き場は先に整え、貼れたことは値を見ずに確かめる。

安全原則（全 osi-finance スキルと共通）：送金しない。台帳を自動確定しない。 機微値（登録番号・口座番号・鍵）はチャットに貼らせず、設定ファイルか各サービスの画面にだけ置く。

全体像（3部＋確認）

相手は管理者と担当者が同じ人のことも多い。最初に「あなたは管理者ですか、経理のご担当ですか、両方ですか」を1問だけ聞き、 関係ない部は飛ばす。

手順

0. 今どこまで進んでいるかを自分で確かめる（毎回）

話しかけられたら、まず状態を調べて「残り」だけを進める。人に「どこまでやりましたか」と聞かない。

結果を「済／未」の一覧で1回だけ示し、未のうち最初の項目から始める。

第1部 会社の準備（管理者）

1-1 契約と招待：Claude Team の契約、経理担当の招待、担当 PC への Claude デスクトップアプリ。 ここは人の決断と契約なので、必要な情報（プラン名・招待の画面の場所）を添えて渡す。

1-2 プラグインの組織登録：Claude in Chrome で Organization settings → Plugins → Add plugins → Upload a file の画面まで進め、キットの 01_osi-finance-plugin.zip を選ぶところで止めて渡す。 「Installed by default」を選ぶ理由（対象メンバー全員に自動配布）を1行で添える。 アップロード後、この会話で osi-finance-setup が呼べるようになっているかで確かめる（再起動が要ることがある）。

1-3 運用モードの決定：編集可（既定）／参照専用（読み取りと報告のみ）。 迷ったら「まず参照専用で2週間、慣れたら編集可」を提案する。決めた値は第3部で OPERATION_MODE に入る。

第2部 担当者の PC の準備（経理担当）

2-1 デスクトップ拡張：キットの 02_AI-OSI-URI-Finance.mcpb を開く（ダブルクリック）ところだけ人。 入ったかは health_check が返るかで確かめる。拡張の設定「台帳フォルダ【必須】」はまだ空でよい（第3部で入れる）。

2-2 各サービスの接続：Claude の設定 → コネクタ。必要なものだけを、上から順に1つずつ：

• MF クラウド会計（会計との突合。ACCOUNTING_SYNC=mf の組織のみ）
• Google Drive（台帳を同期フォルダに置く場合）＋ Google Drive デスクトップアプリ
• Gmail または Superhuman（メール添付の請求書を自動で取り込むなら Superhuman。標準 Gmail は添付を取れない）
• DocuSign（任意） 各接続は「ログインと許可のボタン」だけ人。つながったかは read 系を1回呼んで確かめる。

2-3 MF クラウド請求書の API 接続（鍵）：osi-finance-connect に委ねる（Claude in Chrome で アプリ登録 → 認可 → refresh_token → 拡張に貼る → health_check）。受け渡しの型は credential-handoff の3行（【何の鍵か】／ここからコピー／ここに貼る）。 運用モードが参照専用なら read スコープで通す。

第3部 初期設定

osi-finance-setup を呼ぶ。その前に、聞かれる値を一覧で先に示しておく（会社名・登録番号・ 本店住所・入金口座・請求書番号の付け方・台帳を置くフォルダの絶対パス・運用モード）。 値はチャットに貼らせず、setup が設定ファイルに書く。

setup の中で人に残るのは：台帳フォルダのパスを拡張の設定に入れる（Claude Desktop の完全終了と再起動が要る）、 Drive の共有ボタン、スケジュール登録後の「Run now」。それぞれ画面まで連れて行く。

完了の確認

導入完了レポート（B表9項目）の「要対応」を上から潰す。潰し方が人の判断（税理士確認・ フォルダ体系の選択）なら、そのまま人に渡す。 最後に docs/運用ルール.md の3つ（書き手は1人／Excel で開いたままにしない／「下書き済」で止めない）を そのままの言葉で伝えて終える。

導入キット（提供元が渡すもの）

キットは ツールポータル からダウンロードする（更新も1か所）。ポータルの URL は相手に渡す案内に書く。 キットの中に鍵や実値は入れない（osi-finance-settings.md は example だけを同梱）。

配布の方針（決定済み）

• MF クラウド請求書の OAuth アプリは会社ごとに登録する。 相手の MF アカウントで相手が自分のアプリを作り、 鍵もデータも相手の中で完結する。提供元は何も持たない（手順書の「データは提供元のサーバーにない」を守る）。 osi-finance-connect はこの前提で画面まで連れて行く。提供元のアプリを共用しない
• 導入キットはツールポータルから配る（メール添付・Drive 共有は使わない）
• 伴走の範囲：第1部・第2部は相手だけで進められる想定。詰まった点は下の表に1行ずつ足す

学びの残し方

手順は事前に書き足さない。実際に詰まった1点だけをここに追記する。

やらないこと

• 鍵の値・登録番号・口座番号をチャット・ログ・レポートに残す
• 「設定してください」と説明だけして止まる
• 相手に「どこまでやったか」を聞く（自分で確かめる）
• 送金・台帳の自動確定