openbkn-ai

skill-name

Use when {{一句话说明触发场景,写明知识网络 ID}}.

openbkn-ai 1,399 139 Updated 2w ago

Resources

1
GitHub

Install

npx skillscat add openbkn-ai/bkn-foundry/skill-name

Install via the SkillsCat registry.

SKILL.md

{{Skill 标题}}

这是一个业务流程编排 Skill。它不自带算法、不写 URL、不带 Token;所有取数与计算都通过当前知识网络已挂载的指标、函数和行动完成。Agent 读完本文后,按「能力依赖」表用平台工具逐步调用即可。

Skill Card

字段 值
bkn_scope {{kn_id}}
trigger {{用户会怎么问,列 2 到 3 种说法}}
优先指标 {{指标名称}}
优先函数 {{函数名称}}
可选行动 {{行动名称}}(须用户确认)
open_parameters {{Agent 必须从用户那里拿到的参数,逐个列出}}

能力依赖

Agent 用 search_capabilities 按名称在本网络内找到函数与 MCP 工具,用 get_kn_detail / get_object_types 找到指标与行动类型。名称与执行工厂、知识网络中的登记完全一致,不要改写。

名称 类型 用途 调用方式 结果怎么读 需确认
{{指标名称}} 指标 {{用途}} query_metric,传已发布 metric_id、version 和 query.time={start,end}(Unix 毫秒);需拆维度时在 query.group_by 中传定义声明的属性引用 entries[].value,结合 model 和 status 解读 否
{{函数名称}} 函数 {{用途}} execute_tool,参数 {{参数名逐个列出,标明必填}} {{关键返回字段与含义}} 否
{{行动名称}} 行动 {{用途}} 先 get_action_info 取参数 schema,再 execute_action {{回执关键字段}} 是

不在依赖表里的能力不要调用;表里的能力若在本网络找不到,如实告知用户「该能力未挂载」,不要换用其他网络或平台级目录里的同名能力。

Agent 执行步骤

  1. 解析需求:{{把用户输入解析成函数需要的参数;文本字段定位用 match,不要用 ==}}。
  2. 确认前置参数:{{哪些参数缺失时必须先问用户,不得默认}}。
  3. 读指标:调用 {{指标名称}},{{怎么用这个数字}}。
  4. 调函数:调用 {{函数名称}},传 {{参数}}。{{什么结果直接给结论并结束}}。
  5. 解释结果:{{结果不理想时怎么拆解、列前几项}}。
  6. 询问是否执行行动:向用户复述{{要执行什么、影响什么}},明确询问。未得到肯定答复不得执行行动。
  7. 执行行动:用户确认后,先 get_action_info 取「{{行动名称}}」的参数,再 execute_action。参数映射:{{函数结果的哪个字段填到行动的哪个参数}}。
  8. 报告:按 references/report-spec.md 输出。行动回执必须标注{{模拟 / 已提交}}。

完成门槛

  1. {{参数已解析且必填项已确认}}。
  2. 指标与函数结果都来自本网络的调用,不在本地重算。
  3. 行动只在用户明确确认后执行。
  4. 任一能力不可用时如实记录 unavailable,不得用估算值替代。

参考

  • references/report-spec.md

Categories