workflow-cookbookのLLM活動ログをagent-protocols Evidence契約へ接続するSkill。StructuredLogger、evidence_bridge、plugin_loader/config、sample、schema、testsの整合性を保つ場合に使用。
workflow-cookbookのLLM行動追跡をagent-protocols Evidence契約へ接続する。
| 役割 | 内容 |
|---|---|
| Logging | StructuredLogger による LLM 活動記録 |
| Bridge | Evidence 契約への変換・接続 |
| Plugin | config/loader による拡張点 |
| Schema | inference-plugin-config.schema.json 整合 |
# 1. core files 確認
cat tools/perf/structured_logger.py
cat tools/protocols/evidence_bridge.py
# 2. tests 実行
uv run pytest tests/test_structured_logger.py tests/test_agent_protocol_evidence.py -q
# 3. plugin config 検証
python tools/workflow_plugins/validate_workflow_plugin_config.py --config examples/inference_plugins.agent_protocol.sample.json
| File | Role |
|---|---|
tools/perf/structured_logger.py | Generic LLM activity logger |
tools/protocols/evidence_bridge.py | Evidence contract mapping |
tools/protocols/plugin_loader.py | Plugin discovery |
tools/protocols/plugin_config.py | Config parsing |
tools/protocols/README.md | Protocol docs |
| File | Role |
|---|---|
examples/inference_plugins.agent_protocol.sample.json | Plugin config sample |
examples/agent_protocol_evidence_consumer.sample.py | Consumer sample |
schemas/inference-plugin-config.schema.json | Config schema |
優先ファイル:
tools/perf/structured_logger.pytools/protocols/evidence_bridge.pytools/protocols/plugin_loader.pytools/protocols/plugin_config.py詳細: references/workflow-cookbook.md
StructuredLogger を generic に保つtools/protocols/ 内に配置handle_inference(record) に固定必須フィールドを削除・変更しない:
taskSeedId, baseCommit, headCommitinputHash, outputHash, diffHashmodel, tools, environmentstartTime, endTime, actorpolicyVerdict, mergeResult, staleStatus詳細: references/agent-protocols.md
実装変更時に更新:
docs/requirements.md, docs/spec.md, docs/design.mdRUNBOOK.md, CHANGELOG.md# core tests
uv run pytest tests/test_structured_logger.py tests/test_agent_protocol_evidence.py tests/test_plugin_loader.py tests/test_plugin_config.py -q
# coverage gate
uv run pytest tests/ --cov=. --cov-fail-under=80 -q
| File | Content |
|---|---|
references/workflow-cookbook.md | Integration paths, validation commands |
references/agent-protocols.md | Required Evidence fields, review points |
agents/claude.yaml — Claude metadataagents/openai.yaml — OpenAI metadata