← 返回 Skills 市场
30
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install pursuit-maps
功能描述
TrackMania Pursuit maps pipeline — fetches maps from ManiaPlanet Feedback (star ratings, vote counts), enriches with ManiaExchange data, syncs to Google Shee...
使用说明 (SKILL.md)
\r \r
Pursuit Maps Pipeline\r
\r Automated pipeline: ManiaPlanet Feedback + ManiaExchange → Google Sheets.\r \r
Quick Reference\r
\r
Main script: pipeline/pipeline.py in repo tomekdot/pursuit-maps\r
\r
python3 pipeline/pipeline.py # full pipeline\r
python3 pipeline/pipeline.py --action sync # fetch + push new maps + auto-sort\r
python3 pipeline/pipeline.py --action votes # update vote columns only\r
python3 pipeline/pipeline.py --action sort # sort sheet by Uploaded At\r
python3 pipeline/pipeline.py --action report # vote change report\r
python3 pipeline/pipeline.py --action validate # data quality checks\r
```\r
\r
**GAS Web App**: `pipeline/gas-webapp/PursuitMaps.gs` — deploy once in Sheet (Extensions → Apps Script → Deploy as Web App). Accepts HTTP POST from pipeline.\r
\r
## Repo Structure\r
\r
```\r
pursuit-maps/\r
├── pipeline/pipeline.py ← Main entry point (all actions)\r
├── pipeline/gas_runner.py ← HTTP client for GAS\r
├── pipeline/gas-webapp/ ← GAS script (deploy in Sheet)\r
├── data/ ← Cache, history, reports\r
├── docs/ ← Setup guides\r
├── scripts/legacy/ ← Old scripts (reference)\r
└── .github/workflows/pipeline.yml ← Daily 5:00 UTC\r
```\r
\r
## Sheet Columns\r
\r
| Col | Name | Source |\r
|-----|------|--------|\r
| A | # | Auto |\r
| B | Map name | Feedback |\r
| C | Author login | ManiaExchange |\r
| D | Environment | ManiaExchange |\r
| E | Uploaded at | ManiaExchange (ISO 8601 → normalized to YYYY-MM-DD HH:MM:SS) |\r
| F | UID | Feedback |\r
| G | TrackMania\MapType | ManiaExchange |\r
| H | Notes | Manual |\r
| I | YN Rating | Feedback YES/NO section |\r
| J | YN Votes | Feedback YES/NO section |\r
| K | 5-Star Avg | Feedback 5 STARS section |\r
| L | 5-Star Total | Feedback 5 STARS section |\r
\r
## Sorting\r
\r
Sheet is auto-sorted by **Uploaded At (column E) descending** after every sync (newest maps on top).\r
- Column E is formatted as Date (`yyyy-mm-dd hh:mm:ss`) so Sheets treats it as proper date\r
- Manual sort: `python3 pipeline/pipeline.py --action sort` or POST `{"action":"sort"}` to GAS\r
- Sort function handles both Date objects and string dates from MX API\r
\r
## Key API Endpoints\r
\r
- Feedback page: `feedback.prod.live.maniaplanet.com/votes/display/106`\r
- MX API: `tm.mania.exchange/api/maps/get_map_info/id/{UID}` (V1, accepts UID)\r
- Sheet read: gviz API (no auth for public sheets)\r
- Sheet write: GAS Web App (deployed once per user)\r
\r
## Parsing Notes\r
\r
Feed page has TWO separate star rating sections per map card:\r
1. **YES/NO** section: `\x3Ch6>YES/NO\x3C/h6>` → gold span → `rating (count)`\r
2. **5 STARS** section: `\x3Ch6>5 STARS\x3C/h6>` → gold span → `rating (count)`\r
\r
Parse independently. ~80% of maps have 5-Star data but no YES/NO votes.\r
\r
Split HTML at each `\x3Cimg src="...maps/...">` to isolate per-map cards.\r
\r
## Stats\r
\r
- 249 maps total\r
- ~75% indexed on ManiaExchange\r
- 248 thumbnails available (1 HTTP 403)\r
- 4 environments: Valley, Canyon, Stadium, Lagoon\r
- 3 map types: PursuitArena (~80%), GoalHuntArena (~15%), HuntersArena (~5%)\r
安全使用建议
Install only in a ClawHub maintainer or admin environment where these powers are intended. Before use, consider setting AUTOREVIEW_YOLO=0 or using --no-yolo, and only run moderation, email, package transfer, org deletion, or PR publishing commands after confirming the exact target and reason.
能力评估
Purpose & Capability
The stated purposes are coherent: ClawHub moderation, PR maintenance, autoreview, and Convex development guidance. Several capabilities are high-impact, including banning users, changing roles, transferring packages, deleting org publishers, sending staff email, posting PR proof, and running nested review tools.
Instruction Scope
Moderation instructions include good safeguards such as explicit targets, reasons, confirmation, auth, audit logging, and verification. The main concern is the autoreview helper defaulting nested Codex to bypass approvals and use danger-full-access, which is broader than a review workflow needs by default.
Install Mechanism
No install-time execution, hidden installer, or persistence mechanism was found in the skill artifacts. The only executable artifact reviewed is the autoreview helper script.
Credentials
The staff admin commands are purpose-aligned but operate on production-like ClawHub and GitHub surfaces when invoked. The default full-access nested review mode materially increases local environment risk even though it is disclosed and can be disabled.
Persistence & Privilege
The skills rely on existing CLI, GitHub, Convex, and ClawHub credentials rather than collecting new secrets. They do not establish background persistence, but they can perform privileged mutations when run by an authorized maintainer.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install pursuit-maps - 安装完成后，直接呼叫该 Skill 的名称或使用
/pursuit-maps触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v2.0.0
Major pipeline upgrade with improved data enrichment, Sheet syncing, and reporting:
- Adds enrichment of ManiaPlanet Feedback map data with ManiaExchange details (author, environment, map type, upload date).
- Syncs enriched data to Google Sheets using a Google Apps Script (GAS) Web App for easy updates and automation.
- Supports flexible pipeline actions: fetch & sync maps, update vote columns, sort by date, generate vote change reports, and perform data validation.
- Automatically sorts the Sheet by map upload date (newest first) after each sync.
- Expanded documentation and quick reference for setup, available actions, and Sheet structure.
元数据
常见问题
Pursuit Maps 是什么？
TrackMania Pursuit maps pipeline — fetches maps from ManiaPlanet Feedback (star ratings, vote counts), enriches with ManiaExchange data, syncs to Google Shee... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 30 次。
如何安装 Pursuit Maps？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install pursuit-maps」即可一键安装，无需额外配置。
Pursuit Maps 是免费的吗？
是的，Pursuit Maps 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Pursuit Maps 支持哪些平台？
Pursuit Maps 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Pursuit Maps？
由 tomekdot（@tomekdot）开发并维护，当前版本 v2.0.0。
推荐 Skills