SuperAPI AI 工具集

hello-world

通用与其它

查看项目

更新于 10-16 06:37

技能介绍

用途

hello-world 是一个演示型技能(demonstration skill),主要作用是向用户问候,并作为参考示例展示技能系统中可用的全部元素,包括:元数据、指令、工作流、模板、示例、检查清单、条件逻辑、反馈循环、渐进式披露和实用脚本。适用于用户要求问候、想测试技能系统,或请求演示技能用法的场景。

主要能力

  • 根据用户输入确定问候对象:若用户提供了名字则使用该名字,未提供则默认使用 "World"。
  • 根据上下文选择问候风格:
    • formal(正式):用于专业或不确定的语境,示例输出 "Good day, Dr. Smith."
    • casual(随意):用于友好或非正式对话,示例输出 "Hey there, Alice!"
    • festive(节日):用于节假日或庆祝场景,示例输出 "Happy holidays, Bob! 🎉"
  • 生成问候语并返回给用户。
  • 提供校验能力,可在交付前验证生成的问候文本。
  • 提供风格列表查询能力。
  • 支持通过配置文件扩展问候模板与语言。

使用方式

基本流程(Quick Start):

  1. 确定问候目标(用户名或默认 "World")。
  2. 选择问候风格(formal、casual 或 festive)。
  3. 运行:python scripts/hello.py --name <target> --style <style>
  4. 将格式化后的问候语返回给用户。

条件工作流:

  • 判断输入类型:用户提供名字 → 使用该名字;未提供名字 → 默认 "World"。
  • 判断风格:检测到正式关键词(如 "sir"、"madam"、"professional")→ formal;检测到节日关键词(如 "holiday"、"birthday"、"celebrate")→ festive;否则 → casual。

实用脚本 hello.py 的用法:

# 生成问候
python scripts/hello.py --name "Alice" --style casual

# 校验问候
python scripts/hello.py --validate --input "Hey there, Alice!"

# 列出可用风格
python scripts/hello.py --list-styles

反馈循环:先生成问候,随后立即校验 python scripts/hello.py --validate --input "greeting text"。若校验失败,查看错误信息(如缺少名字、输出为空)、修复问题并重新校验,只有校验通过后才交付问候语。

输出模板

# Greeting

**To:** [Target Name]
**Style:** [formal | casual | festive]

---

[Generated Greeting Message]

---

*Generated by hello-world skill*

示例

  • 随意问候:输入 "Say hi to Alice",输出 "Hey there, Alice! 👋 Welcome aboard!"
  • 正式问候:输入 "Please greet Professor Zhang formally",输出 "Good day, Professor Zhang. It is a pleasure to make your acquaintance."
  • 节日问候:输入 "Wish Bob a happy birthday",输出 "Happy Birthday, Bob! 🎂🎉 Wishing you a fantastic year ahead!"

配置

可通过环境变量覆盖默认设置:

变量 默认值 说明
HELLO_DEFAULT_STYLE casual 默认问候风格
HELLO_DEFAULT_NAME World 默认目标名字
HELLO_LOCALE en 问候语言所在区域

资源与扩展

问候模板与区域数据存放于 resources/greetings.json:

  • styles:每种风格包含一组模板,脚本会随机选取一个。
  • locales:按区域键值存放的简单问候模板(en、zh、ja、es、fr、de)。
  • defaults:name、style、locale 的兜底值。

要新增风格或区域,直接编辑 resources/greetings.json 即可,无需改动代码。

更完整的 API 与 CLI 参考见 reference.md,更多使用示例见 examples.md。

适用场景与限制

该技能适合用作技能系统的演示与测试,也适合处理简单的问候生成任务。其能力范围限于问候语的生成与校验,未提供其他功能。关于该技能的收费、价格、平台支持范围等事实,资料中暂未提供。