Chess-Results

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install chess-results
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 chess-results。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Chess-Results 是一项 OpenClaw 技能，可查询棋手、参赛赛事、棋手卡片、赛事、排名、配对、各轮结果、队伍阵容以及奥地利锦标赛联赛。它同时提供 MCP 服务器和命令行界面；由于该网站没有 API，因此通过读取公开的 Chess-Results 页面获取数据。
其突出功能是将拍摄的团体赛对局报告转换为经过核验的线上结果。该技能会根据俱乐部成员名单和队伍阵容核对棋手，检查配对和得分，并在保存前运行 Chess-Results 自带的验证。它会提供核验日志供检查，并要求用户明确确认后才提交结果。

应用场景

查找棋手在 Chess-Results 上的参赛赛事、标识符、FIDE ID、等级分或棋手卡片。
按名称、地点、组织者或国家搜索赛事。
获取赛事排名、配对、各轮结果、队伍阵容和最终名次表。
列出奥地利锦标赛某一赛季的联赛。
转录拍摄的团体赛对局报告，并核对棋手身份、台次顺序、结果和未到场情况。
在用户检查报告并明确批准提交后，录入已核验的对局结果。

工作原理

根据棋手、赛事、棋手卡片、联赛或对局报告任务，选择相关 MCP 工具或 CLI 命令。
对于查询任务，从 Chess-Results 页面读取所需数据。该技能会控制请求频率、重试并缓存请求，以遵守网站的限流规则。
对于对局报告，逐项准确转录每场对局，包括标识符、姓名、台次结果、弃权和未到场情况；标记不清楚的数字，并询问缺失的结果。
运行 check_match_report 或 cli.py check 查找配对，并根据比赛日期核对每位棋手与俱乐部成员名单和队伍阵容是否一致。缺失的标识符可从队伍名单或俱乐部列表中补齐。
检查并展示核验日志，包括每一条 STOP、NOTICE 和警告。此验证步骤不会保存任何内容。
只有在用户明确确认后，才提交已完成的报告。该技能会拒绝不合规的对局或不在录入时段内的对局，然后重新读取概览以确认录入结果。

配置指南

有关录入结果所需的 Python 软件包、一次性登录和俱乐部设置，请参阅该技能的 SETUP.md。需要 Python 3。公开查询无需凭据；只有录入结果时才需要。
请在用户自己的终端中运行登录命令。凭据会存储在系统凭据存储区；没有此类存储区的系统则会将凭据保存为私有文件。切勿在聊天中索取、读取或打印密码。
python3 scripts/cli.py login
python3 scripts/cli.py status
查询命令示例：
python3 scripts/cli.py players --last-name
python3 scripts/cli.py tournaments --name --country AUT
python3 scripts/cli.py player
python3 scripts/cli.py tournament [--art N --rd N]
python3 scripts/cli.py leagues --prefix
处理对局报告时，请先准备报告 JSON 并进行核验，然后检查已完成的报告和日志，最后仅在明确批准后提交：
python3 scripts/cli.py check report.json
python3 scripts/cli.py enter report.json --yes
CLI 的 --yes 选项是一种明确的确认机制；不使用该选项时，交互式录入会要求用户输入 yes，且在终端不可用时会拒绝操作。请遵循 SETUP.md 中有关俱乐部专属配置和完整报告流程的说明。

数据架构

对局报告结构
报告包含日期和一个 matches 数组。每场对局记录其组别、轮次、主队和客队名称、对局总分以及按顺序排列的台次。
字段 含义
date YYYY-MM-DD 格式的对局日期
division, round 比赛组别和轮次编号
home, away 包含队伍名称的队伍对象
total 报告上所写的对局得分
boards 按顺序排列的台次条目，每项包含主队棋手、结果和客队棋手
棋手值 [ident, 按原文填写的姓名]；没有标识符时使用空标识符
null 棋手 无人就坐的台次（未到场）
result 主队一方的结果：1-0、0-1、½-½、弃权 +--、--+、---；未知时为 ?
请严格按照所示内容转录姓名和数字；不要擅自更正。已完成的报告可包含从队伍名单或俱乐部列表中解析出的标识符。核验会生成包含 STOP、NOTICE 和警告信息的日志；不会保存结果。除报告 JSON 和 CLI 的已完成报告工作流程外，没有指定其他本地输出文件格式。

高级特性

同时提供 MCP 服务器（
chess-results
）和 Python CLI（
scripts/cli.py
）。
由于 Chess-Results 网站不提供 API，直接读取其页面；工具会控制请求频率、重试并缓存请求，以应对限流。
根据比赛日期，使用两个俱乐部的成员名单和队伍阵容核对棋手标识符及填写的姓名，帮助发现诸如误用亲属标识符等身份错误。
核验对局时，先从队伍名单中补全缺失的棋手标识符，再从俱乐部列表中补全。
提交前验证结果、未到场情况、对局总分、台次顺序以及 Chess-Results 自带的 “Eingabe Prüfen” 检查。
检测报告中的主客队是否颠倒，遵循网站上的配对，并在日志中记录 NOTE。
保存前要求明确确认；结果会对联赛公开，Chess-Results 会记录录入者，并且录入时段可能限制可录入的轮次。
默认通过系统凭据存储区避免在聊天和文件中保存凭据；只有录入结果的工作流程需要登录。

name: chess-results description: Work with Chess-Results (chess-results.com) — look up players (appearances, national idents, FIDE ids, ratings, player cards), find tournaments, read any tournament page (rankings, pairings, round results, team compositions, tables), list a season's Austrian championship leagues, and turn photographed team match reports into entered results — check every player against the clubs' member lists and team rosters on Chess-Results, and save them through Chess-Results' online result entry without a browser. Use for questions about chess tournaments, players or team results on Chess-Results, and when the user sends photos of team match reports (Spielberichte). homepage: https://github.com/odrobnik/chess-results-skill