1688alphaclaw

1688 AlphaClaw

SkillHub CLI Tool - 1688 技能管理平台命令行工具

AlphaClaw 是为 SkillHub 技能中心开发的命令行工具，让开发者可以快速搜索、安装、发布和管理 Claude Code 技能（Skill）。

官网: https://www.alphashop.cn/

安装

# 本地开发安装
cd alphaclaw
chmod +x bin/alphaclaw.js
npm link

# 或者全局安装（发布到 npm 后）
npm install -g 1688alphaclaw

快速开始

1. 获取 API 密钥

访问遨虾控制台获取 Access Key 和 Secret Key：

地址: https://www.alphashop.cn/seller-center/apikey-management

Secret Key 仅在创建时可见，请妥善保管！

2. 登录

alphaclaw login
# 自动打开浏览器访问 API 密钥管理页面
# 输入 Access Key 和 Secret Key（SK 输入时会被隐藏）

3. 搜索技能

alphaclaw search "小红书"
alphaclaw search "数据处理"

4. 查看技能详情

alphaclaw info xiaohongshu-upload

5. 安装技能

alphaclaw install xiaohongshu-upload
alphaclaw install xiaohongshu-upload --version 1.0.0
alphaclaw install xiaohongshu-upload --force  # 强制覆盖

6. 查看已安装的技能

alphaclaw list

7. 发布技能

cd my-skill/
alphaclaw publish
# 或者指定目录
alphaclaw publish ./my-skill --yes  # 跳过确认

8. 收藏技能

alphaclaw favorite xiaohongshu-upload
alphaclaw favorite xiaohongshu-upload --remove  # 取消收藏

9. 发表评论

alphaclaw comment xiaohongshu-upload
# 然后输入评论内容

10. 查看当前用户

alphaclaw whoami

命令列表

全局选项

技能包格式

要发布技能，你的技能目录必须包含 SKILL.md 文件，格式如下：

---
name: my-skill
version: 1.0.0
type: SKILL
category: DATA_PROCESSING
description: "我的技能描述"
github-url: https://github.com/example/my-skill
---

# My Skill

详细说明你的技能...

## 使用方法

...

## 示例

...

必需字段

• name: 技能名称（字母、数字、连字符，如 xiaohongshu-upload、1688-ranking）
• version: 版本号（遵循语义化版本，如 1.0.0）
• category: 分类编码（见下文分类列表）
• description: 技能描述

可选字段

• type: 类型（SKILL 或 EXPERIENCE，默认 SKILL）
• github-url: GitHub 仓库链接

技能分类

环境变量

配置文件

AlphaClaw 的配置文件存储在：

• 认证信息: ~/.alphaclaw/auth.json
• 安装锁文件: ~/.skillhub/skills-lock.json
• 技能安装目录: ~/.skillhub/skills/

认证方式

AlphaClaw 使用基于 JWT (JSON Web Token) 的 AK/SK 认证方式：

• 使用 HMAC-SHA256 算法生成 JWT Token
• Token 有效期：30 分钟
• 每次 API 请求自动生成新 Token
• Authorization Header 格式：Bearer <token>

认证流程：

1. 用户登录输入 Access Key 和 Secret Key
2. 凭证保存到 ~/.alphaclaw/auth.json
3. 每次 API 请求自动生成 JWT Token
4. Token 添加到 Authorization Header
5. 发送到后端 API 进行验证

示例工作流

创建和发布新技能

# 1. 创建技能目录
mkdir my-awesome-skill
cd my-awesome-skill

# 2. 创建 SKILL.md
cat > SKILL.md << 'EOF'
---
name: my-awesome-skill
version: 1.0.0
type: SKILL
category: DATA_PROCESSING
description: "一个很棒的技能"
---

# My Awesome Skill

这是一个很棒的技能...
EOF

# 3. 添加你的脚本文件
mkdir scripts
touch scripts/main.py

# 4. 登录（如果还没登录）
alphaclaw login

# 5. 发布
alphaclaw publish

查找和安装技能

# 1. 搜索技能
alphaclaw search "数据处理"

# 2. 查看详情
alphaclaw info data-processing-skill

# 3. 安装
alphaclaw install data-processing-skill

# 4. 查看已安装
alphaclaw list

与 SkillHub 后端集成

AlphaClaw 与 SkillHub 后端（global-1688-skills）无缝集成：

调试

如果遇到问题，可以使用 --debug 标志查看详细信息：

alphaclaw publish --debug

许可证

MIT

贡献者

SkillHub Team @ Alibaba