名称： share_usecase
描述： "将你的 OpenClaw 使用案例分享到 clawusecase.com。分析你最近的工作内容并创建一份提交给社区。"
作者： "Rex 🐧"
版本： "2.0.1"

分享使用案例技能

此技能帮助你将 OpenClaw 的使用案例分享到 clawusecase.com。

何时使用

当用户想要分享他们用 OpenClaw 构建的使用案例时，触发此技能。他们可能会说：
- “/share_usecase”
- “我想分享这个使用案例”
- “让我把这个提交到 clawusecase”
- “分享我刚构建的东西”

重要提示： 当用户选择通过 OAuth 获取署名时，请自动轮询其连接完成状态。不要等用户告诉你他们已经连接——自动检测并继续提交。

实现要求： 你必须主动监控轮询循环，并在检测到连接时立即发送消息。不要在后台静默运行轮询——频繁检查结果，一旦看到成功的凭据就立即响应。用户应在完成 OAuth 后的几秒钟内看到“✅ 已连接为 @用户名！”，无需主动询问。

工作原理

1. 问候与说明

当用户触发 /share_usecase 时，先友好问候：

🐧 分享你的使用案例

你好！clawusecase.com 是一个社区展示平台，OpenClaw 用户在此分享他们的构建成果以激励他人。

让我看看你最近在做什么，并为你草拟一个使用案例...

2. 分析近期上下文

回顾对话历史（最近 50-100 条消息或过去几小时），以了解用户构建了什么。寻找：
- 他们试图解决什么问题
- 使用了哪些工具/集成（GitHub、Stripe、Resend 等）
- 他们如何解决的
- 任何需求或设置步骤

3. 生成使用案例结构

创建一个结构清晰的使用案例，包含以下字段：

必填项：
- title (50-100 字符) - 清晰、描述性的标题，说明构建了什么
- hook (100-200 字符) - 一句话总结，吸引注意力
- problem (200-500 字符) - 解决了什么问题
- solution (300-800 字符) - 如何工作，构建了什么
- category - 选择其一：“生产力”、“开发”、“商业/SaaS”、“家庭自动化”、“社交/内容”、“数据与分析”、“趣味”
- skills (数组) - 使用的工具/技术（例如：["GitHub", "Stripe", "Resend"]）

可选项：
- requirements - 使用此案例需要什么（API 密钥、账户等）

4. 规范化工具/技能

在最终确定之前，使用 normalize-tools.js 规范化工具名称：

node normalize-tools.js "github,stripe api,resend email"

这确保了命名的一致性（例如，“github” → “GitHub”，“stripe api” → “Stripe”）。

5. 展示预览并获取确认

以清晰的格式向用户展示生成的使用案例：

📋 使用案例草稿

标题：专业版订阅的邮件通知
钩子：用户升级时自动发送欢迎邮件

问题：用户订阅专业版计划时没有邮件通知
解决方案：构建了 Resend 集成与 React Email 模板，连接到 Stripe webhooks 以处理订阅事件

类别：商业/SaaS
工具：GitHub, Stripe, Resend
要求：Resend 账户，已配置 Stripe webhooks

你想要：
- 按原样提交
- 编辑任何字段
- 取消

如果他们想编辑，则反复修改直到他们满意。

6. 询问署名方式

一旦他们确认内容，询问署名方式：

你希望为此次提交署名吗？

选项：
1. ✅ 是的，为我署名（连接 Twitter 或 GitHub）
2. 🎭 不，匿名提交

如果你选择署名，你的使用案例上线后会显示你的链接，并在社区中建立个人资料！

如果他们选择署名：

生成 OAuth 链接并发送给他们：

太好了！连接你的账户以获取署名：

🐦 X (Twitter): [初始化 Twitter OAuth 并获取 URL]
😺 GitHub: [初始化 GitHub OAuth 并获取 URL]

点击上面的链接之一进行身份验证。我会在你连接后自动检测并提交！

自动检测连接：

⚠️ 关键：你必须主动监控并实时响应轮询结果。不要在后台运行轮询并等待系统消息。直接检查进程输出并立即响应。

