sophhub 0.2.3 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sophhub",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "SophHub CLI - Manage and download AI Agent skills",
   "type": "module",
   "bin": {

package/skills/consensus/skill.json

@@ -0,0 +1,20 @@
+{
+  "name": "consensus",
+  "version": "1.0.0",
+  "types": [
+    "store"
+  ],
+  "displayName": "商务沟通skill",
+  "description": "将零散想法、产品介绍或方案说明，重构成更专业、更清晰、更有对象感的表达",
+  "changelog": [
+    {
+      "version": "1.0.0",
+      "date": "2026-04-14",
+      "changes": [
+        "初次提交"
+      ]
+    }
+  ],
+  "createdAt": "2026-04-14",
+  "updatedAt": "2026-04-14"
+}

package/skills/consensus/src/SKILL.md

@@ -0,0 +1,93 @@
+---
+name: consensus
+description: |
+  将零散想法、内部表述、产品介绍或方案说明，重构成更专业、更清晰、更有对象感的表达。
+  适用于润色表达、专业化改写、名词定义、场景化解释、客户话术、伙伴话术、行业化表达与共识对齐。
+commands:
+  - /consensus rewrite - 将原始表述改写成更专业清晰的版本
+  - /consensus align - 面向客户、伙伴或内部协作做共识对齐
+  - /consensus define - 定义关键名词并澄清概念边界
+metadata:
+  openclaw:
+    emoji: "🤝"
+    requires:
+      bins: []
+      env: []
+---
+
+# Consensus
+
+把用户“已经想明白但还没讲明白”的内容，整理成更专业、更清晰、可复用、面向对象的表达，可直接用于客户沟通、伙伴沟通或内部协作。
+
+## 适用场景
+
+当出现以下需求时，使用这个 skill：
+
+- 用户想把原始表达说得更专业
+- 用户想把内部语言改成客户能听懂的话
+- 用户想定义关键名词或澄清概念边界
+- 用户想把能力翻译成场景、问题和价值
+- 用户想分别产出客户版、伙伴版或内部协作版表达
+
+以下情况不要使用：
+
+- 需要真实行业数据，但上下文没有提供
+- 法律、财务、合规类正式意见
+- 只做轻量语法修正，不涉及结构重写
+
+## 默认工作流
+
+1. 先判断用户真正想表达的核心意图，不要只改字句。
+2. 找出关键名词、黑话和技术词，先定义，再展开。
+3. 把表达从“我们想说什么”改成“对方需要听懂什么”。
+4. 把功能翻译成场景、问题、价值和落地方式。
+5. 根据对象和使用场景，产出可直接复用的话术版本。
+
+优先使用下面这条翻译链路：
+
+`能力或做法 -> 解决的问题 -> 适用场景 -> 业务价值 -> 协作或落地方式`
+
+## 输入处理
+
+输入可以很粗糙，例如一句话、几条关键词、一段内部表述，或一段混乱说明。
+
+默认识别这四件事：
+
+- 核心意图
+- 目标对象
+- 行业或场景
+- 输出用途
+
+如果信息不完整：
+
+- 能安全推断就直接推断，并明确写出假设
+- 不能安全推断时，只追问最关键的一个缺口
+
+## 输出结构
+
+除非用户明确要求极短输出，否则默认按下面顺序组织：
+
+1. 核心表达
+2. 关键名词定义
+3. 场景化解释
+4. 面向对象的话术
+5. 待确认项
+
+## 写作规则
+
+- 先定义，后展开
+- 先场景，后功能
+- 先价值，后细节
+- 少黑话，少空话
+- 不编事实
+- 不把推测写成事实
+- 尽量让结果可以直接发给客户或伙伴
+
+## 最终检查
+
+输出前检查：
+
+- 陌生读者能否快速听懂
+- 关键名词是否已定义
+- 是否完成对象视角和场景视角转换
+- 是否保留了假设和边界

package/skills/deepwiki/skill.json

@@ -0,0 +1,20 @@
+{
+  "name": "deepwiki",
+  "version": "1.0.0",
+  "types": [
+    "store"
+  ],
+  "displayName": "DeepWiki文档助手",
+  "description": "通过 DeepWiki MCP 服务器查询 GitHub 仓库文档和维基，支持搜索仓库维基、获取文档结构以及基于 AI 的仓库相关问题解答",
+  "changelog": [
+    {
+      "version": "1.0.0",
+      "date": "2026-04-14",
+      "changes": [
+        "初次提交"
+      ]
+    }
+  ],
+  "createdAt": "2026-04-14",
+  "updatedAt": "2026-04-14"
+}

package/skills/deepwiki/src/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: deepwiki
+description: Query GitHub repository documentation and wikis using DeepWiki MCP server. Use when the user needs to search repository wikis, get documentation structure, or ask AI-powered questions about GitHub repositories.
+---
+
+# DeepWiki
+
+Use this skill to access documentation for public GitHub repositories via the DeepWiki MCP server. You can search repository wikis, get structure, and ask complex questions grounded in the repository's documentation.
+
+## Commands
+
+### Ask Question
+Ask any question about a GitHub repository and get an AI-powered, context-grounded response.
+```bash
+node ./scripts/deepwiki.js ask <owner/repo> "your question"
+```
+
+### Read Wiki Structure
+Get a list of documentation topics for a GitHub repository.
+```bash
+node ./scripts/deepwiki.js structure <owner/repo>
+```
+
+### Read Wiki Contents
+View documentation about a specific path in a GitHub repository's wiki.
+```bash
+node ./scripts/deepwiki.js contents <owner/repo> <path>
+```
+
+## Examples
+
+**Ask about Devin's MCP usage:**
+```bash
+node ./scripts/deepwiki.js ask cognitionlabs/devin "How do I use MCP?"
+```
+
+**Get the structure for the React docs:**
+```bash
+node ./scripts/deepwiki.js structure facebook/react
+```
+
+## Notes
+- Base Server: `https://mcp.deepwiki.com/mcp`
+- Works for public repositories only.
+- No authentication required.

package/skills/deepwiki/src/_meta.json

@@ -0,0 +1,6 @@
+{
+  "ownerId": "kn7azq5e6sw0fbwwzdpcwvvjzd7z0x4z",
+  "slug": "deepwiki",
+  "version": "1.0.0",
+  "publishedAt": 1768156757977
+}

package/skills/deepwiki/src/scripts/deepwiki.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+const http = require('https');
+
+const args = process.argv.slice(2);
+const command = args[0];
+const repo = args[1];
+const extra = args[2];
+
+if (!command || !repo) {
+  console.log('Usage: deepwiki.js <command> <repo> [args]');
+  console.log('Commands: ask, structure, contents');
+  process.exit(0);
+}
+
+const SSE_URL = 'https://mcp.deepwiki.com/sse';
+
+async function run() {
+  let sessionId = null;
+  let messageUrl = null;
+
+  // 1. Establish SSE connection
+  const sseReq = http.get(SSE_URL, (res) => {
+    let buffer = '';
+    res.on('data', (chunk) => {
+      buffer += chunk.toString();
+      
+      // Parse SSE events
+      const lines = buffer.split('\n');
+      buffer = lines.pop(); // Keep incomplete line
+
+      let currentEvent = null;
+      for (const line of lines) {
+        if (line.startsWith('event: ')) {
+          currentEvent = line.substring(7).trim();
+        } else if (line.startsWith('data: ')) {
+          const data = line.substring(6).trim();
+          
+          if (currentEvent === 'endpoint') {
+            messageUrl = 'https://mcp.deepwiki.com' + data;
+            const url = new URL(messageUrl);
+            sessionId = url.searchParams.get('sessionId');
+            
+            // Now that we have the session, send the tool call
+            sendToolCall(messageUrl);
+          } else if (currentEvent === 'message') {
+            try {
+              const msg = JSON.parse(data);
+              // Check if this is the response to our request (id: 1)
+              if (msg.id === 1) {
+                if (msg.error) {
+                  console.error('Error:', msg.error.message);
+                } else {
+                  handleResult(msg.result);
+                }
+                sseReq.destroy();
+                process.exit(0);
+              }
+            } catch (e) {
+              // Ignore non-JSON or other messages
+            }
+          }
+        } else if (line === '') {
+          currentEvent = null;
+        }
+      }
+    });
+  });
+
+  sseReq.on('error', (err) => {
+    console.error('SSE Error:', err.message);
+    process.exit(1);
+  });
+
+  // Timeout after 30s
+  setTimeout(() => {
+    console.error('Request timed out');
+    sseReq.destroy();
+    process.exit(1);
+  }, 30000);
+}
+
+function sendToolCall(url) {
+  let name, params;
+  if (command === 'ask') {
+    name = 'ask_question';
+    params = { repoName: repo, question: extra };
+  } else if (command === 'structure') {
+    name = 'read_wiki_structure';
+    params = { repoName: repo };
+  } else if (command === 'contents') {
+    name = 'read_wiki_contents';
+    params = { repoName: repo, path: extra };
+  }
+
+  const body = JSON.stringify({
+    jsonrpc: '2.0',
+    id: 1,
+    method: 'tools/call',
+    params: {
+      name,
+      arguments: params
+    }
+  });
+
+  const req = http.request(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'Content-Length': body.length
+    }
+  }, (res) => {
+    if (res.statusCode !== 200 && res.statusCode !== 202) {
+      console.error(`Post failed: ${res.statusCode}`);
+      process.exit(1);
+    }
+  });
+
+  req.on('error', (err) => {
+    console.error('Post Error:', err.message);
+    process.exit(1);
+  });
+
+  req.write(body);
+  req.end();
+}
+
+function handleResult(result) {
+  if (result && result.content) {
+    console.log(result.content.map(c => c.text).join('\n'));
+  } else {
+    console.log(JSON.stringify(result, null, 2));
+  }
+}
+
+run();

