相关实践
用 Microsoft Agent Framework 组合文件型、代码型和 MCP 型 Skills
Microsoft Agent Framework 官方 samples 展示了 Agent Skills 的多种定义和执行方式，适合需要把同一类能力在本地文件、Python 代码和远程 MCP 之间灵活组织的 Agent 工程团队。输入是一个 Microsoft Foundry 项目、已部署模型、Azure CLI 登录、`.env` 环境变量，以及待封装的 skill resources/scripts。执行过程是先用 file_based_skill 把 SKILL.md、references 和 scripts 放到磁盘并通过 `skill_paths` 自动发现；再用 code_defined_skill 或 class_based_skill 把动态资源和脚本以 Python decorator 暴露；复杂场景用 mixed_skills 合并多种定义方式，或用 mcp_based_skill 通过 MCPSkillsSource 从远程 MCP server 发现 `skill://` 资源；对可执行脚本默认保留人工审批，需要读操作提效时使用 ToolApprovalMiddleware 配置 auto approval。产物是一套可分层加载的 SkillsProvider：系统提示只注入 name/description，触发后才加载 SKILL.md、资源和脚本，减少上下文浪费并保留审批边界。验证来自 microsoft/agent-framework samples 对 file/code/class/mixed/MCP skills、progressive disclosure、script_runner、approval middleware 和运行前置条件的说明。
用 Spotify Xirp 统一 Claude Code、Codex 和 Gemini 的并行会话
Spotify 官方 Xirp 文档和发布博客把 Xirp 定位为 macOS 桌面端 agentic development environment，可在多个项目、多个 AI coding agent 和多个 Git worktree 之间管理持久会话，适合企业把 Claude Code、Codex、Gemini CLI 等工具从散落终端收敛成统一工作台。输入是本地仓库、已完成原生 CLI 认证的 Claude Code/Codex/Gemini、需要并行推进的任务，以及可选的 Spotify Portal 组织上下文。执行过程是在 Xirp 中添加本地项目或从 Portal Workspace / catalog entity 启动 session，为每个任务创建独立 Git worktree，在同一控制面切换 agent、终端、文件、rules、skills、session status 和 layout；接入 Portal 后，通过 MCP 把 software catalog、Workspace wiki、ownership、dependencies、architectural decisions 和 prior sessions 注入会话，并在完成后手动上传 Workspace session。产物是一个 vendor-neutral 的多 Agent 会话治理面：同一代码库可并行运行多个互不干扰的 agent session，项目状态和组织上下文可跨 harness 延续。验证来自 Spotify 官方博客对 50+ parallel sessions、worktree、vendor-neutral harness、36,000+ internal sessions 的说明，以及 Xirp docs 对 macOS beta、Claude Code/Codex/Gemini、Portal context、projects、worktrees、rules、skills 和 session upload 的定义。
用 Claude Code monitoring 把企业 Agent 使用量接入治理报表
Anthropic Claude Code monitoring 官方文档提供 OpenTelemetry 指标和日志接入路径，适合企业把 AI coding agent 的使用量、成本、错误和工具调用从聊天黑盒变成可观测数据。输入是一个集中部署 Claude Code 的团队、可接收 OpenTelemetry 的后端，以及需要统计的 sessions、API usage、tool calls、errors、costs 和 latency。执行过程是按文档配置 telemetry 环境变量和 OTLP exporter，把 Claude Code 指标发送到现有 observability 后端；同时结合 costs 文档设置预算、模型选择和 token 使用策略，对异常高成本、失败率、工具调用模式做告警。产物是企业 Agent 使用看板：能按团队或仓库观察 Claude Code 使用趋势、错误、延迟和成本，辅助决定哪些 agent workflow 应继续推广或收紧。验证来自 Anthropic docs 对 monitoring usage、OpenTelemetry metrics/logs/events、exporter 配置、dashboard 用途，以及 costs 文档对预算、usage limits 和成本优化建议的定义。
用 Claude Code self-hosted runner 承接企业云端 Agent 会话
Anthropic Claude Code v2.1.224 release note 增加 `claude self-hosted-runner`，把 Team 和 Enterprise 计划里的 Claude Code web、mobile、desktop 会话运行位置迁到企业自己的机器或容器。输入是一个希望使用 Claude Code 云端入口、但又要控制执行环境、base dir、凭据和网络边界的团队。执行过程是在受管主机或容器里部署 self-hosted runner，指定可写的 `--base-dir`，把 runner 纳入企业已有的主机加固、日志、成本和网络策略；配合 v2.1.225 对 `--base-dir` 不可创建或不可写时启动即失败的修复，把环境错误前置暴露。产物是由企业自有基础设施承载的 Claude Code 会话执行面：用户仍可从 web、mobile、desktop 发起任务，但代码、工具调用和凭据边界落在内部 runner 上。验证来自 Anthropic 官方 release 对 self-hosted environments、Team/Enterprise 适用范围，以及后续 release 对 self-hosted-runner base-dir fail-fast 行为的说明。
按 Claude Code settings 建立企业级权限与遥测默认值
Anthropic Claude Code settings 官方文档把用户、项目、企业 managed settings、环境变量和权限配置分层，适合企业把 AI coding agent 的默认行为从个人习惯变成可审计策略。输入是一个准备推广 Claude Code 的团队、需要统一的 permissions、tools、hooks、model、telemetry 和 project trust 规则。执行过程是用企业 managed settings 或项目级 `.claude/settings.json` 定义允许/拒绝工具、环境变量、hooks 和模型边界，把高风险命令放入 permission prompt 或 deny list；对需要团队共享的配置走版本控制，对本机私密设置留在 user/local settings；同时在设置中明确 telemetry、update、MCP server 和 workspace 行为，避免开发者各自漂移。产物是一套 repo-local 加组织级覆盖的 Claude Code 运行基线：新成员进入工作区时默认拿到相同权限面、审计路径和安全边界。验证来自 Anthropic docs 对 settings precedence、user/project/local/enterprise managed settings、permissions、environment variables、hooks、MCP servers 和 telemetry 配置项的说明。
用 Agent Plugins 1.0.0 打包可校验的最小插件
Agent Plugins 官方 spec repo 给出 vendor-neutral 的 1.0.0 agent extension package format，适合把一个 Skill 或 MCP server 从散落文件收敛成可分发、可校验的插件目录。输入是一个已有 `SKILL.md`、插件名、可选 MCP server 配置，以及希望跨 Claude/Codex/其他兼容客户端复用的安装包。执行过程是创建 `hello-plugin/`，根目录放带 `$schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json` 和 `name` 的 `plugin.json`，把技能放到 `skills/<skill-name>/SKILL.md`，如需要工具面再补 `mcp.json` 并按 `mcp.schema.json` 校验；客户端只需读取 manifest 并发现 `skills/`，具体 UX、权限和安装策略由各客户端实现。产物是一个最小可复现 Agent Plugin，能把技能包结构、manifest schema 和 MCP 配置作为代码审查对象。验证来自官方 README 的 Quick Start 目录树、`plugin.json` 示例、1.0.0 current published release 声明、`plugin.schema.json` 与 `mcp.schema.json` 链接，以及 versioned specification 对 portable contract 的定义。