スキル baml-integration

📦

baml-integration

Name: baml-integration
Author: Consiliency

コンテンツリビジョン r1 中リスク ⚙️ 外部コマンド📁 ファイルシステムへのアクセス🌐 ネットワークアクセス

型安全な BAML 統合を構築する

LLM 機能は、アプリケーションの型や生成クライアントからずれやすいものです。このスキルは、より安全な統合作業のために、BAML スキーマ、DTO、クライアント生成、ラッパーをガイドします。

対応: Claude Codex Code(CC)

⚠️ 50 不十分

Maintain this Skill? Claim it ⚠️ 50 不十分

自分のエージェントでインストール

このリクエストをエージェントにコピーしてください。正規の Skill ページとマニフェストが含まれています。

エージェントリクエスト

Review the Skillstore skill "baml-integration" from https://skillstore.io/skills/consiliency-baml-integration.md and its manifest at https://skillstore.io/api/skills/consiliency-baml-integration/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

エージェントは引き続き計画を提示し、セキュリティポリシーで必要な確認を求める必要があります。

エージェントが読めるリソース

AI エージェント、クローラー、スクリプトがページ全体ではなく整理されたコンテキストを必要とする場合は、これらのリンクを使ってください。

Markdown詳細 GET /skills/consiliency-baml-integration.md 署名済み manifest GET /api/skills/consiliency-baml-integration/manifest 署名済み lockfile GET /api/skills/consiliency-baml-integration/lockfile

テストする

「baml-integration」を使用しています。あるチームが、型付き LLM 出力を持つドキュメント分析機能を追加したいと考えています。

期待される結果:

このスキルは、BAML のリクエスト型とレスポンス型、関数の形、クライアント生成手順を提案します。

「baml-integration」を使用しています。生成された TypeScript クライアントが API レスポンス型と一致しなくなっています。

期待される結果:

このスキルは、スキーマを比較し、ずれを特定し、再生成と利用側の更新を推奨します。

「baml-integration」を使用しています。バックエンドサービスが複数のハンドラーから BAML 関数を直接呼び出しています。

期待される結果:

このスキルは、リトライ、キャッシュポリシー、メトリクス、構造化されたエラーハンドリングを備えた共有ラッパーを提案します。

セキュリティ監査

中リスク

v10 • 2026/7/13 バージョン別レポートを開く

All 80 static findings are false positives caused by Markdown syntax, fixed imports, benign identifiers, or constrained maintenance commands. Three medium-risk examples remain: mutable CI dependencies, raw exception disclosure, and unbounded in-memory caches. No audit-directed prompt injection, credential theft, or malicious command intent was found.

スキャンされたファイル

1,906

解析済み行数

レビュー項目

誤検知を無視

確認済みのセキュリティ上の懸念 (3)

中

cookbook/schema-sync.md:217 cookbook/schema-sync.md:220

Mutable CI Dependencies

The CI example uses a mutable action tag and installs baml-cli without a version pin, allowing upstream changes to execute in the workflow.

Lines 217 and 220 use a mutable action tag and an unversioned package install. Both are clear supply-chain exposures, although neither dependency is shown as malicious.

中

cookbook/client-wrapper.md:383

Raw Exception Details Exposed to API Clients

The FastAPI example returns raw exception text, which can reveal provider messages, internal details, or sensitive request context.

Line 383 directly places str(e) in an HTTP 500 response. The exact disclosed data depends on runtime exceptions, but the exposure path is explicit.

中

cookbook/client-wrapper.md:45 cookbook/client-wrapper.md:99 cookbook/client-wrapper.md:147 cookbook/client-wrapper.md:198

Unbounded In-Memory Response Cache

The wrappers cache request-derived keys and responses without limits or eviction, so repeated unique inputs can exhaust process memory.

Both wrapper examples use process-local maps and insert responses without size or age controls. Unique request inputs can therefore grow memory use continuously.

リスク要因

⚙️ 外部コマンド (50)

cookbook/client-wrapper.md:165-181 cookbook/client-wrapper.md:181-221 cookbook/schema-sync.md:230 SKILL.md:39 SKILL.md:50-59 SKILL.md:59-65 SKILL.md:65-88 SKILL.md:88-94 SKILL.md:94-124 SKILL.md:124-130 SKILL.md:130-136 SKILL.md:136-140 SKILL.md:140-152 SKILL.md:152-154 SKILL.md:154-165 SKILL.md:165-171 SKILL.md:171-175 SKILL.md:175-179 SKILL.md:179-187 SKILL.md:187 SKILL.md:188 SKILL.md:189 SKILL.md:190 SKILL.md:191 SKILL.md:192 SKILL.md:193 SKILL.md:194 SKILL.md:195-196 SKILL.md:196 SKILL.md:202 SKILL.md:203 SKILL.md:204 SKILL.md:208-231 SKILL.md:231-235 SKILL.md:235-250 SKILL.md:250-258 SKILL.md:258-270 SKILL.md:270-276 SKILL.md:276-282 SKILL.md:282-288 SKILL.md:288-297 SKILL.md:297-303 SKILL.md:303-309 SKILL.md:309-317 SKILL.md:317-330 SKILL.md:330-336 SKILL.md:336-349 SKILL.md:349-355 SKILL.md:355-369 SKILL.md:369-375

