onboard-agent

用途

onboard-agent 用于在以下场景中引导建立智能体工作流：启动一个新项目、向现有系统添加一个新的智能体，或从零搭建工作流基础设施。

强制准备

使用前必须调用 /agent-workflow，其中包含工作流原则、反模式以及上下文收集协议（Context Gathering Protocol）。在继续之前需遵循该协议；如果目前尚不存在工作流上下文，则必须先运行 /teach-maestro。

主要能力与使用方式

该技能按步骤引导完成智能体工作流的搭建：

第 1 步：建立约定

工作流约定

提示词格式：分隔符风格（XML 标签 / markdown 标题 / 三连字符）；章节顺序（System → Context → Instructions → Input）；输出格式（带 schema 的 JSON / markdown 模板）。

工具约定

命名：verb_noun / noun.verb / camelCase
描述模板：What → When → When Not → Returns
错误格式：{ code, message, details }

日志

格式：JSON 结构化
必填字段：workflow_id、step、timestamp、level

文件结构

提示词：prompts/workflow-name/v1.md
工具：tools/tool-name.{ext}
配置：config/environment.yaml
测试：tests/workflow-name/

第 2 步：创建初始结构

project/
├── prompts/          # System prompts, versioned
├── tools/            # Tool definitions
├── config/           # Environment-specific configuration
├── tests/            # Golden test sets and evaluation suites
├── logs/             # Runtime logs (gitignored)
└── .maestro.md       # Workflow context

第 3 步：创建首个智能体

系统提示词：带约束的角色定义
2-3 个核心工具：从最小可用工具集开始
输出模式：定义预期输出格式
一个黄金测试：至少一个具有已知良好输出的测试用例
基础错误处理：结构化错误响应
日志：每次运行的结构化日志输出

第 4 步：验证

使用黄金测试用例运行智能体
验证错误处理是否生效（发送错误输入）
验证日志是否捕获了有用的上下文

限制与禁止事项

禁止在未建立约定的情况下开始构建
禁止创建没有描述的工具
禁止跳过黄金测试用例
禁止让初始智能体范围过大（先最小化，之后再扩展）

暂未提供的信息

该技能的收费、价格、平台支持、具体效果等事实在资料中暂未提供。

技能介绍

用途