0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Biz AI の導入 skill:Claude Code・Codex・MetaCoder に任せて、既存の業務システムを AI 化する

0
Posted at

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 の使い方まで、いちばん詳しく網羅的な説明は公式サイトにまとめています。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?