---
name: {{skill-name}}
description: >
  Use when {{一句话说明触发场景，写明知识网络 ID}}.
metadata:
  bkn_scope: {{kn_id}}
  uses:
    - type: metric
      name: {{指标名称}}
      purpose: {{这个指标在流程里起什么作用}}
    - type: function
      name: {{函数名称}}
      purpose: {{这个函数算什么}}
    - type: action
      name: {{行动名称}}
      purpose: {{这个行动做什么}}
      confirm: true
---

# {{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`，`time.instant=true`；需拆维度时加 `analysis_dimensions` | `datas[0].values[0]` | 否 |
| {{函数名称}} | 函数 | {{用途}} | `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`