SuperAPI AI 工具集

amplifier-tool-leverage-patterns

智能体与模型

查看项目

更新于 10-16 09:32

技能介绍

用途:当已用 Amplifier 构建工作流/自动化工具,而不同消费者希望以不同方式使用(管线组合、代码导入、智能体调用、人类用 CLI),该技能指导如何避免复制四份逻辑。

主要能力:定义四个杠杆层级。L1 为 .dot 吸引子管线,每条命令一个 .dot 加共享子图(folder-shape 节点),运行于 loop-pipeline 引擎,可注册进 Resolve 解析器;平行四边形节点调用工具 CLI,方框节点为完整 LLM 智能体。L2 为 Python 库,各命令为可导入方法,在 init.py 导出明确公共 API。L3 为 Amplifier 工具模块,bundle.md 加 modules/tool-<name>/,把命令暴露为智能体可调用工具,须遵守 mount() Iron Law,阻塞工作经 asyncio.to_thread。L4 为 CLI,基于 click/argparse 的薄封装。

核心规则:逻辑只存一处,各层仅为薄适配器。LLM 逻辑类工具以 .dot 为家;确定性工具以库为家。禁止在 .dot 中重实现核心逻辑,禁止把依赖的私有引擎折入自己的 .dot,应保持公共 CLI/子进程边界。跨仓复用时,重/有状态/LLM 引擎走公共边界,廉价结构性常量可直接导入并加契约测试防漂移;上游声明为 git 依赖,合并顺序先上游后下游。

按需构建:不要默认建齐四层,仅构建真实消费者需要的层级;L4 通常值得。没有消费者即不要建。

限制与不适用:普通库或 CLI 足够且无人组合/嵌入/作为工具调用时,只发 L4(或加 L2)。工具非 Amplifier/LLM 驱动时,这些层级只会徒增依赖,应使用常规打包。MCP/REST 服务与自托管 Web UI 属可选扩展层。相关资料未提供具体收费、平台与效果信息。