Install
openclaw skills install @thcjp/comm-skill-tool-freeopenclaw skills install @thcjp/comm-skill-tool-free沟通助手基础版是 沟通协作 领域的 FREE 版本 AI Skill,专为个人用户与轻量级场景设计。通过自然语言指令驱动 AI Agent 执行任务,提供核心功能与简洁易用的操作体验. FREE 版本与 PRO 版本完全兼容,可在需要时升级至 PRO 版本获取高级功能、批量操作与团队协同能力.
| 维度 | FREE 版本 | PRO 版本 |
|---|---|---|
| 目标用户 | 个人用户 | 企业团队 |
| 功能范围 | 核心功能 | 全部功能 |
| 批量操作 | 不支持 | 支持 |
| 团队协作 | 不支持 | 支持 |
| 技术支持 | 社区支持 | 优先响应 |
| 数据分析 | 基础统计 | 高级分析 |
FREE 版本提供以下能力:
综合对话上下文生成回复草稿
处理: 解析综合对话上下文生成回复草稿的输入参数,完成核心逻辑,生成结构化输出. 输出: 返回综合对话上下文生成回复草稿的响应数据,含执行状态与操作日志.
input_params参数控制执行,支持创建/查询/导出检测情感潜台词与沟通动态
处理: 解析检测情感潜台词与沟通动态的输入参数,完成核心逻辑,生成结构化输出. 输出: 返回检测情感潜台词与沟通动态的响应数据,含执行状态与操作日志.
input_params参数控制执行,支持创建/查询/导出提供多种沟通结构模板(反馈/请求/困难对话)
处理: 解析提供多种沟通结构模板(反馈/请的输入参数,完成核心逻辑,生成结构化输出. 输出: 返回提供多种沟通结构模板(反馈/请的响应数据,含执行状态与操作日志.
input_params参数控制执行,支持创建/查询/导出根据关系与情境调整语气
处理: 解析根据关系与情境调整语气的输入参数,完成核心逻辑,生成结构化输出. 输出: 返回根据关系与情境调整语气的响应数据,含执行状态与操作日志.
input_params参数控制执行,支持创建/查询/导出支持邮件、消息、面对面等多种渠道
处理: 解析支持邮件、消息、面对面等多种渠的输入参数,完成核心逻辑,生成结构化输出. 输出: 返回支持邮件、消息、面对面等多种渠的响应数据,含执行状态与操作日志.
input_params参数控制执行,支持创建/查询/导出本版本提供 5 项核心能力,覆盖 沟通协作 的常见使用场景。如需批量操作、团队协作、数据分析等高级功能,可升级至 PRO 版本. FREE 版本核心功能清单:
PRO 版本扩展功能预览:
处理: 解析功能详情的输入参数,完成核心逻辑,生成结构化输出.
输出: 返回功能详情的响应数据,含执行状态与操作日志.
技术参数:使用input_params和output_format参数控制执行行为,支持json/text/csv输出格式.
能力覆盖范围:能力范围包括以下关键词:帮助撰写情境感知、的共情消息、综合对话历史与情、感线索生成回复草、沟通协作领域的专、辅助工具、提供核心基础功能等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.
为敏感话题生成结构化的沟通草稿
用户可通过自然语言指令触发此场景,工具将自动执行相应操作并返回结构化结果.
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 沟通助手基础版处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
输入: "需要告诉团队项目延期"
输出: Acknowledge-Bridge-Guide 结构草稿
1. 理解团队感受
2. 桥接共同目标
3. 引导前进方向
根据上下文生成专业且共情的回复
输入: 客户投诉邮件
输出: 共情确认 -> 问题说明 -> 解决方案 -> 后续跟进
确保已安装并配置好 AI Agent 环境( Code / Cursor / Codex / CLI 等),本 Skill 通过 SKILL.md 指令驱动 Agent 执行任务. 系统要求:
{
"framework": "acknowledge-bridge-guide",
"tone": "warm-direct",
"channel": "email",
"relationship": "colleague"
}
配置完成后,可通过以下方式验证是否正常工作:
# 验证环境变量是否设置
echo "配置检查:"
env | grep -E "API|KEY|TOKEN|SECRET" | sed "s/=.*/=***/" # Linux/macOS
# 或 PowerShell
# Get-ChildItem Env: | Where-Object {$_.Name -match "API|KEY|TOKEN"} | Format-Table
在 AI Agent 对话中描述你的需求,Agent 会根据本 Skill 的指令自动执行对应操作.
请帮我撰写困难对话消息
Agent 将自动:
{
"framework": "acknowledge-bridge-guide",
"tone": "warm-direct",
"channel": "email",
"relationship": "colleague"
}
{
"edition": "free",
"auto_retry": false,
"max_concurrent": 1,
"log_level": "info",
"cache_enabled": true,
"timeout": 30
}
FREE 配置项说明:
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| auto_retry | bool | false | 失败后自动重试 |
| max_concurrent | int | 1 | 最大并发数(FREE 限制为1) |
| log_level | string | info | 日志级别 |
| cache_enabled | bool | true | 启用结果缓存 |
| timeout | int | 30 | 操作超时时间(秒) |
A: 参考差异化对比章节,本技能在自动化程度、错误处理和安全合规方面有针对性优化。
A: 基础功能免费。高级能力(标注付费版专享)需要订阅,详见付费版专享能力表格。
A: 检查输入是否有效,确认参数值不为空字符串。参考边界条件章节了解输入要求。
A: 在Agent平台对话中描述遇到的问题,附上错误信息和输入参数,便于快速定位。
A: 减少输入数据量,缩短prompt长度。网络延迟较大时检查API端点区域,选择就近节点.
{
"success": true,
"data": {
"result": "沟通助手基础版处理结果",
"execution_time": "0.5s",
"metadata": {
"version": "1.0",
"processor": "comm skill"
}
},
"execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
"error": null
}
| 风险类型 | 防范措施 |
|---|---|
| API密钥泄露 | 使用环境变量注入,不得在源码中明文写入 |
| 命令执行风险 | 只运行安全清单内命令,禁止拼接用户输入 |
| 网络通信安全 | 采用HTTPS加密传输并校验证书 |
| 敏感数据暴露 | 结果中排除密钥类数据 |
使用前请确认已阅读依赖说明章节,确保运行环境满足安全要求。
| 操作场景 | 手动耗时 | 自动化耗时 | 效率提升 |
|---|---|---|---|
| 文件解析与提取 | 5-10分钟/个 | <5秒/个 | 60-120x |
| 批量文件处理(100个) | 8-16小时 | <5分钟 | 96-192x |
| API调用与响应解析 | 2-3分钟/次 | <1秒/次 | 120-180x |
| 多接口数据聚合 | 15-30分钟 | <10秒 | 90-180x |
| 命令执行与结果收集 | 3-5分钟/次 | <2秒/次 | 90-150x |
| 重复任务批量执行 | 因任务而异 | 线性缩减 | 5-50x |
| 错误排查与修复 | 10-30分钟 | <30秒 | 20-60x |
| 对比维度 | 沟通助手基础版 | 传统手动方式 | 通用脚沟通助手基础版 |
|---|---|---|---|
| 自动化程度 | 全流程自动 | 完全手动 | 部分自动 |
| 错误处理 | 内置错误恢复 | 依赖人工经验 | 基本try-catch |
| 可复用性 | 参数化配置 | 一次性脚本 | 模板化 |
| 安全合规 | 内置安全检查 | 无安全保障 | 无安全保障 |
| 适用场景 | 帮助撰写情境感知的共情消息,综合对话历史与情感线索生成回复草稿。核心能力: 沟通 | 通用场景 | 通用场景 |
| 风险维度 | 危险级别 | 防御措施 | 评估方式 |
|---|---|---|---|
| 模型输出不可控 | 高 | 输出过滤,安全护栏 | 红队对抗测试 |
| 提示词注入 | 高 | 输入净化,指令隔离 | 注入攻击测试 |
| 数据投毒 | 中 | 数据来源验证,异常检测 | 数据质量审计 |
| 资源耗尽 | 低 | 请求配额,超时控制 | 负载测试验证 |
针对沟通助手基础版使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |