# LINE平台AI开发技能

`LINE` `聊天机器人` `LIFF` `Messaging API` `Claude插件`

# line-dev

面向 LINE 平台开发的 AI 智能体技能集。借助最新 API 参考，构建机器人、登录流程、LIFF 应用、MINI App、通知消息以及 LINE 贴图/表情/主题。

## 目录

- [作为 Claude Code 插件安装](#claude-code-插件)
- [作为技能安装](#作为技能安装)
- [可用技能](#可用技能)
- [测试](#测试触发准确率)

---

## Claude Code 插件

将所有技能作为 Claude Code 插件安装：

```bash
/plugin marketplace add abgne/line-dev
/plugin install line-dev@abgne-line-dev
```

或在本地不安装的情况下测试：

```bash
claude --plugin-dir /path/to/line-dev
```

安装后，使用 `/reload-plugins` 重新加载。

---

## 作为技能安装

### 全部技能

```bash
npx skills add abgne/line-dev
```

### 指定技能

```bash
npx skills add abgne/line-dev@messaging-api
npx skills add abgne/line-dev@line-login
npx skills add abgne/line-dev@line-liff
npx skills add abgne/line-dev@line-mini-app
npx skills add abgne/line-dev@line-notification-message
npx skills add abgne/line-dev@line-creators-market
```

---

## 可用技能

| 技能 | 描述 |
|------|------|
| [messaging-api](skills/messaging-api/) | Webhook、推送/回复/群播、Flex Message、Rich Menu、窄播、受众、数据洞察、优惠券、频道令牌 |
| [line-login](skills/line-login/) | OAuth 2.0、PKCE、ID Token JWT 验证、令牌管理、机器人绑定、登录按钮设计 |
| [line-liff](skills/line-liff/) | LIFF SDK、liff.init、sendMessages、Share Target Picker、二维码扫描、永久链接、可插拔 SDK |
| [line-mini-app](skills/line-mini-app/) | 服务消息、通用资料快速填写、应用内购买、Console 配置、提交审核 |
| [line-notification-message](skills/line-notification-message/) | 基于手机号的 PNP 推送（LON）、SHA256 哈希、模板/弹性类型、投递 Webhook、授权流程、短信验证 |
| [line-creators-market](skills/line-creators-market/) | 贴图创作（7种类型）、表情、主题、技术规格、审核指南、收益模式、AI 使用声明、LINE Sticker Maker、市场策略 |

每项技能均包含覆盖 API 规格、专家指导以及**日本**、**泰国**、**台湾**地区专属细节的参考文件。

技能采用渐进式加载——元数据始终在上下文中，SKILL.md 正文在触发时加载，参考文件按需加载。

---

## 测试触发准确率

每项技能均配有评估集（包含应触发与不应触发的查询，支持 4 种语言：en、ja、zh-TW、th），用于衡量描述质量。

### 环境准备

```bash
cd scripts
python3 -m venv .venv
source .venv/bin/activate
pip install claude-agent-sdk
```

### 运行测试

**端到端**（实际调用 Claude Code，需要 `claude` CLI）：

```bash
# 测试单个技能
./test_skill_e2e.sh messaging-api --verbose

# 多次运行以验证稳定性
./test_skill_e2e.sh messaging-api --runs 3 --verbose
```

**模拟测试**（使用 Agent SDK 评估——更快、成本更低）：

```bash
# 测试单个技能
./test_skill.sh messaging-api --max-iterations 1 --verbose

# 测试所有技能
./test_all.sh --verbose

# 自动优化描述（最多迭代 3 次）
./test_skill.sh line-login --max-iterations 3 --verbose --output results.json
```

### 当前评分

#### 端到端（实际 `claude -p` 调用）

对每条查询通过 Claude Code 实际运行，检验 `Skill` 工具是否被真正调用。

| 技能 | 准确率 | 查询数 | 日期 |
|------|--------|--------|------|
| line-notification-message | 100% | 73/73 | 2026-03-23 |
| line-liff | 96% | 69/72 | 2026-03-20 |
| line-login | 95% | 62/65 | 2026-03-20 |
| line-mini-app | 94% | 166/176 | 2026-03-23 |
| messaging-api | 93% | 65/70 | 2026-03-20 |
| line-creators-market | 88% | 60/68 | 2026-03-20 |

#### 模拟测试（Agent SDK 评估）

使用 Claude Agent SDK 模拟触发决策。

| 技能 | 准确率 | 查询数 | 日期 |
|------|--------|--------|------|
| line-notification-message | 100% | 73/73 | 2026-03-20 |
| line-liff | 92% | 66/72 | 2026-03-20 |
| line-login | 92% | 60/65 | 2026-03-20 |
| line-mini-app | 99% | 174/176 | 2026-03-20 |
| messaging-api | 100% | 70/70 | 2026-03-20 |
| line-creators-market | 100% | 68/68 | 2026-03-20 |