package/skills/feishu-bitable/skill.json

@@ -0,0 +1,20 @@
+{
+  "name": "feishu-bitable",
+  "version": "1.0.0",
+  "types": [
+    "store"
+  ],
+  "displayName": "飞书多维表格",
+  "description": "完整的飞书多维表格(Bitable) CRUD操作技能，支持数据表、记录、字段和视图的创建、读取、更新和删除。",
+  "changelog": [
+    {
+      "version": "1.0.0",
+      "date": "2026-04-14",
+      "changes": [
+        "初次提交"
+      ]
+    }
+  ],
+  "createdAt": "2026-04-14",
+  "updatedAt": "2026-04-14"
+}

package/skills/feishu-bitable/src/CHECKLIST.md

@@ -0,0 +1,150 @@
+# 发布检查清单
+
+## ✅ 已完成的项目
+
+### 核心功能
+- [x] 完整的API客户端 (src/api.js)
+- [x] 工具函数库 (src/utils.js)
+- [x] 命令行接口 (bin/cli.js)
+- [x] 自动token刷新
+- [x] 错误处理和重试机制
+- [x] 参数验证
+
+### 数据表管理
+- [x] 列出数据表
+- [x] 创建数据表
+- [x] 获取数据表详情
+- [x] 删除数据表
+
+### 记录操作
+- [x] 列出记录（支持过滤、排序、分页）
+- [x] 创建单个记录
+- [x] 批量创建记录
+- [x] 更新记录
+- [x] 删除记录
+- [x] 批量操作
+
+### 字段和视图管理
+- [x] 列出字段
+- [x] 创建字段
+- [x] 更新字段
+- [x] 列出视图
+- [x] 获取视图详情
+
+### 文档和示例
+- [x] SKILL.md (Clawdbot技能文档)
+- [x] README.md (使用说明)
+- [x] description.md (发布描述)
+- [x] 示例文件 (examples/)
+- [x] .env.example (环境变量模板)
+- [x] 测试脚本 (test-simple.js)
+
+### 配置和依赖
+- [x] package.json (依赖配置)
+- [x] package-lock.json (依赖锁定)
+- [x] 完整的npm依赖
+- [x] 执行权限设置
+
+## 📋 发布准备
+
+### 技能信息
+- **Slug**: feishu-bitable
+- **名称**: Feishu Bitable
+- **版本**: 1.0.0
+- **描述**: 飞书多维表格(Bitable)API技能
+- **标签**: feishu, lark, bitable, database, spreadsheet, automation, api, chinese
+- **许可证**: MIT
+
+### 功能亮点
+1. 完整的飞书多维表格API集成
+2. 自动token刷新和错误处理
+3. 批量操作支持
+4. 详细的文档和示例
+5. 易于扩展的模块化设计
+
+## 🚀 发布步骤
+
+1. **登录ClawdHub**
+   ```bash
+   clawdhub login
+   ```
+
+2. **发布技能**
+   ```bash
+   cd skills/feishu-bitable
+   clawdhub publish . \
+     --slug feishu-bitable \
+     --name "Feishu Bitable" \
+     --version 1.0.0 \
+     --changelog "Initial release: Complete Feishu Bitable API integration" \
+     --tags "feishu,bitable,database,automation"
+   ```
+
+3. **验证发布**
+   ```bash
+   clawdhub search "feishu-bitable"
+   ```
+
+4. **测试安装**
+   ```bash
+   # 在另一个目录测试安装
+   mkdir test-install && cd test-install
+   clawdhub install feishu-bitable
+   cd feishu-bitable
+   npm install
+   node bin/cli.js --help
+   ```
+
+## 🔧 技能结构
+```
+feishu-bitable/
+├── src/                    # 源代码
+│   ├── api.js             # API客户端
+│   └── utils.js           # 工具函数
+├── bin/                   # 命令行工具
+│   └── cli.js             # CLI接口
+├── examples/              # 示例文件
+├── SKILL.md              # 技能文档
+├── README.md             # 使用说明
+├── description.md        # 发布描述
+├── package.json          # 依赖配置
+└── test-simple.js        # 测试脚本
+```
+
+## 📝 发布说明
+
+### 版本 1.0.0 (初始发布)
+- 完整的飞书多维表格API集成
+- 支持数据表、记录、字段、视图的CRUD操作
+- 自动token刷新和错误处理
+- 批量操作支持
+- 详细的文档和示例
+- 命令行工具接口
+
+### 目标用户
+- 需要自动化飞书多维表格的企业用户
+- 开发者和系统集成商
+- 团队协作和项目管理
+- 数据同步和报表生成
+
+### 系统要求
+- Node.js >= 16.0.0
+- 飞书企业账号和应用权限
+- Clawdbot环境
+
+## 🆘 故障排除
+
+### 常见问题
+1. **登录失败**: 检查网络连接，尝试使用--token参数
+2. **发布失败**: 确保所有必填字段完整
+3. **安装失败**: 检查网络和权限设置
+4. **API错误**: 验证飞书应用权限和凭证
+
+### 支持资源
+- ClawdHub文档: https://clawdhub.com/docs
+- 飞书开放平台: https://open.feishu.cn
+- Clawdbot社区: https://discord.com/invite/clawd
+
+---
+
+**技能已准备好发布！** 🎉

