fpl-copilot

FPL Copilot

分析当前 FPL 数据、维护已保存的阵容，并生成独立完整的报告。本技能规定操作和完成标准；应根据实际环境选择合适的工具或命令。

工作流

1. 确认能力和存储位置

检查可用工具，并根据本技能的安装位置查找其资源。确认具备 HTTP 请求、JSON 处理、SQLite 3 查询和写入、文档持久化以及报告交付能力。在配备 Shell 的主机上，判断适用的已安装命令或脚本库；在其他主机上，使用已公开的原生工具。工具名称和可执行程序由具体实现决定。

按照以下规则一次性解析存储位置，然后在每处引用和操作中重复使用所得映射。FPL 数据必须与 Agent 应用程序的内部存储分开。

存储位置解析（按优先级排序）：

1. 使用用户明确选择的 FPL 位置，或主机为稳定命名空间 fpl-copilot 提供的绑定。如果两者不一致，请在写入前询问用户应使用哪一个。
2. 如果没有明确选择或主机绑定，则使用桌面根目录 ~/.fplcopilot/，并通过当前用户的主目录将其展开为绝对路径。即使工作目录或对话发生变化，也要重复使用此根目录。
3. 如果主机没有桌面主目录，则通过其存储能力为命名空间 fpl-copilot 请求持久化存储。重新打开现有绑定；如果主机无法提供稳定绑定，则在创建状态数据前，请用户选择持久存储位置。必须明确标识对话本地存储，并由用户明确选择后方可使用。

从同一根目录派生 fplcopilot.db、squads/、reports/ 和 player-history-sync.json。如果主机使用独立的资源句柄，则通过主机的存储配置，在同一命名空间下持久化其映射。在声称支持跨对话持久化之前，请验证该映射能够重新打开。参考资料中提到的每个“已解析”位置，都指此映射，绝不能重新选择位置。

初始化前检查所选位置。若发现多个相互冲突的现有映射，请询问用户应以哪个为准；在用户选择迁移方案前，保留现有数据。首次建立映射时，报告所选根目录或句柄，以及持久化范围。

结构化 FPL 存储必须使用 SQLite 3；sqlite3 可执行程序只是可选接口，并非依赖项。使用可用的 SQLite 接口：CLI、脚本语言库，或由 SQLite 支持的原生基础组件或工具（例如 Expo SQLite）。查明可用接口并始终使用该接口。从 references/schema.sql 初始化新数据库；通过所选接口执行参考 SQL，并保留架构和计算语义。如果缺少所需能力，请指出受阻的操作，只完成受支持的部分；并明确区分未保存的输出与不可用的实时数据。

**完成标准：**Agent 已确认所请求任务所需的可用操作和持久化位置，或已报告具体缺失的能力。

2. 确认数据时效性

开始数据分析前，读取 references/sync.md 和 references/api.md 中相关的映射。检查成功刷新的元数据，并按照该约定刷新缺失或过时的数据集。只获取所请求计算所需的球员历史记录；批量获取所有球员数据必须有用户的明确请求。

**完成标准：**所需数据集具有成功刷新的时间戳和经验证的持久化记录；或者答案能够说明可用缓存快照的时间和局限性。刷新失败不能作为数据新鲜的证据。

3. 加载阵容并进行分析

对于“我的阵容／球队”，先检查已保存的阵容，再询问用户是否要重新分享。根据选择、持久化和验证的要求，阅读 references/squad.md。根据指标和决策框架，阅读 references/analysis.md；使用文档中列出的公式，并结合可用的查询／计算能力。根据已存储的姓名解析球员 ID，选择球员前先确认是否存在姓名歧义。

使用阵容参考文档保存新分享的阵容和已确认的变更。将假设性的转会保留在草案计划中；在本地记录变更并不会将其提交到用户的 FPL 账户。阵容分析完成后，将关键结论保存到 Notes。

**完成条件：**建议有检索到的数据和有文档记录的计算作为依据；每项必需的阵容写入操作都已验证，或已明确说明未保存。

4. 提供结果

使用 Markdown 展示便于快速查阅的内容、简短推理、截止时间和小型结果。对于以下空间或对比类输出，请阅读 references/html-output.md，并使用实际数据调整对应模板。

输出	模板
阵容阵型、替补席、总计	templates/squad-view.html
赛程难度矩阵	templates/fixture-matrix.html
转会对比	templates/transfer-comparison.html
队长排名及理由	templates/captain-ranking.html
比赛周策略	templates/gameweek-report.html

创建一份自包含的 HTML 报告，其中包含内联 CSS、JavaScript 和 SVG；使用原生 HTML/CSS/JS 和响应式布局。将其存储在解析出的 reports/ 位置下，文件名为 {YYYY-MM-DD}-{slug}.html。提供受支持的预览、附件、分享链接或可访问的文件路径。若有可用的查看操作，请据此推断合适的操作。若无法创建或交付报告，请在聊天中提供实质性结果，并说明缺少的报告功能。

**完成条件：**用户已获得有实质内容的答复；在支持的情况下，还提供了可访问的报告引用，并说明数据时效性及任何限制。

参考文档路由

执行操作前，先阅读对应的资源：

资源	操作
references/sync.md	刷新、规范化、持久化和验证 FPL 数据集
references/api.md	解析端点及 API 到存储字段的映射
references/schema.sql	初始化存储，或解析表、类型和键
references/analysis.md	计算指标并生成建议
references/squad.md	加载、验证、创建或更新阵容
references/html-output.md	生成并交付报告

数据约定

• 先根据 web_name 匹配姓名，再匹配部分显示名称和全名；如有歧义，请向用户确认。
• 价格以 0.1m 为单位：130 表示 £13.0m。显示为 £X.Xm；比较性价比时，按百万计的成本进行归一化。
• 位置为 GKP、DEF、MID、FWD，映射自 API 代码 1–4。
• 可用状态代码：a 可用，d 存疑，i 受伤，s 停赛，u 不可用。
• FDR 范围为 1（非常容易）至 5（非常困难）。