Meta の個人向けエージェント Muse は、予定やできごとをきっかけに自分から動き、前の会話を覚え、大事な操作の前には承認カードで本人に確かめます。Biz AI は、同じことを会社の業務システムの中で、職員一人ひとりの権限でやるオープンソースです(Apache-2.0、Meta とは関係ありません)。AI は提案まで。確定・承認・金額は必ず人が決めます。
とはいえ、既存の業務システムに AI 社員をつなぐには、業務システム側に足すものがあります(職員と役割、本人のセッション確認、受信者の判定、承認、報告、個人情報の検査……全部で 13 項目)。これを人が一から調べて書くと時間がかかります。
そこで Biz AI には、AI コーディングエージェントに読ませる導入 skill が付いています。この記事では、その skill を Claude Code・Codex・DeepSeek Harness・MetaCoder に入れて、自分の業務システムの AI 化を任せる方法を紹介します。
設計の考え方は Zenn、300 行の例で手を動かす編は Qiita 第 1 回 に書きました。
skill の中身
biz-assistant-integration/
SKILL.md 入口:道の選び方、進め方、守るルール、人が決めること
references/ 必要になったときだけ読む 10 本の手順書
01-assessment.md 既存システムの診断(13 項目)
02-new-system.md 新規に作る場合
03-existing-system.md 既存システムにつなぐ場合(Node.js、別名、他言語、外部モード)
04-manifest.md manifest の書き方と検証
05-business-side.md hooks、event、受信者、承認、提案、報告
06-dsh-profile.md AI 面の profile、送信設定、自動タスク
07-web-and-bff.md 業務 Web の画面と BFF
08-optional-features.md マニュアル、記憶、プロフィール、添付、外部連携
09-rules.md MUST / SHOULD のまとめ
10-verification.md 適合性テストと完了の定義
templates/
integration-plan.md 導入計画のひな形
エージェントはまず SKILL.md だけを読み、いま必要な references/ だけを開きます。正本はリポジトリのドキュメント(開発ガイドラインなど)で、skill はそこへの道案内です。
skill がエージェントにやらせること
診断 → 計画 → 実装 → 検証の順に進みます。
| 手順 | 何をするか | 確かめ方 |
|---|---|---|
| 1 診断と計画 | ログイン、職員と役割、API、トランザクション、バッチを読み、13 項目を「ある/足す/別名」で埋め、進め方を選び、integration-plan.md を書く |
人が計画を確認 |
| 2 manifest | 役割と委託の上限、event と payload の許可リスト、メッセージ、tools、playbooks、報告 |
bridge-validate manifest --strict が 0 で終わる |
| 3 業務側 | hooks(employees・authenticate・isSessionLive・recipientsFor・approvals・proposalKinds・reports・piiScan)。AI の書き込みは提案だけ |
業務のテスト |
| 4 event | 業務の行と emitEvent を同じトランザクションで |
業務のテスト |
| 5 適合性 | TEST 環境に対して 52 項目 | 52 passed, 0 known gaps, 0 skipped |
| 6 AI 面 | profile、ボット、送信設定は閉じたまま | profile の検査 |
| 7 Web と BFF | チャット連携、通知設定、承認、AI の提案、AI 社員のプロフィールの画面 | 型検査、画面 |
| 8 自動タスク | 委託の分類と playbooks を有効にする | profile の検査 |
道は 5 つから選びます:新規に作る/既存の Node.js に server-kit を載せる/既存の API に別名を付ける/Node.js 以外で Bridge v1 を実装して適合性テストで確かめる/コードを変えない外部モード(試行)。
勝手に決めさせない
skill には「人が決めること」の一覧があり、エージェントはそこで止まって選択肢とおすすめを示し、返事を待ちます。たとえば:
- 最初に扱う業務と、AI に読ませてよい範囲
- どの event を、誰に知らせるか(夜間も送るものはどれか)
- AI に提案させてよい種類と、それを受けられる役割
- 自動タスクを誰の委託で動かすか
- 閉じている送信設定を開けるかどうか、その理由
- どのチャット、どの AI モデルを使うか
守らせるルール
- フレームワークの中身(
packages/*・plugins/*・vendor/*・profile の雛形)を書き換えない。足りないものは hooks と設定で埋める - AI のツールは GET と提案だけ。業務の書き込み API は委託に 403 を返す
- 受信者は業務システムが決める。決められないときは送らない
- event とメッセージに個人情報を入れない(ID、日付、件数、状態だけ)
- 秘密情報をリポジトリ・設定ファイル・ログ・チャットに書かない。値は人が入れる
- テストは架空のデータ、ループバック、TEST 環境だけ
- 「何も変えずにつながる」とは言わない。足すものは計画に書く
ツールごとの入れ方
まずリポジトリを取ってきます。
git clone https://github.com/ITC-cloud-soft/biz-ai.git
あとは、使うツールが読む場所へ biz-ai/docs/skill/biz-assistant-integration フォルダごとコピーするだけです。
| ツール | 自分用(全プロジェクト) | チーム用(業務システムのリポジトリ) | 呼び方 |
|---|---|---|---|
| Claude Code | ~/.claude/skills/ |
<業務システム>/.claude/skills/ |
依頼の内容が skill の説明に合えば自動で使われる |
| Codex | ~/.agents/skills/ |
<業務システム>/.agents/skills/ |
自動、または $biz-assistant-integration・/skills
|
| DeepSeek Harness |
~/.dsh/skills/ または ~/.agents/skills/
|
<業務システム>/.dsh/skills/ または .agents/skills/
|
依頼の内容に合えば使われる |
| MetaCoder | — | 業務システムのリポジトリに置く | 「SKILL.md を読んでから進めて」と頼む |
# Claude Code(チーム用)
cp -r biz-ai/docs/skill/biz-assistant-integration <業務システム>/.claude/skills/
# Codex と DeepSeek Harness は .agents/skills を両方とも読むので、1 か所で共用できる
mkdir -p <業務システム>/.agents/skills
cp -r biz-ai/docs/skill/biz-assistant-integration <業務システム>/.agents/skills/
Windows(PowerShell)なら Copy-Item -Recurse biz-ai\docs\skill\biz-assistant-integration "$HOME\.claude\skills\" のように。
MetaCoder(metacoder.myaiportal.net)は、コードベース全体を意味の知識グラフとして読み込み、10 フェーズの Harness パイプラインと機械検証される品質ゲートで開発を進める、私たちの AI 開発ツールです。skill のフォルダを業務システムのリポジトリに置き、最初に SKILL.md を読ませれば、同じ手順で進みます。既存システムの全体像をグラフで持っているので、手順 1 の診断(13 項目の洗い出し)と相性がいいはずです。
頼み方
業務システムのリポジトリでエージェントを開き、ふだんの言葉で頼みます。
この業務システムに Bizアシスタントを導入して。最初は請求の承認から。
Integrate Biz Assistant Framework into this system.
把 biz assistant framework 导入这个既有系统,先从巡检超期提醒开始。
コツは 一つの業務から始めることです(請求の承認、点検の期限切れ、……)。既存の画面と並べて動かし、うまくいったら広げます。
終わったかどうかは、コマンドで決める
skill の最後の手順は「完了の定義」をコマンドで確かめることです。manifest の厳格な検証、適合性テスト 52 / 52(スキップ 0、既知の未対応 0)、業務のテスト、profile の検査、送信設定、型検査。確かめていないこと(本物のチャットや本物のモデルでの確認など)は「未確認」と書かせます。
適合性テストはシステムの外側から HTTP で叩くので、エージェントが書いたコードが Bridge のルールを破っていないかを、人がコードを全部読まなくても確かめられます。たとえば event に職員の名前を足すと、書き込みが拒否されてテストが赤くなります(第 1 回で実際にやっています)。
いちばん詳しい説明は、公式サイトに
この記事は入口です。導入の流れ、仕組み、安全の約束、skill の使い方まで、いちばん詳しく網羅的な説明は公式サイトにまとめています。
-
公式サイト:https://biz-ai.myaiportal.net/
- 導入の流れと skill:https://biz-ai.myaiportal.net/integration.html
- GitHub:https://github.com/ITC-cloud-soft/biz-ai
- 質問・相談:GitHub Discussions