export-ml-project

Export ML Project

用途

根据资料，这是一个仅负责“排序（Ordering only）”的协调技能，用于按需触发机器学习项目的导出。子技能负责执行转换（convert）和站点（site）命令。它可以在收到泛化的“export”请求时触发，也可用于在初始设置之后切换 notebooks / site 两个开关（gates）。

主要能力

• 运行 python -m skore_skills status，读取 policy.notebooks、policy.site 以及 skills 状态。
• 通过带 allow_multiple 的 AskUserQuestion 向用户多选询问导出范围，选项为 Executed notebooks 与 Documentation site。
• 将用户选择持久化为策略（policy）。
• 按条件加载子技能：notebooks → export-ml-notebook；site → export-ml-site。
• 可选地在 status.skills.triage-ml-task 为 true 时加载 triage-ml-task，否则停止。

使用方式

1. 运行 python -m skore_skills status，读取 policy.notebooks、policy.site 和 skills。
2. 使用 AskUserQuestion（允许多选）提问。提问前先用 2–4 行说明每个选项授权的内容（工具链安装、convert 重新执行、构建站点），以及已记录的标志（policy.notebooks 和 policy.site：true、false 或未记录），并说明两个回答都会作为策略持久保存。提问的最后一行必须精确为：Select each one you want. 该行之后不再写任何内容。
3. 回答后（不在问题中），在当轮为每个选项持久化：被选中 → python -m skore_skills policy set notebooks true（或 site）；未选中的选项 → false。不要保留为 null。不要将 notebooks 或 site 写入 JOURNAL；策略即记录。
4. 仅当 status.skills.<id> 为 true 时加载每个被选中的子技能；否则输出一行跳过说明。不要臆造该技能的步骤：
   • notebooks → export-ml-notebook（若这是第一次同意，则安装工具链，然后执行 convert；仅当用户希望在站点上使用笔记本查看器时才加 --html）
   • site → export-ml-site（若这是第一次同意，则安装 mkdocs-material，必要时初始化，然后 build；从不执行 convert）
5. 仅当 status.skills.triage-ml-task 为 true 时加载 triage-ml-task；否则停止。

面向人类的说明

细节参见 setup-workspace 的 references/human_facing_prose.md。多选使用 Executed notebooks 与 Documentation site 两个标签。不要在问题中放入技能 id、convert 标志或包装 CLI。文件链接只是附加内容，绝不是上下文。

适用场景

• 收到泛化的“export”请求时。
• 在初始设置后，需要切换 notebooks / site 两个开关时。

限制与约束

• 不要执行 git end-turn 或 git commit。
• 当子技能缺失时，不要臆造 convert 或 mkdocs 步骤。
• 不要从该协调器执行 pixi add / uv add。
• 资料未说明适用的操作系统、运行环境依赖版本、收费方式、价格等信息。