SuperAPI AI 工具集

skill-scope

智能体与模型

查看项目

更新于 10-16 09:50

技能介绍

用途:在 skill-creator 真正构建技能之前先确定技能的形态,避免范围不清。采用四个阶段流程:快速通道检查、范围测试、明确结论、交接。

工作流。快速通道检查:若范围已确定,用一句话确认并跳到交接。应用范围测试:只运行与当前情况相符的测试,不必每次全读。陈述结论:只能是 NEW / EXTEND / SPLIT / MERGE 之一,不含糊。交接:带结论和一句话职责说明交给 skill-creator。

第一阶段快速通道。范围已确定的情形:用户消息已指明清晰单一职责和唯一技能名;已明确给出结论;确认过之前范围讨论。此时输出“Scope checks out: — . Handing off to skill-creator.”并直接进入第四阶段,不跑测试。范围未确定的情形:用户直接问应是一个还是两个技能;描述了一个工作流但没确认它是技能;提到某个可能已覆盖该工作的现有技能;提议的技能职责与多个现有技能重叠。此时进入第二阶段。

第二阶段范围测试,只应用相关测试,每项为是/否问题并给出后果,回答中标注测试编号。测试1 原子职责:是否只有一个逻辑职责,即使含多步骤。原子不等于一步,多阶段技能是正常的;真正的检验是拆分后各片段是否共享状态(目标、历史、中间产物),共享状态则保持在一起,无共享则是拆分候选。测试2 触发时机:所有部分是否由同一用户意图触发;技能靠描述匹配调用,若不同意图触发(如“起草 PRD”与“评审 PRD”),需要分开描述乃至分开技能。测试3 与现有重叠:现有技能是否已覆盖该职责或部分职责;新技能会永久占用每次会话的描述 token,默认扩展已有技能,除非职责确实不同、触发短语不重叠、现有技能主体需大幅增长才能吸收。测试4 现有技能范围漂移:现有技能是否已超出单一职责,症状包括描述中出现多个无关触发短语簇、主体章节互不引用、可给技能起两个自然名字;若是则为 SPLIT。测试5 职责重复:两个技能是否从不同角度服务同一职责,症状包括触发短语重叠造成选择困难、用户互换使用、两个主体重复同一领域内容;若是则为 MERGE,但不同触发短语通常意味着不同意图,除非重叠明确否则不动。

第三阶段陈述结论,只能选一个:NEW(测试1-3 通过,职责与现有均不同)、EXTEND(测试3 触发,工作适合放入现有技能)、SPLIT(测试4 触发,现有技能已漂移超出单一职责)、MERGE(测试5 触发,两个现有技能覆盖同一职责)。格式为:Verdict、Responsibility(一句话)、Name(s)、Reasoning(哪些测试触发)。若无法选出唯一结论,即是信号:向用户提出,不要交接,范围尚未确定。

第四阶段交接。NEW:带结论块调用 skill-creator,范围完成,由其构建。EXTEND:指出目标技能和建议新增内容,交给 skill-creator 的更新路径。SPLIT:在重构前为每个结果技能写一行职责说明,逐个交接。MERGE:为合并技能写单一职责说明并列出要合并的触发短语,按对存活技能的 EXTEND 处理并删除另一个。

反模式:一步一个技能(原子指职责非步骤数);过早拆分(共享状态就保持在一起,技能间别扭地传状态比更长的技能更糟);该扩展却新建(新技能会永久占用每次会话 token,扩展成本低);为整洁而合并(不同触发短语通常服务不同意图,除非重叠具体);重提已定范围(用户已给出结论时第一阶段即退出,不要为走流程跑测试);含糊结论(“大概是新技能,也许是扩展”不是结论,应向用户暴露歧义)。