用途
Automation First 是一套用于设计 AI 工作流与技能(skill)的指导原则,适用于当某个工作流要求用户执行复制、编辑、批准、重启、配置、修复或验证等步骤,而这些步骤软件本身可能可以完成时。它的目标是把确定性的机器工作交给自动化,减少人为操作带来的失败点。
核心规则
文档提出的核心规则是:每一个必需的手动步骤都是潜在的失败点。当平台提供安全接口时,应自动化确定性的设置与验证环节。
决策标准
文档给出的判断依据是:当某个操作具备以下条件时应当自动化——
- 确定性(deterministic);
- 范围受限(scoped);
- 可逆或可验证(reversible or verifiable);
- 有 CLI、API 或配置契约支持(supported by a CLI/API/config contract)。
只有真正无法安全自动化的能力,才保留显式的回退方案。
良好自动化的特征
文档列举了良好自动化应具备的要素:
- 检测现有状态;
- 保留用户配置;
- 幂等(idempotent);
- 检查退出码;
- 验证结果;
- 以可操作的失败原因终止。
糟糕的自动化
文档同时指出糟糕自动化的表现:猜测未文档化的模式(schema)、全局禁用安全设置,或用警告掩盖失败。
文档与工程实践
文档强调,说明文档应描述自动化做了什么以及如何恢复,而不是把例行的机器工作重新推回给用户。如果一次全新安装仍然提示“现在请手动编辑或复制这个”,应将其视为工程缺口并优先排查。
适用场景与限制
该原则适用于设计需要用户介入的 AI 工作流、技能或安装流程,帮助判断哪些步骤应被自动化、哪些应保留手动回退。资料未提供具体的实现代码、安装命令、支持平台或收费信息,这些内容暂未提供。