Listen Agent Skills Framework

一个用于管理和安装AI助手技能的CLI工具框架。

特性

• 🚀 支持多种AI助手 (Claude, Cursor, Windsurf, Kiro等)
• 📦 统一的技能管理系统
• 🛠️ 简单的CLI命令
• 📝 模板化技能创建
• 🔍 智能AI助手检测
• ✨ 交互式技能选择
• 🎯 精确技能安装控制

安装

npm install -g listen-agent

使用方法

初始化项目

# 自动检测AI助手类型并交互式选择技能
listen-agent init

# 指定AI助手类型
listen-agent init --ai claude
listen-agent init --ai cursor
listen-agent init --ai all

# 安装特定技能
listen-agent init --ai kiro --skills wechat-work-notification
listen-agent init --ai cursor --skills skill1 skill2 skill3

# 强制覆盖现有文件
listen-agent init --force

创建技能

# 创建基础技能
listen-agent create my-skill

# 使用高级模板
listen-agent create my-skill --template advanced

列出技能

listen-agent list

技能选择

交互式选择

当运行 listen-agent init 而不指定 --skills 参数时，工具会显示所有可用技能并提供交互式多选界面：

listen-agent init --ai kiro
# 显示可用技能列表
# 使用空格键选择/取消选择技能
# 按回车键确认安装

命令行指定

直接在命令行中指定要安装的技能：

# 安装单个技能
listen-agent init --ai kiro --skills wechat-work-notification

# 安装多个技能
listen-agent init --ai cursor --skills skill1 skill2 skill3

错误处理

如果指定的技能不存在，工具会显示警告并列出所有可用技能：

listen-agent init --ai kiro --skills non-existent-skill
# warn Skills not found: non-existent-skill
# error None of the specified skills were found
# info Available skills:
#   • mac-m4-lora-training
#   • wechat-work-notification

支持的AI助手

| AI助手 | 检测文件夹 | 安装路径 | 状态 | |--------|------------|----------|------| | Claude Code | .claude/ | .claude/skills/ | ✅ | | Cursor | .cursor/ | .cursor/commands/ + .shared/ | ✅ | | Windsurf | .windsurf/ | .windsurf/workflows/ + .shared/ | ✅ | | Kiro | .kiro/ | .kiro/steering/ + .shared/ | ✅ | | Antigravity | .agent/ | .agent/workflows/ + .shared/ | ✅ | | GitHub Copilot | .github/ | .github/prompts/ + .shared/ | ✅ | | Codex | .codex/ | .codex/skills/ | ✅ | | RooCode | .roo/ | .roo/commands/ + .shared/ | ✅ | | Qoder | .qoder/ | .qoder/rules/ + .shared/ | ✅ | | Gemini CLI | .gemini/ | .gemini/skills/ + .shared/ | ✅ |

项目结构

初始化后的项目结构：

your-project/
├── skills/                 # 技能目录
│   └── my-skill/
│       ├── skill.json      # 技能元数据
│       ├── README.md       # 技能说明
│       └── prompt.md       # 技能提示词
├── templates/              # 模板目录
├── listen-agent.config.json # 配置文件
└── .shared/                # 共享资源 (如果适用)

技能开发

技能结构

每个技能包含以下文件：

• skill.json - 技能元数据和配置
• README.md - 技能文档
• prompt.md - AI助手提示词
• config.json - 高级配置 (可选)

示例技能

{
  "name": "my-skill",
  "version": "1.0.0",
  "description": "My awesome agent skill",
  "author": "Your Name",
  "tags": ["productivity", "automation"],
  "aiTypes": ["claude", "cursor", "windsurf"],
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-01T00:00:00.000Z"
}

开发

# 克隆项目
git clone <repository-url>
cd listen-agent

# 安装依赖
npm install

# 开发模式
npm run dev

# 构建
npm run build

# 本地测试
npm link
listen-agent --help

许可证

MIT