AgenticWorkflow: ユニバーサルエージェンティックスキル&実行ツールチェーン は何をしますか?
複雑なタスクを決定論的で自己検証可能な自律型ワークフローに変換する、多能性幹細胞フレームワークおよびマルチエージェント実行エンジン。
実行不変条件
$$\text{Intent} \xrightarrow{\text{Research}} \text{Plan (SOT state.yaml)} \xrightarrow{\text{Implementation}} \text{4-Layer Quality Gates} \xrightarrow{\text{pACS Delta}} \text{Verified Deliverable}$$
⚡ 動的モードルーター
コンテキストまたは明示的なフラグから目的のモードを検出します。
| モード | トリガーフレーズ | コア実行フロー |
|---|---|---|
| 1. DESIGN | "design workflow", "new pipeline", "workflow.md" | リサーチ → 計画 → 実装の3段階ブループリント生成 |
| 2. EXECUTE | "run workflow", "execute pipeline", "start step" | SOTステートマシンドライバーによるステップバイステップの成果物生成 |
| 3. AUTOPILOT | "autopilot", "fully automated", "hands-off" | (human) チェックポイントを意思決定ログとともに自動承認。セーフティフックを強制。 |
| 4. ULW | "ulw", "ultrawork", "maximum rigor" | 3つの強化因子:シーシュポス持続性、必須分割、リトライエスカレーション |
| 5. VERIFY | "verify step", "quality gates", "run pacs" | L0アンチスキップ → L1検証 → L1.5 pACS → L2敵対的レビュー |
| 6. OPTIMIZE | "optimize workflow", "reduce cycle time", "streamline" | リーンなボトルネック分析、自動化スコアリング、サイクルタイム圧縮 |
3つの絶対基準(憲法的カノン)
このスキルによって作成または管理されるすべてのワークフロー、ツール、サブエージェントは、厳密に3つの絶対基準を継承します。
- 絶対基準1: 最終成果物の品質
速度、トークンコスト、ワークロード、長さの制限は完全に無視されます。すべての決定の唯一の基準は、最終成果物の品質です。
- 絶対基準2: 単一ファイルSOT + 階層型メモリ
すべての共有状態は単一のファイル(
state.yaml)に集中します。SOTへの書き込み権限は、オーケストレーター/チームリーダーのみが排他的に所有します。並行エージェントは、共有ファイルを同時に変更することはありません。 - 絶対基準3: コード変更プロトコル(CCP)
コードの書き込み、変更、追加、削除を行う前に、内部的に以下を実行します:ステップ1(意図の理解)→ ステップ2(波及効果分析)→ ステップ3(変更計画)。コーディングアンカーポイント(CAP-1〜4)によって管理されます。
4層品質保証スタック
flowchart TD
StepStart["Step Execution"] --> L0["L0: Anti-Skip Physical Guard (File exists & >= 100 bytes)"]
L0 -->|PASS| L1["L1: Verification Gate (100% functional goal achievement)"]
L0 -->|FAIL| Diag["Abductive Diagnosis"]
L1 -->|PASS| L15["L1.5: pACS Self-Rating (F/C/L Pre-mortem scoring)"]
L1 -->|FAIL| Diag
L15 -->|RED: <50| Diag
L15 -->|GREEN / YELLOW| L2["L2: Adversarial Review (@reviewer + @fact-checker)"]
L2 -->|PASS| SOT["Advance SOT (current_step + 1)"]
L2 -->|FAIL| Diag
Diag --> Retry["Retry with Alternative Hypothesis (Max 3)"]
- L0 アンチスキップガード: 成果物がディスク上に存在し、空でないことを決定論的に検証します(
MIN_OUTPUT_SIZE >= 100 bytes)。 - L1 検証ゲート: すべての受入基準が100%達成されていることを意味的に検証します。
- L1.5 pACS(予測エージェント信頼度スコア): 忠実性、完全性、論理性にわたる事前評価。$pACS = \min(F, C, L)$。
GREEN (>= 70): 自動進行。YELLOW (50 - 69): 意思決定ログの弱い次元にフラグを立て、続行。RED (< 50): 停止し、リワークをトリガー。
- L2 敵対的レビュー:
@reviewerおよび@fact-checkerによる独立したジェネレーター-クリティック評価。
ワークフロー最適化エンジン(リーン&自動化)
ワークフローの分析または最適化時:
- ボトルネック重大度: ボトルネックを1〜5でスコアリング。
- 自動化の可能性: 手動タスクをエージェント委任用に定量化。
- エラー削減: 障害が伝播する前に根本原因に品質ゲートを実装。
- サイクルタイム短縮: 成果物の品質を高めながら、40%以上のサイクルタイム短縮を目標。
自律型自己燃料供給エンジン&サーキットブレーカー
システムは、組み込みのエネルギー管理を備えたエンドツーエンドの自律エンジンとして動作します。
- 自己燃料供給&エネルギーループ: 動的なトークンおよびコンテキストヘッドルームの監視。自動RLM状態圧縮と、コンテキスト枯渇前の燃料補給チェックポイント。
- 寓話サーキットブレーカー: 状態遷移
CLOSED→OPEN→HALF_OPEN。連続障害が2回以上続いた場合に投機的スラッシングを自動停止。アブダクティブ診断(diagnose_context.py)により根本原因を隔離し、構造化リカバリを実行。 - クリーンコードガード: 24のクリーンコード必須事項(小さな関数、意図を明らかにする名前、最大4つのパラメータ、例外の飲み込みなし、偽の成功モックなし)をチェックする自動ASTガードパス。
- AIエンジニアリング評価: 統合された4/5の異質影響テスト($\ge 0.80$)、PSI分布ドリフト監視、および敵対的プロンプトインジェクションサニタイズ。
CLI & ツールチェーン統合
# 自己燃料供給&エネルギー管理を備えたエンドツーエンドの自律型自動操縦ワークフローを起動
tool: agentic-workflow autopilot --title "本番パイプライン" --goal "自律型デリバリー"
# クリーンコードガード監査パスを実行(SOLID、24必須事項、AI障害モード)
tool: agentic-workflow guard [ディレクトリ]
# AIエンジニアの公平性、ドリフト、プロンプトインジェクション評価ゲートを実行
tool: agentic-workflow eval
# マルチエージェントの観測可能トレースログとスパンを照会
tool: agentic-workflow traces
# インフラストラクチャ、SOTランタイムディレクトリ、ヘルスチェックを初期化
tool: agentic-workflow init
# ワークフロースキーマ、SOT整合性、pACSログを検証
tool: agentic-workflow validate
# ライブワークフローダッシュボードと可観測性メトリクスを確認
tool: agentic-workflow status
# 完全自動テストスイートを実行(安全性、ガード、MAS、評価)
tool: agentic-workflow test
リファレンスマップ
- アーキテクチャ&DNA:
soul.md、AGENTICWORKFLOW-ARCHITECTURE-AND-PHILOSOPHY.md - 操作マニュアル:
AGENTICWORKFLOW-USER-MANUAL.md - 共通ディレクティブ:
AGENTS.md、CLAUDE.md、GEMINI.md - プロトコル:
docs/protocols/(autopilot-execution、quality-gates、ulw-mode、code-change-protocol、context-preservation-detail) - サブエージェント:
.claude/agents/(reviewer、fact-checker、translator) - スクリプト:
.claude/hooks/scripts/(context_guard、validate_pacs、validate_review など)