知识库 > TS-SKILL > SKILL.MD编写规范

Demo2:一个取数的SKILL功能说明示例:tinysoft-股票盈利收益率    

  • 当我们实现了这样了个SKILL:输入股票代码,日期,获取这些股票代码在这一天的盈利收益率。

    我们可以这样编写它的SKILL说明:
    一般以md文档格式提供,.md文件可下载:附件:SKILL.md

    name: tinysoft-getey
    description: 调用天软TS-opi平台 GetEY 函数,计算股票的盈利收益率(Earnings Yield,即 E/P 值,是市盈率的倒数)。用于估值分析、股债收益率对比、价值投资筛选等场景。当用户询问某只股票的E/P值、盈利收益率、EP,或进行价值股筛选时使用。

    天软股票盈利收益率查询
    调用天软 TSL 平台`GetEY`函数,返回指定股票截止某日的盈利收益率。
    可用函数
    GetEY - 获取E/P指标
    参数说明
    参数类型说明示例
    stockidstring股票代码(带市场前缀)"SH600000" "SZ000001"
    endtfloat/intTdatetime46114.0(=2026-04-02)

    返回字段
     股票名称 (string)
     E/P值 (float)

    调用配置
    需要知道以下正确信息才能正确调用工具:
    URL: https://opi.tinysoft.com.cn/Service/Session/Call/GetEY
    认证方式: Bearer Token (TOKEN从使用者处获取)
    必须HTTP头: 'Content-Type': 'application/json','JSON-Encode': 'gbk'
    请求体结构:[股票代码,截止日期]
     -请求方式:POST

    使用说明
    当用户请求查询E/P值或盈利收益率时,你必须按以下流程执行:
    1.识别输入:从用户信息中提取股票代码和截止日期
      股票代码需补齐交易所前缀(深市'SZ',沪市'SH')
      若用户只给数字,如果以600、688开头,如‘600000’则自动添加‘SH’,如果以300、000开头,如‘000002’则自动添加‘SZ’
    2.转换日期:将用户提供的日期字符串转化为Tdatetime。
    3.调用工具:'python':用于发送HTTPS请求,参数:["股票代码", 截止日期]
    4.处理返回:工具返回包含股票名称和E/P值结果
      若返回值为空或错误,向用户说明可能原因
    5.呈现结果:格式化输出返回字段

    多股票查询
    若用户一次请求多只股票(如查询平安银行、招商银行在2026年3月27日的E/P),你应该:
     分别对每只股票调用‘GetEY’
     最后汇总展示结果表格

    注意事项
    -股票代码前缀不可省略:如‘SH600000’和‘600000’是不同的,缺少前缀会查询失败
    -依赖工具:本技能非必须使用python,对目标URL进行POST请求即可