发送 OAuth 链接后，立即开始轮询并监视完成状态：

推荐方法：

cd /path/to/skill
for i in {1..24}; do
  # 尝试获取凭据
  RESULT=$(node get-credential.js --token [oauth_token] 2>&1)

  if echo "$RESULT" | grep -q '"username"'; then
    # 成功！解析凭据
    USERNAME=$(echo "$RESULT" | grep -o '"username":"[^"]*"' | cut -d'"' -f4)
    PLATFORM=$(echo "$RESULT" | grep -o '"platform":"[^"]*"' | cut -d'"' -f4)

    # 立即通知用户（不要等待后台进程！）
    # 在继续之前立即发送此消息
    echo "用户应看到：✅ 已连接为 @$USERNAME！"

    # 存储完整凭据用于提交
    CREDENTIAL="$RESULT"
    break
  fi

  # 尚未就绪，等待 5 秒
  if [ $i -lt 24 ]; then
    sleep 5
  fi
done

# 循环结束后，检查是否获取到凭据
if [ -z "$CREDENTIAL" ]; then
  echo "超时 - 2 分钟内未收到凭据"
fi

关键实现说明：

1. 不要 使用 exec(..., background: true) 进行轮询——你将无法及时看到结果
2. 要 同步运行轮询或立即检查进程输出
3. 立即 在检测到时发送“✅ 已连接为 @用户名！”消息
4. 不要 等待系统消息或后台进程完成
5. 直接从命令输出中解析凭据 JSON

示例流程：
1. 向用户发送 OAuth 链接
2. 立即开始轮询（每 5 秒同步检查一次）
3. 每次迭代： 检查凭据是否存在
4. 找到的瞬间： 发送消息“✅ 已连接为 @用户名！正在提交你的使用案例...”
5. 从凭据 JSON 中提取用户名/平台
6. 继续提交

如果超时（2 分钟）：

⏰ 仍在等待你的连接。请慢慢来——我会再检查 2 分钟！

然后继续轮询另外 24 次尝试。

如果他们选择匿名：

继续进行匿名提交（无作者信息）。

7. 提交到 API

使用 submit.js 向 API 发送 POST 请求：

带署名：

node submit.js \
  --title "专业版订阅的邮件通知" \
  --hook "用户升级时自动发送欢迎邮件" \
  --problem "用户订阅专业版计划时没有邮件通知" \
  --solution "构建了 Resend 集成与 React Email 模板..." \
  --category "商业/SaaS" \
  --skills "GitHub,Stripe,Resend" \
  --requirements "Resend 账户，已配置 Stripe webhooks" \
  --author-username "josephliow" \
  --author-handle "josephliow" \
  --author-platform "twitter" \
  --author-link "https://twitter.com/josephliow"

匿名：

node submit.js \
  --title "专业版订阅的邮件通知" \
  --hook "用户升级时自动发送欢迎邮件" \
  --problem "用户订阅专业版计划时没有邮件通知" \
  --solution "构建了 Resend 集成与 React Email 模板..." \
  --category "商业/SaaS" \
  --skills "GitHub,Stripe,Resend" \
  --requirements "Resend 账户，已配置 Stripe webhooks" \
  --anonymous

8. 确认提交

如果成功，与用户分享链接：

✅ 使用案例提交成功！

在此查看：https://clawusecase.com/cases/email-notifications-for-pro-subscriptions

感谢与社区分享！🎉

错误处理

速率限制

如果收到 429 错误：

⏰ 你已达到提交限制（每天 10 次）。
请明天再试，或如需提交更多请联系支持。

验证错误

如果字段无效（标题太短、解决方案太简略）：

❌ 提交失败：标题必须至少 20 个字符

我们来修复一下。你希望标题是什么？

API 错误

对于其他错误，显示错误信息并提供重试选项。

优质使用案例技巧

帮助用户创建高质量的提交：

好标题：
- ✅ “专业版订阅的邮件通知”
- ❌ “我建的邮件东西”

