SuperAPI AI 工具集

auto-trigger

智能体与模型

查看项目

更新于 10-15 14:31

技能介绍

用途

auto-trigger 是 agent-playbook 技能体系中的工作流钩子元数据技能,用于定义技能之间的触发意图(trigger intent)。它本身不直接使用,而是作为一份声明式元数据,描述当某个技能完成其工作流后,宿主运行时或智能体可以读取该元数据、记录一个待执行的后续动作,并仅在该动作被当前会话支持且安全时执行下一个技能。

主要能力

该技能定义了多组钩子(Hook Definitions):

  • PRD 创建链:prd_complete 触发 self-improving-agent(background 模式,条件为 PRD 文件存在且完整)和 session-logger(auto 模式,上下文为“PRD created for {feature_name}”);prd_implemented 触发 session-logger(auto 模式)。
  • 实现链:implementation_complete 触发 code-reviewer(ask_first 模式,提示“Implementation complete. Run code review?”)和 create-pr(ask_first 模式,条件为 user_requested_submission)。
  • 会话管理:session_start 自动触发 session-logger 的 create_session_file 动作;session_end 自动触发 session-logger 的 update_session_file 动作。
  • 错误纠正链:on_error 触发 self-improving-agent(background 模式)和 session-logger(auto 模式)。

使用方式

在技能的 front matter 中添加 hooks 字段即可声明自动触发能力,支持 before_start、after_complete、on_error、on_progress 等钩子位置。每个钩子可指定 trigger(目标技能)、mode(auto / background / ask_first)和 context。

实现指南要求:当技能完成工作流时,先检查其自身 front matter 中的 hooks;对每个钩子,若 mode 为 auto,则仅在宿主运行时支持时记录或运行低风险后续动作;若为 background,则记录非阻塞后续动作,不静默修改持久文件;若为 ask_first,则先询问用户;若存在 condition,则先检查条件;最后将上下文传递给被触发的技能。

文中给出了 prd-planner、self-improving-agent、create-pr 的集成示例,并说明 self-improving-agent 的 Claude 失败钩子由 CLI 适配器安装,而非声明为可移植技能元数据;除非宿主适配器显式实现,否则这些钩子示例仅为声明式意图,其他宿主应使用文档化适配器或手动捕获。

适用场景

适用于 agent-playbook 技能体系内需要串联多个技能的工作流,例如 PRD 创建后自动记录会话、实现完成后询问是否进行代码审查、出错时记录错误并触发自我改进分析等。

限制

该技能明确标注“DO NOT use directly”,不应被直接使用,也不应假设钩子会执行。钩子是否真正执行取决于宿主运行时或适配器是否支持。重要规则包括:不要创建无限循环,确保链条终止;对 PR、部署和持久文件变更等重大操作使用 ask_first;后台任务使用 background 模式;始终传递相关上下文。