139 lines
4.2 KiB
Markdown
139 lines
4.2 KiB
Markdown
# 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 | |