持ち物検査係

01取り付け

PyPI から入ります。既定のルール・Knowledge Unit・safe test のデータが同梱されているので、リポジトリを clone しなくても skos assess が動きます。

pip install security-knowledge-os          # エンジン + CLI（依存は pydantic と pyyaml）
pip install "security-knowledge-os[api]"   # + ローカル FastAPI アプリ

02最小構成で動かす

査定したいエージェントの構成を YAML で書きます。下は「アップロード文書と Web を RAG で読み、承認なしでメールを送れる」構成（リポジトリ同梱の fixture V-001）です。

name: my-summarizer
system_prompt: "You summarize retrieved documents for the user."
rag:
  enabled: true
  sources: [uploaded_documents, web]
memory:
  enabled: false
tools:
  - name: email_send
    permissions: send
  - name: file_read
    permissions: read
outbound:
  enabled: true
  destinations: [smtp.example.com]
human_approval:
  email_send: false
credentials:
  storage: env
  exposed_to_model: "false"

$ skos assess my-agent.yaml --no-packs
status: COMPLETED
overall_status: FAIL
human_review_required: True
model: none (deterministic_only=True)

findings:
  [FAIL   ] TOOL-001  High-impact tool without a human approval gate
  [WARN   ] CRED-001  Raw secret reachable by the model
  [WARN   ] GOV-001   High-impact actions without full approval coverage
  [FAIL   ] PI-003    Indirect prompt injection with an outbound action path

safe tests (vetted templates):
  - ST-TOOL-001 [sandbox] approval=True
  - ST-CRED-001 [sandbox+read_only+canary] approval=False
  - ST-IPI-001 [sandbox+canary] approval=False

（上は同梱 fixture V-001 を v0.4.0・LLM なし・--no-packs で実行した結果の抜粋。--no-packs を外すと、有効なパックによって findings が追加される場合があります。--json で機械可読の結果、--strict で FAIL 時に終了コード 1。）

03入力YAMLの項目

未知のキーは拒否されます（extra="forbid"）。書いていない項目は「不明」として扱われ、関係するルールは UNKNOWN になります。

04判定と終了コード

全体の結果（overall_status）は PASS / CONDITIONAL / UNKNOWN / FAIL。高い影響のある操作には HUMAN_APPROVAL_REQUIRED が返り、自動実行はされません。

05コマンド一覧

06追加パーツ（Update Pack）

ルールを追加する ZIP です。中身はデータ（ルール YAML・マニフェスト・チェックサム）だけで、コードは含みません。公式パックは Ed25519 で署名されていて、署名のないパックは --allow-unsigned を付けない限り入りません。配布は skos-packs の Releases。

skos pack verify  mcp-2026.10.0.zip   # チェックサム・署名・互換性
skos pack install mcp-2026.10.0.zip

# MCP クライアント設定から、サーバーごとの査定入力を作って査定
skos scan mcp .mcp.json --out mcp-assessments --assess

# エージェント全体の組み合わせを見る（capgraph）
skos scan mcp .mcp.json --client claude-code --out mcp-assessments --assess
skos assess mcp-assessments/_agent.yaml --only-pack capgraph

skos scan mcp は設定内の鍵を「あるかどうか」だけ確認し、値を書き出したり表示したりしません。設定から読み取れない項目は推測せず null（UNKNOWN）のまま残します。

07LLM をつなぐ場合

LLM は既定でオフ（SKOS_LLM_PROVIDER=none）。オンにしても、LLM の出力には状態や全体判定を書く欄がないため、決定論的な FAIL を作ることも消すこともできません。LLM ができるのは観察（WARN / UNKNOWN まで）・質問・メモの追加だけです。

export SKOS_LLM_PROVIDER=anthropic
export ANTHROPIC_API_KEY=...   # 運用者が注入する。リポジトリには置かない

RAG の出どころ・宛先・ツール名などは、LLM に送る前に rag_source_1 destination_1 tool_1 のような匿名ラベルに置き換えられ、元の値はリクエストに含まれません。

08ローカル API

[api] 付きで入れると FastAPI アプリ（uvicorn app.main:app）が使えます。知識の中身を変更するエンドポイントはありません。

09取扱上の注意

10関連パーツ