SuperAPI AI 工具集

factory-files

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:本技能用于编写和编辑基于文件的 Warp 软件工厂定义,即在以 factory.yaml 为根的仓库树中创建、修改这些定义文件,并在提交拉取请求前进行校验。它针对的是仓库文件,而不是操作运行中的工厂;若需向工厂派发任务、查看任务状态或将任务拉取到本地,应使用 factory-mcp。工厂自身 skills/ 目录下的 playbook 属于提示词内容,改动它们是提示变更而非模式变更,本技能规则不适用于其内容。

目录结构:每个工厂树以包含 factory.yaml 的目录为根,下列路径均相对该根。仓库可能注册子目录为根,因此应查找 factory.yaml 而非假定仓库根。查找时不要跟随符号链接。必备项为 factory.yaml(恰好一个),以及 agents/<name>/agent.md(至少一个,且恰好一个声明 MAIN)。可选包括 agents/<name>/skills/、automations/<name>/automation.md、runners/<name>.yaml、scorers/<name>/scorer.md、skills/。资源名来自路径而非文件内字段。automations/<name>.md 是解析器仍接受的旧扁平形式。

编辑前应阅读将要修改的文件及 factory.yaml,保留未被要求更改的字段与 Markdown 正文,尽量做最小改动。

按服务器 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 以通过检查。

提交 PR 前校验:使用 Python 3.8 或更高版本运行:python3 "{{skill_dir}}/scripts/validate_factory_files.py" "<factory-root>",两个路径加引号。可加 --json 获得机器可读输出,加 --server-root <url> 或 WARP_SERVER_ROOT 指向本地、暂存或自托管服务器。退出码 0 表示服务器检查未发现问题;1 表示服务器报告诊断问题,须修复并重跑;2 表示该树未被检查,并不代表通过或失败。退出码为 2 时应明确说明校验未运行及原因,不要称文件有效或就绪;退出码为 0 时复述校验器打印的语句,不要夸大。校验不解析服务器状态,模型 ID、环境 ID、密钥名、runner 名、Scorer 模型 ID、MCP 服务器 ID、集成可用性及 Linear 和 Slack 名称别名等均在应用计划时检查。若无 Python 3 解释器,不要自行安装,应手动对照 schema 检查并报告自动校验不可用。

易错规则:恰好一个代理声明 agentType: MAIN(或规范拼写 FOREMAN);model 与 harness 处处互斥,model: <id> 是 Oz harness 的简写;agentDefaults 必须声明其一;在代理或自动化层级声明 secrets 或 mcpServers 会替换继承值而非合并;自动化至少需要一个触发器,每个触发器需 provider 和 event;schedule.cron_fired 触发器需要内联 schedule.cron 或非空 filter.schedule_ids 且不能同时;Linux runner 需要 platform.linux.dockerImage;触发器过滤键取决于 (provider, event) 对,部分字段有更友好的编写拼写,服务器会重写,同时声明会报错。不要添加本地格式副本,应在需要时获取格式,无法获取时如实说明。