CMDC.Blueprint behaviour (cmdc v0.3.0)

Agent 蓝图声明式定义，可复用的 Agent 配置模板。

Blueprint 是一种声明式的 Agent 配置规格，包含身份、工具集、Plugin 列表、 Skills 目录、Sandbox 等所有启动参数。采用 behaviour + struct + 管道构建器模式，无 DSL 宏。

三种用法

用法 1：实现 behaviour（推荐）

defmodule MyApp.CodingAgent do
  @behaviour CMDC.Blueprint

  @impl true
  def build(_opts) do
    CMDC.Options.new!(
      model: "anthropic:claude-sonnet-4-5",
      tools: [CMDC.Tool.ReadFile, CMDC.Tool.WriteFile, CMDC.Tool.Shell],
      plugins: [CMDC.Plugin.Builtin.SecurityGuard],
      system_prompt: "你是一个专业的 Elixir 开发者。",
      skills_dirs: ["./.cmdc/skills"],
      working_dir: "."
    )
  end
end

# 使用
opts = MyApp.CodingAgent.build([])
{:ok, agent} = CMDC.create_agent(opts)

用法 2：直接构造 struct 并通过管道组合

blueprint =
  %CMDC.Blueprint{
    name: "my-agent",
    model: "anthropic:claude-sonnet-4-5",
    system_prompt: "你是一个专业助手。"
  }
  |> CMDC.Blueprint.add_tools([CMDC.Tool.ReadFile])
  |> CMDC.Blueprint.add_plugins([CMDC.Plugin.Builtin.SecurityGuard])
  |> CMDC.Blueprint.add_skills_dirs(["./.cmdc/skills"])

opts = CMDC.Blueprint.to_options(blueprint)
{:ok, agent} = CMDC.create_agent(opts)

用法 3：运行时覆盖（多租户场景）

opts = MyApp.CodingAgent.build(
  system_prompt_suffix: "当前用户：Alice",
  provider_api_key: "sk-..."
)

Summary

Types

t()

Callbacks

build(opts)

构建 Agent 启动选项。

Functions

add_memory(bp, paths)

追加 Memory 文件路径列表（去重）。

add_plugins(bp, plugins)

追加 Plugin 列表（按模块去重）。

add_skills_dirs(bp, dirs)

追加 Skills 目录列表（去重）。

add_subagents(bp, subagents)

追加 SubAgent 声明式规格列表（按 name 去重）。

add_tools(bp, tools)

追加工具模块列表（按模块去重）。

override(bp, fields)

覆盖蓝图字段，返回新 struct。

to_options(bp, overrides \\ [])

将 Blueprint struct 编译为 CMDC.Options.t()。