onboard-agent

强制准备

调用 /agent-workflow——其中包含工作流原则、反模式和 上下文收集协议。继续之前请遵循该协议——如果尚不存在工作流上下文，必须先运行 /teach-maestro。

---

从头开始引导新的 Agent 工作流，或向现有系统添加新的 Agent。

步骤 1：确立约定

## Workflow Conventions
### Prompt Format
- Delimiter style: [XML tags / markdown headers / triple-dash]
- Section order: [System → Context → Instructions → Input]
- Output format: [JSON with schema / markdown template]

### Tool Conventions
- Naming: [verb_noun / noun.verb / camelCase]
- Description template: [What → When → When Not → Returns]
- Error format: [{ code, message, details }]

### Logging
- Format: [JSON structured]
- Required fields: [workflow_id, step, timestamp, level]

### File Structure
- Prompts: [prompts/workflow-name/v1.md]
- Tools: [tools/tool-name.{ext}]
- Config: [config/environment.yaml]
- Tests: [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：创建第一个 Agent

1. 系统提示词：包含约束条件的角色定义
2. 2-3 个核心工具：从满足最低可用需求的工具集开始
3. 输出架构：定义预期的输出格式
4. 一个黄金测试：至少包含一个有已知正确输出的测试用例
5. 基本错误处理：结构化错误响应
6. 日志记录：每次运行都输出结构化日志

步骤 4：验证

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

建议的下一步

完成引导后，运行 /diagnose 进行基线健康检查，然后运行 /fortify 添加生产级错误处理。

切勿：

• 未确立约定就开始构建
• 创建没有描述的工具
• 跳过黄金测试用例
• 让初始 Agent 的范围过大（从最小化开始，之后再逐步扩展）