Text Polish Skill — 文本润色技能

触发条件

当用户输入一段文字并表达以下意图时必须触发本技能：

• 润色 / 修改 / 改写 / 优化 / 润饰一段文字
• 把这段话改得更好 / 更正式 / 更简洁 / 更温柔
• 帮我 polishing 一下 / 帮我 improve 一下这段文字
• 让这段话听起来更专业 / 更干练 / 更亲切
• 用户粘贴一段文字，并附上润色要求

⚠️ 特别注意： 本技能仅限文本润色场景，不适用于普通问答、闲聊、翻译、摘要总结、续写扩写等任务。如果用户只是问问题或聊天，请不要触发本技能。

输出格式

必须严格按照以下固定格式输出，三个版本顺序不可调换：

【正式书面版】
（润色后的正式书面风格文本，用词严谨、句式规范、逻辑清晰，适合报告、公文、正式场合）

📝 润色思路：
（详细说明：调整了哪些用词、句子结构如何优化、格式做了什么规范、为什么这样改更符合正式书面风格）

【简洁干练版】
（润色后的简洁干练风格文本，言简意赅、重点突出、去除冗余，适合工作沟通、效率场景）

📝 润色思路：
（详细说明：删减了哪些冗余内容、如何提炼核心信息、句式怎样精简、为什么这样改更简洁有力）

【温柔生活化版】
（润色后的温柔生活化风格文本，语气柔和亲切、自然温暖，适合日常交流、朋友聊天）

📝 润色思路：
（详细说明：语气如何变得柔和、用了哪些生活化表达、句式怎样更自然、为什么这样改更亲切）

执行流程

1. 获取 API 凭证

从技能目录下的 .env 文件中读取星火Lite的 API 凭证：

SPARK_API_PASSWORD=your_api_password_here

通过 Read 工具读取技能目录下的 .env 文件来获取凭证。

如果 .env 文件不存在或缺少 SPARK_API_PASSWORD 字段，请友好地告知用户需要先配置 API 密钥（参考下方「用户配置指引」）。

2. 构造提示词并调用星火Lite API

使用 bash 工具调用星火Lite HTTP API（推荐使用 Python）：

请求地址： https://spark-api-open.xf-yun.com/v1/chat/completions

请求方法： POST

请求头：
- Content-Type: application/json
- Authorization: Bearer <SPARK_API_PASSWORD>

请求体：

{
  "model": "lite",
  "messages": [
    {
      "role": "system",
      "content": "你是一个专业的中文文本润色助手。请根据用户输入的原文，输出3个版本的润色结果，每个版本附带详细的润色思路说明。\n\n【正式书面版】用词严谨、句式规范、逻辑清晰，适合报告、公文、正式场合。\n【简洁干练版】言简意赅、重点突出、去除冗余，适合工作沟通、效率场景。\n【温柔生活化版】语气柔和亲切、自然温暖，适合日常交流、朋友聊天。\n\n每个版本的润色思路需要详细说明调整了哪些用词、句式、语气，以及为什么这样改。"
    },
    {
      "role": "user",
      "content": "请润色以下文字：\n\n{{用户输入的原文}}"
    }
  ],
  "max_tokens": 1024,
  "temperature": 0.7
}

Python 调用示例：

import requests, json, os

# 从 .env 读取密码
password = open(os.path.join(os.path.dirname(__file__), '.env')).read().strip().split('=')[1].strip()

url = "https://spark-api-open.xf-yun.com/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {password}"
}

user_text = "要润色的原文"

data = {
    "model": "lite",
    "messages": [
        {
            "role": "system",
            "content": "你是一个专业的中文文本润色助手。请根据用户输入的原文，输出3个版本的润色结果，每个版本附带详细的润色思路说明。\n\n【正式书面版】用词严谨、句式规范、逻辑清晰，适合报告、公文、正式场合。\n【简洁干练版】言简意赅、重点突出、去除冗余，适合工作沟通、效率场景。\n【温柔生活化版】语气柔和亲切、自然温暖，适合日常交流、朋友聊天。\n\n每个版本的润色思路需要详细说明调整了哪些用词、句式、语气，以及为什么这样改。"
        },
        {
            "role": "user",
            "content": f"请润色以下文字：\n\n{user_text}"
        }
    ],
    "max_tokens": 1024,
    "temperature": 0.7
}

response = requests.post(url, headers=headers, json=data, timeout=30)
result = response.json()
polished = result["choices"][0]["message"]["content"]

3. 格式化输出

从 API 响应中提取 result["choices"][0]["message"]["content"]，按照上述「输出格式」呈现给用户。

注意： 如果 API 返回的内容已经包含了标题和格式，直接呈现给用户即可。如果返回的是纯文本，需要按照输出格式模板进行排版。

4. 降级方案（API 调用失败时）

如果星火Lite API 调用失败（网络错误、超时、凭证无效等），由 Loomy 自己进行文本润色，同样按照固定格式输出3个版本和润色思路。

用户配置指引

首次使用前，用户需要完成以下配置：

1. 访问 讯飞星火开放平台 并注册/登录
2. 创建一个应用，进入控制台
3. 前往 控制台对应版本页面，在左侧选择「Spark Lite」
4. 找到 HTTP 服务接口认证信息，复制 APIPassword
5. 在 D:\skill and rag\skill\text-polish-skill\ 目录下创建 .env 文件，写入：
   SPARK_API_PASSWORD=你复制的APIPassword

如果已经配置过 hello-skill，可以直接复用同一个 APIPassword。

润色原则

• 正式书面版： 提升用词正式度，完善句式结构，增强逻辑连贯性，去除口语化表达
• 简洁干练版： 删减冗余修饰，提炼核心信息，缩短句子长度，用短句替代长句
• 温柔生活化版： 使用柔和语气词，加入生活化比喻，降低正式感，增加亲和力
• 润色思路要具体，不要只说"调整了用词"，要说明具体改了哪些词、为什么
• 保留原文的核心信息和意图，不要改变原意

注意事项

• 星火Lite 免费额度无限，QPS 限制为 2，无需担心配额
• 不要将 API 凭证硬编码在 SKILL.md 中，始终从 .env 读取
• 如果用户的原文很短（如一句话），润色思路也要相应地精简，但保持详细说明的要求
• 如果用户的原文很长（如大段文章），润色时抓住核心风格特征，不要逐字逐句分析