技能介绍

要解决的问题

国际象棋的局面表达常用 FEN（Forsyth-Edwards Notation），一行字符串里同时包含棋盘摆放、行棋方、王车易位权、升变子和半步计数。手工解析这类字符串并不难，但很容易在空位折叠、棋规约束和非法局面上出错；而在 AI 助手或自动化脚本里，把一个 FEN 稳定地转成可读棋盘，还需要统一校验口径和一致的输出格式。

核心能力与调用链路

@org-rn88lg3j/chess-fen 把这个需求拆成两个动作：验证 FEN 结构，并用 ASCII 渲染棋盘。模型侧只做路由，不猜测棋规；真正落子和画盘由脚本调用 API 完成。

初始化时若 scripts.config.settings.api_key 为空，先通过 AskUserQuestion 获取密钥，再用 scripts.config.set_api_key(api_key) 保存。
根据用户意图选择工具，当前清单只有 scripts.tools.visualize_fen，用于把 fen_string 转成 ASCII 棋盘。
fen_string 是唯一必填参数；参数不完整时同样先问用户，不自行补全。
调用时使用关键字参数，例如 scripts.tools.visualize_fen(fen_string='...')，随后读取 result["raw"]、result["success"] 和 result["message"]。

适用边界与注意点

这个技能适合嵌入 MCP 兼容的 AI 助手，把 FEN 校验与棋盘可视化当成一个可路由的后端能力。它不做通用棋类引擎推导，也不负责走子生成或胜负判定；工具返回的 raw 数据应作为后续展示的依据。

没有 API 密钥时不能继续执行：既不要自行搜索数据，也不要编造解析结果。密钥从 https://xiaobenyang.com 获取，配置方式是通过上述 set_api_key 保存，而不是直接写进上下文。参数方面，传入的 FEN 必须是字符串；如果用户只给出自然语言描述，应先回问缺失的 fen_string。返回处理上，优先展示 raw 中的结果，同时用 success 与 message 判断是否可继续渲染。