Text Summarizer Skill

功能描述

将长文本自动压缩为简洁摘要，保留核心信息。

输入格式

{ "text": "需要 summarization 的长文本内容", "max_length": 150 // 摘要最大长度 }

输出格式

{ "summary": "生成的文本摘要", "word_count": 实际字数 }

### 步骤4：开发执行脚本 ⭐⭐⭐⭐☆
在scripts/run.sh中实现核心逻辑：

```bash
#!/bin/bash
# 文本摘要技能主执行脚本

# 读取输入数据
read input_json

# 提取文本内容
text=$(echo "$input_json" | jq -r '.text')
max_length=$(echo "$input_json" | jq -r '.max_length')

# 调用摘要API处理文本
summary=$(curl -s -X POST https://api.example.com/summarize \
  -H "Content-Type: application/json" \
  -d '{"text": "'"$text"'", "max_length": '"$max_length"'}' | jq -r '.summary')

# 返回结果
echo '{"summary": "'"$summary"'", "word_count": '${#summary}'}'

步骤5：测试与优化 ⭐⭐⭐⭐☆

使用测试工具验证技能功能：

./tools/skill-tester --skill text-summarizer --input '{"text": "很长的文本内容...", "max_length": 100}'

根据测试结果优化指令描述和脚本逻辑，确保技能稳定可靠。

H2: 技能模块化设计有哪些最佳实践？

松耦合原则

技能设计应遵循"高内聚、低耦合"原则，每个技能专注于单一功能，通过标准化接口与其他技能通信。这种设计使得技能可以独立开发、测试和更新，而不影响其他组件。

参数标准化

定义统一的参数传递格式，建议采用JSON作为标准数据交换格式。例如：

// 标准化输入格式
{
  "action": "execute",
  "parameters": {
    "key1": "value1",
    "key2": "value2"
  },
  "context": {
    "session_id": "unique-id",
    "timestamp": "2023-10-01T12:00:00Z"
  }
}

错误处理机制

完善的错误处理是技能健壮性的关键，应包含：

• 错误类型分类（参数错误、执行错误、网络错误等）
• 错误代码标准化（如1xx:参数错误，2xx:执行错误）
• 详细错误信息和恢复建议

实践技巧：在技能开发初期就建立完善的日志系统，记录输入输出、执行过程和错误信息，便于问题诊断和优化。

H2: 如何实现跨平台技能部署与应用？

技能打包与分发

使用项目提供的打包工具将技能封装为标准格式：

./tools/skill-packager --skill text-summarizer --output text-summarizer-v1.0.skill