SKILLπ JOURNAL ↗ 工作流

让 Agent 找到、调用并管理技能:用报名表跑通三步

从查找候选、拆分任务到管理版本,用图书馆报名表验收 Agent 的技能调用。

社区图书馆每月收到三家分馆的活动报名表。馆员想让 Agent 把报名合并、找出重复项,再生成交接说明。第一次不要开放共享盘写权限,也不必先安装一整套扩展。拿三份合成表试跑,留下三样东西:带理由的技能候选表、可以单独验收的任务分工表,以及记录安装版本和停用方法的清单。

把需求写成可搜索的操作

先列出输入、输出和不许做的动作。输入是三个 CSV,交付是新建的合并表和一份异常清单;原文件只读,号码或邮件地址不出测试目录,疑似重复只能标记。把「找一个图书馆助手」改成三条搜索意图:合并异构表头、比较重复记录、从结果生成说明。技能如果只支持电子表格界面,而运行环境是无图形界面的机器,就记为不匹配。

发现候选时可选择单目录检索或跨目录比较。单目录适合已有批准来源的团队,输出应包括准确名称、发布者、上游地址、版本和适用输入;跨目录用于比较不同实现,要检查两个同名条目是不是指向同一份代码。按是否能处理样例、是否要联网、是否能限制写入路径做对照。对每个候选写一句淘汰理由,如「需要把完整表发送到远程服务」;排名和下载量只用来决定阅读顺序。

把自动发现与安装拆开配置。让发现步骤返回建议及证据,安装步骤只接受已批准的来源和版本。查看候选说明及脚本后,用测试工作区安装到宿主支持的目录,再从新会话发起一条极小的任务。记录是否识别技能、是否用了正确输入、有没有尝试访问其他路径。若技能只能在手动点名时被发现,先把这个限制写入运行说明,安排手动调用。

先拆工作,再决定谁执行

这项任务可以分为四步:检查字段、统一表头、生成冲突清单、写交接说明。检查字段时交付源列到标准列的映射和无法识别的列;统一表头时交付全新文件和逐表行数;生成冲突清单时保留两边的来源行号;写说明时只读取汇总数字和待人工处理的条目。最后一环不得从姓名或联系方式猜测身份。

如果只需要排计划,要求 Agent 输出步骤表,逐项注明输入、产物、能力缺口、失败时的去向和人工批准点,输出后停止。若还要委派执行,让每个执行单元只读自己所需的文件,输出写到不同的临时路径。先分别检查各分馆的字段,这三项可以并行;拿到三份映射后再合并。去重和交接说明依赖合并结果,要等行数对账通过。让协调者统一检查结果,不允许多个执行单元覆盖同一个文件。

用明确的验收数字代替「看起来差不多」。例如三份样例各十二行,合并层必须能交代三十六行的来源。构造两条活动编号相同、报名人编号不同的记录,检查它们没有被当作重复;再构造一对分隔符不同、但标准编号相同的记录,检查它们出现在待核对表。第二次运行应得到同一批冲突;如果多了一份重复导出,先查写入是否使用了追加模式。

整理已有技能和依赖

做一份安装台账:宿主名称、扫描目录、技能标识、来源、已装版本、可用更新、依赖、最近一次验收结果。同名技能出现在个人目录和工作区目录时,分别记下路径,用新会话确认实际加载的是哪一份。不要按文件名批量删除。可以先在宿主里停用一份,再运行依赖它的任务;台账写清恢复位置和验证步骤。

补充互补技能时,先定位失败属于哪一环。例如导出页面的按钮偶尔无响应,合并技能本身运行正常。若这个页面是获准测试的 Web 应用,可以在导出验收环节使用关联的 Webapp Testing:输入测试地址、虚构报名数据和预期文件名,检查点击后是否真的下载,记录失败截图和复现路径。若三份表来自手工邮件附件,这个测试技能就没有用处。为每个补充项记录它解决的错误,并用一条失败样例确认加入后确有帮助。

更新前保存旧版本和配置,先在测试工作区换一个技能。用同一批数据对比行数、异常条目、输出位置和外部访问情况,再决定是否扩大。若新版把冲突项直接删除,回退旧版本,保留新版和旧版的差异记录,并给运行说明补上「重复项只能列出」的要求。对于依赖命令行的发现或安装工具,版本号、可执行文件位置和宿主实际使用的环境都应记录,否则机器上能运行的命令未必能在 Agent 里找到。

一次从发现到回退的练习

把样例目录分成输入、输出和日志。第一轮只让 Agent 提出候选。第二轮批准表处理能力,要求先列字段映射,待馆员指出「联系电话」与「家长联系电话」不能混用,再合并。第三轮故意把一份样例的编码改成运行环境不支持的格式;预期是指出文件名并停止合并,原始输入不改写,其他两份映射仍可用于重跑。记录每轮的输入编号、选择的能力、结果和人工接手的原因。下一位馆员照记录复现后,才把流程接到月度任务。

常见问题

已经安装了,为什么 Agent 不自动调用?

依次确认当前工作区能否看到它、说明里的用途是否与任务用词相近、运行前提是否满足。先明确点名做一次只读测试。如果点名能用、自然描述不能用,检查宿主的触发机制和技能描述;如果点名也失败,先查加载目录和运行日志。不要把不同宿主的安装目录或自动发现能力想成通用配置。

Skill 和 MCP 怎样分工?

技能可以规定用什么顺序做字段核对、何时要停下来交给人。MCP 工具则可能提供读取某个数据源或操作外部系统的接口。装了说明并不代表接通了接口;接口能写入也不代表这个步骤允许写入。分别验收流程条件和工具权限,先用只读或测试资源跑通。

是否要联网、付费或填写密钥?

查运行步骤中是否调用外部服务,区分安装依赖、查询目录和处理业务数据三个时点。先用合成数据试跑,核对费用来源、连接目标和最小权限。如果本地文件就能完成合并,保留纯本地的路径;确实需要外部查询时,单独配置受限凭据,并在日志中只记录授权范围和错误类型。

批量更新后多个工作流同时失败怎么办?

先停止调度并保留原始结果,按台账找这次同时变更的版本与依赖。先恢复一个已知正常版本,在隔离目录重放同一份样例,确认字段、异常数和输出路径,再逐个恢复调度。恢复后把触发失败的样例留下,作为下次更新前的验收输入。

分享文章X ↗LinkedIn ↗

CONTINUE YOUR WORKFLOW

把这篇教程,用到下一项任务。

按明确的技能关联与共同专题推荐;使用条件以详情和原始来源为准。