alpha-copilot-skill

# Skill: alpha-copilot-skill

## Purpose / 用途
Use this skill to produce a publishable daily research pack from Binance Web3 market signals.
用这个 skill 可以基于 Binance Web3 市场信号生成可直接发布的日报研究包。

It is designed for operators who want one fixed output:
- 今日优先级榜单
- 值得看的 5 个币
- 每个币的基本面/流动性/风险摘要
- 可直接发推文、发群、写快报的文案草稿

## Workflow / 工作流
1. Pull multiple Binance Web3 leaderboard views (`trending`, `top_search`, `alpha`).
2. Merge repeated token hits into one candidate list.
3. Enrich top candidates with token metadata and audit data.
4. Score candidates into a daily priority ranking.
5. Output JSON or Markdown and bill one successful `rank` call through SkillPay.

1. 拉取 Binance Web3 的多个榜单视图（`trending`、`top_search`、`alpha`）。
2. 合并重复上榜的 token，生成候选池。
3. 补充 token 元数据与审计信息。
4. 计算今日优先级评分。
5. 输出 JSON 或 Markdown，并在成功执行 `rank` 后接入 SkillPay 计费。

## Commands / 命令
Run from the skill root:
在 skill 根目录执行：

```bash
python3 scripts/alpha_copilot.py rank --chain bsc --lang zh --user-id demo
python3 scripts/alpha_copilot.py rank --chain base --format markdown --limit 5 --user-id demo
python3 scripts/alpha_copilot.py rank --chain solana --skip-audit --skip-billing
python3 scripts/alpha_copilot.py health
python3 scripts/alpha_copilot.py proxy-check --chain bsc
```

## Output Contract / 输出结构
Each ranked token includes:
每个入选币种包含：
- `symbol`
- `name`
- `contract_address`
- `priority_score`
- `priority_tier`
- `fundamentals_summary`
- `liquidity_summary`
- `risk_summary`
- `tweet_draft`
- `group_draft`
- `brief_draft`

The report also contains `leaderboard`, `top_tokens`, `summary`, and `generated_at_utc`.
整份报告还包含 `leaderboard`、`top_tokens`、`summary` 和 `generated_at_utc`。

## Billing Hook (SkillPay) / 计费接入
- Bill only `rank`.
- Default price comes from `SKILLPAY_PRICE_USDT` and should stay at `0.01`.
- Read API key from `SKILLPAY_...