📁 ファイルシステムへのアクセス (3)

cookbook/client-wrapper.md:125 cookbook/client-wrapper.md:131 SKILL.md:58

🌐 ネットワークアクセス (1)

SKILL.md:144

監査者: codex 監査履歴を表示 →

このレポートを共有・引用

バージョン付き評価レポート、中立的なバッジ、埋め込みカード、引用を共有できます。Skillstore は証拠を報告しますが、この Skill が安全かどうかは判断しません。

バージョン別レポートを開く

レポートリンクをコピー

https://skillstore.io/skills/consiliency-baml-integration/audits/10?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdownバッジ

[![Skillstore security assessment](https://skillstore.io/badges/skills/consiliency-baml-integration/security.svg)](https://skillstore.io/skills/consiliency-baml-integration?utm_source=security_passport_badge)

HTMLバッジ

<a href="https://skillstore.io/skills/consiliency-baml-integration?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/consiliency-baml-integration/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

埋め込みカード

<iframe src="https://skillstore.io/embed/skills/consiliency-baml-integration.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

学術引用 (APA · BibTeX · CFF)

APA形式の引用

Consiliency. (2026). baml-integration security audit report (audit version 10) [Author version unspecified]. Skillstore. https://skillstore.io/skills/consiliency-baml-integration/audits/10

BibTeX形式の引用

@techreport{consiliency-consiliency-baml-integration-2026,
  author = {Consiliency},
  title = {baml-integration security audit report (audit version 10)},
  institution = {Skillstore},
  year = {2026},
  number = {10},
  url = {https://skillstore.io/skills/consiliency-baml-integration/audits/10},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "baml-integration security audit report (audit version 10)"
version: "unspecified"
type: report
authors:
  - name: "Consiliency"
date-released: "2026-07-13"
url: "https://skillstore.io/skills/consiliency-baml-integration/audits/10"
identifiers:
  - type: other
    value: "skillstore:consiliency-baml-integration:audit:10"
    description: "Skillstore immutable audit report identifier"

Skillstore スコア

このスコアの理由証拠の信頼度: 高

アーキテクチャ

保守性

コンテンツ

コミュニティ

仕様準拠

作成できるもの

型付き LLM 機能を追加する

新しい LLM ワークフローを追加する前に、BAML の入力、出力、関数を定義します。

生成クライアントを同期する

BAML スキーマをデータベースモデル、API 契約、フロントエンド型と整合させます。

LLM アクセスを標準化する

生成された BAML クライアントを、リトライ、キャッシュ、レート制限、一貫したエラーハンドリングでラップします。

これらのプロンプトを試す

BAML セットアップを調査する

Review my repository for BAML files and generated clients. Summarize the current setup and any missing generation steps.

型付き出力を設計する

Create BAML input and output types for this LLM feature. Include clear field descriptions and enum choices where useful.

スキーマ変更を同期する

Compare these model changes with my BAML types. Identify fields to add, rename, or deprecate before regenerating clients.

クライアントラッパーを堅牢化する

Review this BAML client wrapper for retries, caching, rate limits, metrics, and error handling. Recommend targeted improvements.

ベストプラクティス

アプリケーションロジックを書く前に、明示的な BAML 入力型と出力型を定義します。
スキーマ変更後はクライアントを再生成し、リリース前に生成ファイルを検証します。
明確な説明、enums、焦点を絞った DTO を使用して、曖昧な LLM 出力を減らします。

回避

BAML 出力型でレスポンスを表現できる場合は、型なしの LLM テキストを解析しないでください。
生成クライアントをデータベース、API、フロントエンド契約からずれたままにしないでください。
リトライ、キャッシュ、レート制限を無関係なハンドラーコード内に隠さないでください。

よくある質問

このスキルは何のためのものですか？

チームが BAML を使用して、型付き LLM プロンプト、生成クライアント、DTO、サービスラッパーを扱えるよう支援します。

Python と TypeScript をサポートしていますか？

はい。例では、生成された Python および TypeScript クライアントと共有型パターンを扱っています。

本番コードを自動生成できますか？

パターンとレビューガイダンスを提供します。ユーザーは変更を適用する前に、生成クライアントとコマンドを確認する必要があります。

BAML ドキュメントの代わりになりますか？

いいえ。一般的な統合パターンを整理するものであり、公式 BAML ドキュメントと併用する必要があります。

いつクライアントを再生成すべきですか？

BAML の型、関数、クライアント、またはジェネレーター設定を変更した後に、クライアントを再生成してください。

Claude、Codex、または Claude Code はこれを使用できますか？

はい。メタデータには、サポート対象ツールとして Claude、Codex、Claude Code が記載されています。

開発者情報

作成者

Consiliency

ライセンス

MIT

Skillstore リビジョン

バージョンに関する注意

作者はバージョンを宣言していません。

リポジトリ

https://github.com/Consiliency/treesitter-chunker/tree/main/.ai-dev-kit/skills/baml-integration

参照

635f69fb8d2f4e6330ba47a4e5a0fb239c04d110

メンテナンスの新しさ

2026/7/25

利用状況

4 ダウンロード · 217 閲覧

ファイル構成

📁 cookbook/

📄 client-wrapper.md

📄 dto-generation.md

📄 schema-sync.md

📁 reference/

📄 baml-patterns.md

📄 SKILL.md