skill-id

name	<skill-id>
description	<一句话中文能力说明；写清何时触发、输入输出形态。Agent 路由依赖本字段。>
compatibility	<可选：运行环境、依赖的 MCP/工具、是否需 API Key>
metadata	{"author":"<作者或团队>","version":"0.1.0","schema_version":"1.0","zh_name":"<中文名称> Skill","category":"<如：固收 / 合规 / 投研 / 零售>","scenario_refs":[]}

<中文名称> Skill

命名规范：中文展示名 = 业务名 + Skill（组合包根目录用「Skill 组合包」，见 README.md）。

本文件是 原子 Skill / 叶子 Skill 的标准 SKILL.md 模板。
组合包根目录另见同目录 README.md；子 Skill 复制 _sub_skill_example/。

标识

项目	值
英文名称	<skill-id>
中文名称	<中文名称>
类型	原子 Skill / 组合包子 Skill

基本功能

• <能力 1>
• <能力 2>

业务场景

维度	说明
何时使用	<触发词 / 用户意图>
不适用	<明确边界，避免误路由>
目标用户	<角色>
输入	<文件、JSON、自然语言…>
输出	<Markdown、表格、结构化 JSON…>

何时使用

用户提到：<关键词 1>、<关键词 2> …

输入契约

输入	必填	说明
<param>	是/否	<说明>

输出契约

输出	说明
<产物>	<路径或格式>

步骤（Agent 执行指引）

1. <步骤 1>
2. <步骤 2>
3. <步骤 3>

脚本 / 工具

脚本	用途
scripts/<name>.py	<说明>

python scripts/<name>.py --help

依赖

• MCP：<mcp-name 或无>
• 其他 Skill：<skill-id 或无>
• 环境变量：见 references/config.example.env（如有）

目录约定

<skill-id>/
├── SKILL.md           # 必填（叶子 / 原子）
├── scripts/           # 可选
├── references/        # 可选：schema、样例、配置样例
└── assets/            # 可选：模板、空表