伐谋 - 实验管理

管理 famou 进化实验任务的工作流技能。当用户提到"提交实验"、"查看实验状态"、"删除实验"、"获取实验结果"、"famou 实验"、"上传实验"、"config.yaml 实验"或需要使用 famou-ctl 管理实验任务时，必须使用此技能。即使用户只说"提交"或"跑实验"，只要上下文涉及 famou 平...

Security Scan

技能声明的用途（通过 famou-ctl 管理 FaMou 实验）与其指示和包含的脚本一致；它在本地保存 API Key 到 ~/.famou-ctl/settings.json 并调用 famou-ctl CLI，未发现与声明目的不相称的权限或隐藏外联行为。

Purpose & Capability

技能名与描述是管理 FaMou 进化实验；SKILL.md 指示使用 famou-ctl（或 famou-sdk）提交/查询/删除实验，且包含一个用于读写本地设置的辅助脚本 scripts/config.py。所需操作与声明目的对齐。

Instruction Scope

运行步骤限定于：检查/安装 famou-sdk、使用 scripts/config.py 读写本地配置文件、在当前工作目录递归查找 config.yaml、以及调用 famou-ctl 命令来管理实验。没有指示读取无关系统凭据或外发不明数据。唯一需要注意的是它会在当前目录递归查找文件并且会定期轮询远端服务（网络活动为预期行为）。

Install Mechanism

技能无统一 install spec（instruction-only），在运行时可能通过 pip 安装 famou-sdk（`pip install famou-sdk`）；文档同时提供了备用 pip 源（https://pip.baidu-int.com/simple），这是一个内部/镜像源——功能上可接受，但用户应注意从第三方/私有镜像安装软件的风险并在必要时审查包来源。

Credentials

技能不要求任何环境变量或外部凭据字段；它使用本地配置文件 ~/.famou-ctl/settings.json 存储 API Key（scripts/config.py 的行为是本地写入与读取，并对展示的 key 做掩码），与技能目的相称。

Persistence & Privilege

技能未设置 always:true，也不请求修改其他技能或全局 agent 配置。唯一的持久化行为是创建/修改用户主目录下的 ~/.famou-ctl/settings.json（保存 api_key、api_url、user_id），这与管理远端实验的需求一致。

Assessment

该技能总体上是一致的，但在安装/使用前请注意： - 它会提示通过 pip 安装 famou-sdk（或 famou-ctl），请在受信任环境中执行并尽量在安装前核实包来源与作者；备用源 pip.baidu-int.com 可能是内部镜像，确认你是否信任该镜像。 - 脚本会把 API Key 以明文形式（但展示时掩码）写入 ~/.famou-ctl/settings.json；如果 API Key 权限很高，请确保文件系统权限恰当并只在你信任的机器上使用。 - 使用 famou-ctl 提交/查询实验会产生网络流量并把实验配置/日志上传到远端服务（默认 api_url 为 https://pro-service.famou.com），在提交敏感数据前确认该服务与你的隐私/合规要求匹配。 - 如果你希望更小的攻击面：在受控环境（容器或专用工作目录）中首次测试该技能，先用非生产/权限受限的 API Key 验证行为；也可在安装前查看 famou-sdk 的源码或从受信任来源安装。

Famou 任务管理 Skill

用于通过 famou-ctl-sdk 提交和管理实验任务的完整工作流。

---

前置环境检查

1.1 检查 famou-ctl-sdk 是否已安装

famou-ctl --version

• 若输出版本号，继续下一步
• 若命令未找到，执行安装：pip install famou-sdk
• 备用安装连接：pip install famou-sdk -i https://pip.baidu-int.com/simple --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 的父目录（绝对路径）作为实验目录：

# 示例：若 config.yaml 路径为 ./experiments/my_exp/config.yaml，则实验目录是 /absolute/path/to/experiments/my_exp
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 是否正确或网络连接