package/skills/feishu-bitable/src/README.md

@@ -0,0 +1,178 @@
+# 飞书多维表格技能
+
+这是一个用于操作飞书多维表格(Bitable)的Clawdbot技能。
+
+## 快速开始
+
+### 1. 安装依赖
+```bash
+cd skills/feishu-bitable
+npm install
+```
+
+### 2. 配置环境变量
+创建 `.env` 文件：
+```bash
+FEISHU_APP_ID=cli_xxxxxx
+FEISHU_APP_SECRET=your_app_secret
+```
+
+或者使用密钥文件：
+```bash
+FEISHU_APP_ID=cli_xxxxxx
+FEISHU_APP_SECRET_PATH=~/.clawdbot/secrets/feishu_app_secret
+```
+
+### 3. 测试连接
+```bash
+node bin/cli.js test
+```
+
+## 基本用法
+
+### 列出数据表
+```bash
+node bin/cli.js list-tables --app-token basxxxxxx
+```
+
+### 创建数据表
+```bash
+node bin/cli.js create-table \
+  --app-token basxxxxxx \
+  --name "任务管理" \
+  --fields @examples/create-table.json
+```
+
+### 创建记录
+```bash
+node bin/cli.js create-record \
+  --app-token basxxxxxx \
+  --table-id tblxxxxxx \
+  --data '{"任务名称": "测试任务", "状态": "待办"}'
+```
+
+### 批量创建记录
+```bash
+node bin/cli.js batch-create \
+  --app-token basxxxxxx \
+  --table-id tblxxxxxx \
+  --data @examples/create-records.json
+```
+
+### 列出记录
+```bash
+node bin/cli.js list-records \
+  --app-token basxxxxxx \
+  --table-id tblxxxxxx \
+  --page-size 50
+```
+
+### 更新记录
+```bash
+node bin/cli.js update-record \
+  --app-token basxxxxxx \
+  --table-id tblxxxxxx \
+  --record-id recxxxxxx \
+  --data '{"状态": "已完成", "完成百分比": 100}'
+```
+
+### 删除记录
+```bash
+node bin/cli.js delete-record \
+  --app-token basxxxxxx \
+  --table-id tblxxxxxx \
+  --record-id recxxxxxx
+```
+
+## 在Clawdbot中使用
+
+### 1. 确保技能已安装
+技能应该位于 `skills/feishu-bitable` 目录。
+
+### 2. 设置环境变量
+在Clawdbot配置中设置：
+```json
+{
+  "env": {
+    "FEISHU_APP_ID": "cli_xxxxxx",
+    "FEISHU_APP_SECRET": "your_app_secret"
+  }
+}
+```
+
+### 3. 在对话中使用
+Clawdbot可以调用此技能来操作飞书多维表格。
+
+## API参考
+
+### 数据表操作
+- `list-tables` - 列出数据表
+- `create-table` - 创建数据表
+- `get-table` - 获取数据表详情（待实现）
+- `delete-table` - 删除数据表（待实现）
+
+### 记录操作
+- `list-records` - 列出记录
+- `create-record` - 创建记录
+- `batch-create` - 批量创建记录
+- `update-record` - 更新记录
+- `delete-record` - 删除记录
+
+### 字段操作
+- `list-fields` - 列出字段
+
+### 视图操作
+- `list-views` - 列出视图
+
+## 字段类型映射
+
+| 字段类型 | API类型 | 示例值 |
+|---------|---------|--------|
+| 文本 | text | "Hello World" |
+| 数字 | number | 123.45 |
+| 单选 | single_select | {"name": "选项1"} |
+| 多选 | multi_select | [{"name": "选项1"}, {"name": "选项2"}] |
+| 日期 | date | {"start": "2024-01-01"} |
+| 人员 | user | {"id": "user_id"} |
+| 复选框 | checkbox | true |
+| 附件 | attachment | {"file_token": "token"} |
+
+## 错误处理
+
+技能包含完整的错误处理：
+- 网络错误重试
+- Token自动刷新
+- 参数验证
+- 友好的错误消息
+
+## 注意事项
+
+1. **权限**：确保飞书应用有 `bitable:record:readonly` 和 `bitable:record:write` 权限
+2. **速率限制**：飞书API有速率限制，建议添加适当的延迟
+3. **数据大小**：单次请求不要超过100条记录
+4. **字段名称**：字段名称在表中必须唯一
+
+## 开发
+
+### 项目结构
+```
+feishu-bitable/
+├── src/
+│   ├── api.js          # API客户端
+│   └── utils.js        # 工具函数
+├── bin/
+│   └── cli.js          # 命令行接口
+├── examples/           # 示例文件
+├── package.json        # 依赖配置
+├── SKILL.md           # 技能文档
+└── README.md          # 使用说明
+```
+
+### 添加新功能
+1. 在 `src/api.js` 中添加新的API方法
+2. 在 `bin/cli.js` 中添加对应的命令
+3. 更新文档
+
+## 许可证
+
+MIT