好钩子：
- ✅ “用户升级时自动发送欢迎邮件”
- ❌ “发送邮件”

好问题：
- ✅ “升级到专业版的用户没有收到确认邮件，导致困惑和支持工单”
- ❌ “没有邮件”

好解决方案：
- ✅ “构建了 Resend 集成与 React Email 模板。设置 Stripe webhooks 以在 subscription.created 事件时触发。模板包含升级详情和后续步骤。”
- ❌ “让它用 Stripe 发邮件”

类别指南

帮助用户选择正确的类别：

• 生产力 - 任务管理、日程安排、提醒、自动化
• 开发 - CI/CD、代码审查、部署、测试
• 商业/SaaS - 客户管理、计费、分析、营销
• 家庭自动化 - 智能家居、物联网、摄像头、传感器
• 社交/内容 - 社交媒体、内容创作、发布
• 数据与分析 - 报告、仪表板、数据处理
• 趣味 - 游戏、实验、创意项目、幽默

速率限制

用户每天最多可提交 10 个 使用案例。API 通过 authorUsername（或匿名用户的 IP）进行跟踪。

如果他们达到限制，建议：
- 等到明天
- 确保每个提交都是独特且有价值的
- 如需更高限制，请联系支持

质量指南

API 有自动质量过滤。提交必须满足：
- 标题：20-200 字符
- 钩子：50-500 字符
- 问题：100-2000 字符
- 解决方案：200-5000 字符
- 至少 1 项技能/工具
- 有效类别

在提交前帮助用户满足这些要求。

示例交互

用户：我刚建了用户订阅时的邮件通知
你：🐧 分享你的使用案例

你好！clawusecase.com 是一个社区展示平台，OpenClaw 用户在此分享他们的构建成果以激励他人。

让我看看你最近在做什么，并为你草拟一个使用案例...

[分析最近的对话]

📋 使用案例草稿

标题：专业版订阅的邮件通知
钩子：用户升级到专业版时自动发送欢迎邮件

问题：升级到专业版的用户没有收到确认邮件，导致困惑和支持工单，询问付款是否成功。

解决方案：构建了 Resend 邮件集成与自定义 React Email 模板。连接到 Stripe webhooks 以监听 subscription.created 事件。欢迎邮件包含升级确认、收据以及访问专业版功能的后续步骤。

类别：商业/SaaS
工具：Stripe, Resend, React, GitHub
要求：Resend 账户，已配置 Stripe webhooks

你想要：
- 按原样提交
- 编辑任何字段
- 取消

用户：看起来完美！
你：太好了！你希望为此次提交署名吗？

选项：
1. ✅ 是的，为我署名（连接 Twitter 或 GitHub）
2. 🎭 不，匿名提交

用户：是的，为我署名
你：太棒了！连接你的账户以获取署名：

🐦 X (Twitter)：https://clawusecase.com/auth/connect?token=abc123&platform=twitter
😺 GitHub：https://clawusecase.com/auth/connect?token=def456&platform=github

点击上面的链接。我会在你连接后自动检测并提交！

[用户点击链接并完成 OAuth]

你：✅ 已连接为 @josephliow！

正在提交你的使用案例...

[检索凭据，提交]

✅ 使用案例提交成功！

在此查看：https://clawusecase.com/cases/email-notifications-for-pro-subscriptions

你的使用案例现已上线供社区查看。感谢分享！🎉

此技能中的文件

• SKILL.md - 本文件（说明）
• submit.js - 向 clawusecase.com API 提交使用案例
• get-credential.js - 认证后从 Convex 检索 OAuth 凭据
• poll-credential.sh - 轮询凭据完成状态的辅助脚本
• normalize-tools.js - 规范化工具/技能名称
• README.md - 用户文档
• config.json - 技能配置

故障排除

“命令未找到：node”
需要 Node.js。安装：brew install node（macOS）或从 nodejs.org 下载

“无法连接到 API”
检查网络连接以及 clawusecase.com 是否可访问。

“未找到 OAuth 令牌”
令牌可能已过期（10 分钟超时）。生成新的 OAuth 链接。