mcpField
A
agent-workflow-playbook

agent-workflow-playbook

github.com/gingiris-1031エージェントワークフロー87157 回インストール2 週間前に更新
リポジトリ

agent-workflow-playbook について

調査、マーケティング、運用、分析、コンテンツの業務を、測定・検証可能なエージェントワークフローにするためのガイドです。タスク選定、スキル設計、評価、権限、人の承認、導入とロールバックを扱います。

主な機能

  1. 01エージェント自動化の適性基準
  2. 02タスク基準値とワークフロー分解
  3. 03スキル契約とオーケストレーション形式
  4. 04評価・メモリー・可観測性の指針
  5. 05人の承認と権限管理
  6. 06段階的な導入とロールバック計画

活用シーン

  1. 01反復タスクの自動化適性の判断
  2. 02スキルとワークフロー境界の設計
  3. 03基準値に基づくエージェント結果の評価
  4. 04承認と安全な導入の計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gingiris-1031/gingiris-skills --skill agent-workflow-playbook

インストール後、Claude Code で/agent-workflow-playbookを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

_meta.json
.clawhub/
origin.json
references/en/
README.md
references/ja/
README.md
references/ko/
README.md

詳細

AI エージェントのワークフロープレイブック — 専門家の経験をスケーラブルな成果物へ

対象:調査、マーケティング、運用、分析、コンテンツ制作など、高度な知的作業を、測定・修正・再利用できるエージェントワークフローに変える場合。

まず判断する:このタスクはエージェント化すべきか

以下の条件の多くを同時に満たす場合にのみ、自動化に進みます。

  • 入力と合格となる出力を記述できる;
  • 専門家が「何が正しく、何が間違っているか」を説明できる;
  • タスクが繰り返し発生する、または顧客数に応じて提供コストがほぼ線形に増加する;
  • 重要なデータを合法かつ安定して取得できる;
  • 公開、支払い、削除、外部送信の前にエラーを阻止できる;
  • rubric、サンプル集、またはビジネス指標で結果を検証できる。

タスクの発生頻度が低い、目標が継続的に変わる、または合格基準がない場合は、まず人手による SOP を作成し、いきなりマルチエージェントを構築しないでください。

1. ベースラインを確立する。プロンプトをいきなり書かない

直近の実タスクを 10~30 件選び、人手によるベースラインを記録します。

指標定義
タスク成功率初回の成果物が検収に合格したタスク数 / 全タスク数
初回合格率手戻りなしで合格したタスク数 / 全タスク数
所要時間完全な入力を受け取ってから、納品可能な出力ができるまでの経過時間
人手作業時間調査、制作、レビュー、手戻りに費やした人時
1 回あたりのコストモデル、ツール、データ、人手によるレビューのコストの合計
再試行率ツールの再試行または作業全体のやり直しが発生したタスクの割合
重大エラー率誤った公開、誤った支払い、データ漏えいなど、高リスク事象の割合

このベースライン表がなければ、エージェントが「動く」ことしか証明できず、ワークフローが改善したことは証明できません。

2. ビジネスのプロセスを分解してスキルにする

まずビジネスのプロセスを図にし、次に検収可能な結果ごとにスキルへ分解します。

需求澄清 → 数据获取 → 证据整理 → 分析 → 产出 → 质检 → 人工批准 → 交付 → 反馈沉淀

各スキルには、少なくとも以下を含めます。

name: competitor-evidence-pack
input_contract:
  required: [product, market, competitors, time_window]
output_contract:
  required: [claims, source_urls, captured_at, confidence, unknowns]
tools:
  allow: [search, fetch]
  deny: [publish, delete, payment]
acceptance:
  - every material claim has a source
  - source capture time is recorded
  - unknown facts are labeled, not guessed
escalate_when:
  - authenticated source is inaccessible
  - sources conflict on a decision-critical fact

単一の責務を持つスキルを優先します。手順間に明確な依存関係がある場合にのみ、オーケストレーターを追加します。

3. ハーネス:境界を認識し、修正を記憶し、継続的に評価できるシステムを作る

プロンプトが記述するのは 1 回の対話です。ハーネスは、長期的に稼働する環境を管理します。少なくとも次の 5 層を含めます。

  1. コンテキスト:ブランド、顧客、目標、禁止事項、データ権限;
  2. スキル:汎用スキルと顧客固有のスキルを分け、タスクに応じて選択して呼び出します;
  3. メモリ:確認済みの好み、エラー、修正のみを蓄積し、推測を事実として記録しません;
  4. 評価:固定サンプル集、rubric、回帰テスト、ビジネス指標;
  5. 可観測性:各ステップの入力要約、ツール呼び出し、根拠、コスト、所要時間、再試行、最終承認者。

失敗への正しい対処法は、プロンプトを際限なく追加することではありません。失敗の種類を記録する → データ、ツール、推論、検収のいずれの問題かを判断する → 該当する層を修正する → 以前のサンプル集で回帰テストを実施する、という流れです。

4. オーケストレーション方式を選ぶ

パターン適した状況主なリスク
順次後続のステップが前のステップの出力に厳密に依存する上流のエラーが連鎖する
並列複数の独立した情報源や案を同時に生成できる統合時の競合、コストの重複
ルーティングタスクごとに異なる専門性を呼び出すべき分類の誤り
監督者—実行者タスクを複数の独立したサブタスクに分解できる監督者がボトルネックになる
レビュー—修正出力に明確な rubric があり、反復的に改善できるループが止まらない、コストが制御不能になる

まずは単一エージェント+複数スキルから始めるのが基本です。並列化がスループットや専門性の分離に本当に必要だと観測データで確認できた場合にのみ、マルチエージェントへ移行します。

