SuperAPI AI 工具集

calibrate

通用与其它

查看项目

更新于 10-15 21:06

技能介绍

用途:当工作流组件不一致、命名约定多样,或新团队成员的工作需要对齐项目标准时使用 calibrate。

必要准备:先调用 /agent-workflow,它包含工作流原则、反模式和 Context Gathering Protocol,须先遵循该协议;若尚无工作流上下文,必须先运行 /teach-maestro。提示词的命名与风格一致性模式可参考 agent-workflow 技能中的 prompt-engineering 参考。

校准维度:命名约定(工具名、代理名、配置键、文件名各选一种统一模式,如 verb_noun、noun.verb 或 camelCase);提示词风格(统一结构模式,如 4-zone,统一分隔符风格,统一输出 schema 格式,统一指令风格);错误处理(统一错误返回格式、错误码方案、错误信息语气、重试策略);日志(统一日志格式、字段名、日志级别、PII 脱敏方式)。

校准流程:识别标准,即现有代码库中最常见的模式;列出所有偏离标准的组件;按影响排序,优先修复影响最大的偏离(面向用户 > 内部);应用改动,确保测试仍通过;在 .maestro.md 中记录已确立的约定。

一致性审计表维度包括工具命名、提示词结构、错误格式、日志格式,各记录标准、发现偏离数与优先级。校准清单包括:为每个维度确定约定标准、列出所有偏离及位置、优先修复高影响偏离、每次校准改动后测试通过、更新 .maestro.md。

推荐下一步:校准后运行 /refine 做最终打磨,或运行 /evaluate 验证一致性改进。禁止事项:在现有约定可用时发明新约定;以改变行为的方式进行校准(这是标准化,不是重构);跳过校准后的测试验证;更改命名约定却不更新所有引用。