SuperAPI AI 工具集

skill-architect

智能体与模型

查看项目

更新于 10-24 16:19

技能介绍

用途

Skill Architect 面向需要创建新的 Agent Skill,或把已有提示词、SOP、操作手册、运行手册、工作流以及重复出现的智能体行为固化为持久 Skill 的场景。它的核心主张是:在写宿主语法之前,先把行为规范定义清楚。

该技能指出的常见问题是开发者直接编写临时提示词字符串或宿主专属配置,未定义清晰行为边界,从而导致触发不准、职责重叠、自由度未校准、缺少可证伪的成功标准。目标状态是:每个被编写的 Skill 在生成任何代码前,先有一份显式契约,定义其单一职责、触发边界、不变量、自由度校准与评估标准。

主要能力

  • 必要性判断:当缺少或不可靠的持久行为涉及专门知识、稳定决策策略、工作流顺序或关卡、重复偏好、确定性机制、工具选择规则、跨工具协作模式之一时,才判定值得创建 Skill;若基础智能体已可靠完成且无新增持久行为,则建议不创建。
  • 通用 Skill 契约:冻结单一职责、正向触发、隐式触发、负向触发、冲突集合、行为前置条件、决策点、证据要求、完成与停止条件、变更边界、能力要求和评估覆盖。
  • 架构选择:先选主控制模式;若包含多个独立职责则拆分为多个 Skill 并定义路由,而非构建单体。
  • 逐行为自由度设定:对每个重要行为记录行为、后果、可逆性、可验证性、自由度与实现形式;低自由度机制用脚本或 schema,中等自由度用决策表或受限伪代码,判断本身是价值所在处用散文式指导。
  • 激活设计:在定稿描述前建立激活样本库,包含 4 至 8 个正向提示、2 至 4 个隐式提示、4 至 8 个邻近负向提示及相邻 Skill 冲突;描述应暴露职责与路由边界,而非工作流顺序。
  • 信息结构设计:常用操作说明保留在 SKILL.md,深度领域材料放入 references/,脆弱且重复的机制放入 scripts/,生成输出资产放入 assets/;读者应能在不加载全部参考的情况下理解控制流。
  • 候选内容编写:使用祈使式指令,解释非显然关卡存在的原因,在风险点放置检查,每个概念只用一个术语,在重要声明或变更前说明证据要求,并明确完成条件;可移植核心中不得包含凭证、私有绝对路径或假定的宿主工具名。
  • 评估蓝图:交付无 Skill 基线用例、激活正例、激活负例、核心行为用例、边界用例、相关压力用例、主机可移植性用例以及关键二元问题,并路由至 skill-evaluator。

使用方式

先从请求或来源材料中提取:重复出现的用户任务、主要用户、真实触发提示、近似负例、期望结果、当前失败或不一致、错误后果、所需工具或数据、目标宿主(如有)。可从材料安全推断的字段不强制用户回答,不确定的假设需标注。随后按步骤依次完成必要性判断、契约创建(参考 ../skill-conductor/references/skill-contract.md)、架构选择(参考 ../skill-conductor/references/patterns.md)、自由度设定、激活设计、信息结构设计、首个候选编写与评估蓝图。

输出与限制

输出应包含:Skill 理由、通用 Skill 契约、架构决策、自由度映射、建议包结构、首个候选 Skill 内容或补丁、评估蓝图、未解决假设。在测试实际运行前,不得报告行为有效性。资料中未提供具体产品价格、平台支持范围或安装命令等信息。