关于 calibrate
calibrate 是用于统一 AI 工作流组件规范的 Maestro 技能。它检查命名、提示词、错误处理和日志，并指导按优先级修改及测试验证。
主要功能
- 01审查命名规范
- 02检查提示词结构与风格
- 03核对错误处理模式
- 04检查日志一致性
- 05安排修改优先级并验证
适用场景
- 01发现工具名称不一致
- 02统一提示词格式
- 03规范错误响应
- 04检查日志及个人信息脱敏
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/calibrate确认已加载。
详细介绍
强制准备
调用 /agent-workflow — 其中包含工作流原则、反模式和 上下文收集协议。继续之前，请遵循该协议 — 如果尚无工作流上下文，必须先运行 /teach-maestro。 查阅 agent-workflow 技能中的提示词工程参考，确保命名和风格模式一致。
确保所有工作流组件保持一致。不一致会造成困惑 — 无论对模型、开发者还是用户都是如此。
校准维度
命名约定
- 工具名称遵循统一模式（verb_noun、noun.verb 或 camelCase — 选定一种）
- Agent 名称遵循统一模式
- 配置键遵循统一模式
- 文件名遵循统一模式
提示词风格
- 所有提示词采用相同的结构模式（4 区域）
- 分隔符风格一致（XML 标签、Markdown 标题、三连横线）
- 输出架构格式一致（JSON 架构、Markdown 模板）
- 指令风格一致（祈使句、编号步骤）
错误处理
- 所有工具以相同格式返回错误
- 错误代码遵循统一方案
- 错误消息的语气保持一致
- 重试逻辑采用统一策略
日志记录
- 所有日志采用相同格式（JSON 结构化、文本等）
- 所有日志条目的字段名称保持一致
- 日志级别保持一致（debug、info、warn、error）
- PII 脱敏方式保持一致
校准流程
- 确定标准：现有代码库中最常见的模式是什么？这就是标准。
- 列出偏差：找出所有偏离标准的组件。
- 确定优先级：优先修复影响最大的偏差（面向用户的 > 内部的）。
- 应用更改：进行更改，并确保测试仍然通过。
- 记录文档：更新
.maestro.md，记录已确立的约定。
一致性审计表
| 维度 | 标准 | 发现的偏差 | 优先级 |
|---|---|---|---|
| 工具命名 | ? | ? 个工具中的 ? 个 | 高/中/低 |
| 提示词结构 | ? | ? 个提示词中的 ? 个 | 高/中/低 |
| 错误格式 | ? | ? 个工具中的 ? 个 | 高/中/低 |
| 日志格式 | ? | ? 条日志中的 ? 条 | 高/中/低 |
校准检查清单
- 已确定每个维度的约定标准
- 已列出所有偏差及其位置
- 已优先修复影响最大的偏差
- 每次校准更改后测试均通过
- 已在
.maestro.md中更新已确立的约定
建议的下一步
校准后，运行 /refine 进行最终润色，或运行 /evaluate 验证一致性改进。
绝不：
- 在现有约定可行时另创约定
- 以改变行为的方式进行校准（这是标准化，而非重构）
- 跳过校准后的测试验证
- 更改命名约定却不更新所有引用
评论
支持 Markdown