Background Agents 是一个用于配置和运行后台智能体（background agents）的技能。其目标是把请求的工作通过选定的配置档案（profile）执行，验证远程结果，并返回带运行引用的可用结果。
用途与核心概念 该技能强调四个相互独立的选项：执行后端（默认 Trigger.dev）、智能体引擎（例如 Pi）、模型提供方以及具体模型。修改其中一项不会自动改变其他项。配置档案用于选择已部署的任务，但不会安装新引擎，也不会为引擎授予工具。
选择配置 配置来源优先级为：用户显式提供的配置，其次是 BACKGROUND_AGENT_PROFILES，最后是工作项目中的 agents.profiles.json。技能要求不要搜索无关项目，也不要复用记忆中的账户或项目标识。创建、扩展或解析配置档案时需阅读 references/profiles.md；可以复制 assets/profiles.example.json 作为起点，其中仅含环境引用，不含可用的部署标识。
辅助脚本 标准库辅助脚本可在不执行任务的情况下列出和解析配置档案：
python3 scripts/profiles.py --config agents.profiles.json list python3 scripts/profiles.py --config agents.profiles.json validate python3 scripts/profiles.py --config agents.profiles.json resolve pi-openrouter
辅助命令需在技能文件夹内运行，或使用辅助脚本的解析路径与项目配置路径。显式指定的档案优先于 defaultProfile。未设置的引用、未知档案、已禁用档案以及继承循环都会中止解析。未指定后端时解析为 Trigger.dev；显式选择其他后端时不得静默回退到 Trigger.dev。
执行前确认部署契约 执行前需检查所选后端的任务元数据或实现：匹配项目、环境、任务、预期输入/输出与可用工具；当档案指定引擎/提供方/模型时进行核实（档案中的模型标签是预期而非通用覆盖）；检查实际并发、时长与重试设置；Trigger.dev 开发运行使用本地 worker，云端执行需要已部署的 production、staging 或 preview worker，并保持环境显式；区分每次运行的新会话与持久对话状态。若任务缺少所需能力，应使用已部署的兼容档案或在用户范围内实现缺失能力。
执行与验证 对于 Cloudflare Workers/Workflows，需阅读 references/cloudflare.md。优先使用支持所选档案和所需操作的后端 MCP 工具；对于 Trigger.dev，CLI 作为回退，示例命令：
npx trigger.dev@latest tasks trigger "$TASK_ID"
--project-ref "$PROJECT_REF" --env "$ENVIRONMENT"
--payload-file payload.json --idempotency-key "$REQUEST_ID"
--wait --timeout "$TIMEOUT_SECONDS"
每个任务应有边界明确的载荷和基于操作与规范输入的稳定请求标识；结果不确定时可复用该标识，输入变化则需新标识。需遵守共享提供方配额与任务并发限制。保留回执（档案、环境、任务、请求标识、运行 ID/状态与结果处置），私密载荷和凭证不得出现在通用回执中。提交或部署不等于任务完成，需检查最终状态和输出；超时后应先核对现有运行再提交新任务。失败时先修复已证实的原因再做有限重试，重复失败需凭证、能力或外部变更时应停止并报告。不要在 Promise.all 中包裹 Trigger.dev 的 wait.*、triggerAndWait 或 batchTriggerAndWait。
处理结果 按任务实际 schema 和用户验收标准校验输出。进行来源审查或信息补充时，分派前后需阅读 references/evidence-review.md，并区分未知、提议、已接受与已验证的结果。仅导入预期的已验证结果；报告中说明完成/失败/待处理覆盖、有用结果、未解决缺口与远程运行链接，并说明使用的是已保存证据还是新外部研究。
凭证与可移植性 共享技能与示例档案不含凭证、账户/项目 ID、运行引用、私有数据集或绝对机器路径。凭证环境变量名可出现在档案中，但值应存放于所选后端的密钥存储；不得将凭证引用解析进载荷、命令参数、档案输出或回执。创建该技能不授权无关部署、凭证更改或数据写入。官方参考为 Trigger.dev 的任务、环境与环境变量文档。