5. 人の介入と権限

以下のアクションは、原則として人の承認が必要です。

  • 外部への公開、一斉送信、ダイレクトメッセージ、または個人を代表した表明;
  • 支払い、返金、購入、価格の約束;
  • データの削除、上書き、一括変更;
  • 許可されていない個人データの利用;
  • 信頼度が低く、顧客の判断に影響する結論。

継続的なタスクでは、同じ許可を繰り返し求めないでください。許可の対象、範囲、有効期間を記録します。権限が不足している場合は、不足項目と再開方法を示し、完了したふりをしないでください。

6. リリース基準とロールバック

次の 4 段階で進めます。

  1. シャドー:エージェントは結果を生成しますが、人手による納品には影響しません;
  2. コパイロット:出力ごとに人が選択、修正、承認します;
  3. ガード付き自動化:低リスクの手順は自動実行し、高リスクのアクションは承認を必須にします;
  4. 自律実行:回帰テストに安定して合格し、完全に監査でき、ロールバック可能な範囲のタスクにのみ適用します。

バージョンを変更するたびに、同じタスク群で成功率、所要時間、人手作業時間、コスト、重大エラー率を比較します。安全性に関する指標のいずれかが悪化した場合は、直前の安定版にロールバックします。

実例:マーケティングインサイトの提供をプロジェクト型からプロダクト型へ

出典:Gingiris の Feishu 会議議事録「AI agent実践導入の課題と大規模展開の試みの分析」、2026-05-10。以下は会議での経験に関する報告であり、独立監査やランダム化比較実験ではありません。

旧プロセス
  • 運用担当者が手作業で Xiaohongshu を約 10 日から 2 週間閲覧;
  • 初期の自動化で情報収集は数時間に短縮されましたが、レポートには依然として人手による思考、反復、作図が必要でした;
  • 高品質な PPT の納品には約 15 人で 3~4 週間かかり、100 社や 1,000 社の顧客への展開は困難でした。
新プロセス
  • インフルエンサーの選定、分野分析、ユーザー層の特定、コンテンツと広告出稿の提案を、汎用スキルと顧客固有のスキルに分解;
  • 正例、反例、合格基準、メモリ、フィードバックの流れをハーネスに組み込む;
  • システムがまずタスクを特定し、スキルを組み合わせて呼び出します。専門家は戦略的な判断と最終検収を担当します;
  • 結果、インサイトに至るプロセス、修正内容をシステムに残し、次回以降に再利用します。
報告された結果
  • 約 15 人 × 3~4 週間 の PPT プロジェクトが、戦略担当者 1 名+AI システムで 5 日、初回合格に変化;
  • 競合分析と広告出稿の提案を 1 日未満で納品可能に;
  • 会議で報告されたサービスコストは、初期の方法と比較して 2 桁のオーダーで低下;
  • 専門の戦略担当者が新しい働き方を習得し、移行するには、依然として約 2~3 か月が必要でした。これは、専門家が「ゼロコストで置き換えられた」わけではないことを示しています。
この事例で実際に検証されたこと

この事例は、「専門家の判断をスキル+ハーネスとして体系化すれば、納品期間と限界人件費を削減できる」という見方を裏付けています。一方で、あらゆる業界で同じ規模の効果が得られることを証明するものではなく、統一基準によるエラー率、モデルコスト、顧客の長期継続率も明らかにされていません。したがって、再利用する際は自チームのベースラインを改めて確立し、品質、再試行、重大エラー率を追加で測定する必要があります。

7 日間の導入チェックリスト

  • 1 日目:頻度の高いタスクを 1 つ選び、実例 10~30 件と人手によるベースラインを集める;
  • 2 日目:入力、出力、rubric、禁止事項、人による承認箇所を定義する;
  • 3 日目:単一の責務を持つスキルを 3~7 個に分解する;
  • 4 日目:根拠の記録、ログ、コスト、失敗の分類を導入する;
  • 5 日目:シャドー再生を行い、最も頻度の高い失敗を修正する;
  • 6 日目:少量のトラフィックでコパイロットを運用し、人手によるベースラインと比較する;
  • 7 日目:継続、ロールバック、または一部のみの自動化を判断する。

最終成果物のテンプレート

ワークフローのレビューごとに、以下を提出します。

  1. ビジネスプロセスと自動化の境界;
  2. スキル一覧と入出力の contract;
  3. オーケストレーション図とツール権限;
  4. 評価セット、ベースライン、今回の結果;
  5. 人の介入、失敗からの復旧、ロールバックの計画;
  6. 次のラウンドで変更する変数を 1 つに絞った実験計画。

Gingiris による制作です。過去の数値は、報告された事例の根拠として明記してください。確実な成果として提示しないでください。

海外展開コミュニティへの参加と資料パックの購入 · コミュニティとリソース

  • 海外展開コミュニティに参加: WeChat で staywildgrow を追加し、「加入社群」とメッセージを送ってください。

  • 資料パックを購入: WeChat で staywildgrow を追加し、Gingiris の海外展開資料パックについて購入方法をお問い合わせください。価格は 599 人民元です。

  • グローバル成長コミュニティに参加: WeChat で staywildgrow を追加し、「加入社群」(コミュニティに参加)とメッセージを送ってください。

  • 資料パックを入手: WeChat で staywildgrow を追加すると、Gingiris のグローバル成長資料パックを 599 人民元で購入できます。

コミュニティと資料パックは任意の利用窓口です。このオープンソースのスキルのインストールと使用に影響するものではありません。

コミュニティと有料の資料パックは任意です。オープンソースのこのスキルのインストールや使用に、いずれも必要ありません。

コメント