SuperAPI AI 工具集

factory-files

通用与其它

查看项目

更新于 10-16 07:17

技能介绍

用途:本技能面向仓库中的 Warp 软件工厂文件,负责编写与编辑这些定义,并在提交拉取请求前进行校验。它不用于操作运行中的工厂(那应使用 factory-mcp 发送任务、查看任务状态或拉取任务);工厂自身 skills/ 目录下的 playbook 属于提示词修改,不适用本技能的 schema 规则。

工厂根目录:每棵工厂树以包含 factory.yaml 的目录为根,以下路径均相对于该根。仓库可能把子目录注册为根,因此要查找 factory.yaml 而非假定仓库根。查找时不要跟随符号链接。若无 factory.yaml,则不是工厂树,本技能不适用。文件结构包括必填且唯一的 factory.yaml、至少一个 agents/<name>/agent.md(其中一个必须为 MAIN)、可选的 automations/<name>/automation.md、runners/<name>.yaml、scorers/<name>/scorer.md,以及 skills/**。资源名称来自路径而非文件内的字段。

编辑前:先读取要改的文件和 factory.yaml,了解继承与覆盖关系;保留未被要求修改的字段与 Markdown 正文(Agent/Automation 的正文是提示词,Scorer 的正文是评分标准),不要并入 frontmatter;尽量做最小修改。

按服务器 schema 编写:从 factory.yaml 读取 schemaVersion,缺省为 v1alpha1,然后获取该版本的 schema:curl -s https://app.warp.dev/api/v1/factory-files/schemas 以及 curl -s https://app.warp.dev/api/v1/factory-files/schemas/<schemaVersion>。两个接口无需认证。若服务器未发布该版本,应停止,不得降低 schemaVersion 让检查通过。参考 references/examples.md 与 references/scorers.md。

校验:使用 Python 3.8 或更高版本运行:python3 "{{skill_dir}}/scripts/validate_factory_files.py" "<factory-root>"。可用 --json 输出机器可读结果,用 --server-root 或 WARP_SERVER_ROOT 指向其他服务器。退出码含义:0 表示服务器检查通过;1 表示有诊断需修复并重跑;2 表示未检查,既非通过也非失败。切勿暗示发生了未发生的检查。校验不解析服务器状态,模型 ID、环境 ID、密钥名、runner 名、MCP 服务器 ID、集成可用性及 Linear/Slack 名称别名均在应用计划时检查。

易错点:必须有且仅有一个 agent 声明 agentType: MAIN(或 FOREMAN);model 与 harness 互斥;agentDefaults 必须声明其一;在 agent 或 automation 层声明 secrets 或 mcpServers 会替换而非合并继承值;automation 至少需要一个 trigger,每个 trigger 需要 provider 和 event;schedule.cron_fired 需要内联 schedule.cron 或非空 filter.schedule_ids,且不可同时有;Linux runner 需要 platform.linux.dockerImage。不要本地复制 schema 或重新实现部分检查。