| name | famou-experiment-manager |
| description | 管理 famou 进化实验任务的工作流技能。当用户提到"提交实验"、"查看实验状态"、"删除实验"、"获取实验结果"、"famou 实验"、"上传实验"、"config.yaml 实验"或需要使用 famou-ctl 管理实验任务时，必须使用此技能。即使用户只说"提交"或"跑实验"，只要上下文涉及 famou 平台，也应触发此技能。 |
Famou 任务管理 Skill
用于通过 famou-ctl-sdk 提交和管理实验任务的完整工作流。
前置环境检查
1.1 检查 famou-ctl-sdk 是否已安装
famou-ctl --version
- 若输出版本号，继续下一步
- 若命令未找到，执行安装：
pip install famou-sdk --pre
安装完成后再次验证 famou-ctl --version，若仍失败，停止并提示用户检查 Python 环境或 pip 源配置。
1.2 检查和配置 API 配置
使用辅助脚本 scripts/config.py 检查和配置 API 设置。
检查 API 配置
python3 scripts/config.py read
| 检查结果 | 操作 |
|---|
status: "ok" | 配置完整，跳过配置 |
status: "missing" | 执行配置 API Key |
配置 API：
提示用户输入有效的 API_KEY，然后执行配置命令
python3 scripts/config.py write <YOUR_API_KEY>
提交 FaMou 实验
2.1 查找 config.yaml 文件
在当前工作目录下递归查找所有 config.yaml 文件：
find . -name "config.yaml" -type f 2>/dev/null | sort
处理结果：
| 情况 | 操作 |
|---|
| 找到 1 个 | 直接使用，告知用户路径，继续下一步 |
| 找到多个 | 使用 ask_user 工具询问用户选择哪个 |
| 未找到 | 报告用户并提示用户创建 config.yaml |
config.yaml 模板：
evolve_config:
max_iterations: 100
population_size: 100
num_islands: 2
initial_program: "init.py"
evaluator: "evaluator.py"
system_message: "prompt.md"
2.2 确认实验目录
将所选 config.yaml 的父目录（绝对路径）作为实验目录：
realpath $(dirname <config.yaml路径>)
2.3 获取实验名称
使用 ask_user 工具或直接在对话中请求用户输入实验名称 experiment_name, 提示用户实验名称只能包含字母、数字和下划线，且长度不超过20个字符
2.4 提交实验
famou-ctl experiment create \
--config <config.yaml绝对路径> \
--experiment-name <experiment_name> \
--json
处理输出：
- 命令成功：解析 JSON 输出，展示实验 ID、状态等关键信息
- 命令失败：展示错误信息，提示用户检查配置或网络连接
2.5 实验状态查询
每间隔10s，查询一下实验状态，检查是否通过线上的验证并且正常进入 famou 进化（验证需要消耗一些时间，因此需要轮训检查实验状态）
- 验证失败：修复评估器和初始解，删除失败的实验，重新提交
- 验证成功：输出实验状态并结束
FaMou 实验其他操作
步骤 1：确认 experiment-id
- 查找上下文到 experiment-id，直接使用
- 若未提供，使用
ask_user 工具请求用户输入
步骤 2: 执行相应的命令
famou-ctl experiment status <experiment-id> --json
famou-ctl experiment cancel <experiment-id> --json
famou-ctl experiment delete <experiment-id> --json
famou-ctl experiment logs <experiment-id> --follow/-f --output <file-path> --api-url <url> --json
famou-ctl experiment results <experiment-id> --output <file-path> --json
处理输出：
- 命令成功：解析 JSON，清晰展示实验状态、进度、创建时间等信息
- 命令失败：展示错误信息，提示检查 experiment-id 是否正确或网络连接
