📦 Rotifer Guide — Rotifer 协议用户入口

此技能处理意图识别和工作流路由。深层技术细节委托给专业技能处理。

前置条件

使用此技能前，请确保 Rotifer CLI 可用：

npx @rotifer/playground --version

如需 MCP 集成而非 CLI，请将以下配置添加到 MCP config：

{
  "mcpServers": {
    "rotifer": {
      "command": "npx",
      "args": ["@rotifer/mcp-server"]
    }
  }
}

无需版本锁定——两个包都会自动解析到最新版本。

意图路由

相关技能

1. onboarding — 交互式引导

阶段 1：环境检查

cd rotifer-playground
node dist/index.js --version
node dist/index.js list

如未安装，引导：git clone → npm install → npm run build。

阶段 2：核心概念

阶段 3：实践经验

引导用户完成 Gene 的完整生命周期：

rotifer init hello-world --domain content.greeting --fidelity Wrapped
rotifer test hello-world
rotifer compile hello-world
rotifer arena submit hello-world
rotifer arena list --domain content.greeting

每步后解释输出，确认用户理解后再继续。

阶段 4：后续步骤

根据用户背景推荐：

• 有现有 SKILL.md → 脚手架（rotifer wrap）
• 想浏览生态 → explorer
• 想深入了解 → 路由到 gene-dev/SKILL.md

2. scaffold — 自然语言脚手架

阶段 1：意图提取

从用户自然语言描述中提取：

阶段 2：确认参数

向用户展示推断结果，等待确认后再执行。

阶段 3：脚手架生成

从零开始：

rotifer init  --domain  --fidelity 

从现有 SKILL.md：

rotifer scan --skills rotifer wrap  --from-skill 

从 ClawHub：

rotifer wrap  --from-clawhub 

阶段 4：验证

rotifer test 
rotifer compile 

编译通过后，提示：发布到 Cloud（rotifer publish）或提交到 Arena（rotifer arena submit）。如需更深入的开发细节（inputSchema 设计、express 函数实现）→ 路由到 gene-dev/SKILL.md。

3. doctor — 诊断与修复

决策树

用户报告问题
  |
  +-- F(g) = 0 或异常低分
  |   +-- rotifer test  通过了吗？
  |       +-- 失败 → 检查 express() 返回值是否匹配 outputSchema
  |       +-- 通过 → 检查 phenotype.json domain 是否合理
  |
  +-- 同域有竞争者吗？
  |   +-- 有 → 分析竞争者优势，建议优化
  |
  +-- 发布失败
  |   +-- rotifer compile  成功了吗？
  |       +-- 失败 → 检查语法错误、缺失依赖
  |       +-- 成功 → 检查网络连接、云凭证
  |
  +-- phenotype.json 格式有效吗？
  +-- 编译失败
  |   +-- 检查 index.ts 中导出的 express 函数签名
  |   +-- 检查 phenotype.json 中的 inputSchema / outputSchema
  |   +-- 检查 fidelity 声明是否匹配实际代码
  |       +-- 声明 Native 但有 fetch 调用 → 改为 Hybrid 或移除网络调用
  |
  +-- 运行时错误
      +-- rotifer test  --verbose
      +-- 检查输入是否符合 inputSchema
      +-- 检查 express() 是否正确处理边界情况

常用诊断命令

rotifer test 
rotifer list
rotifer arena list --domain 

快速参考

4. explorer — 生态搜索

阶段 1：理解需求

从用户描述中提取：功能关键词、目标域名、fidelity 偏好。

阶段 2：搜索

rotifer arena list
rotifer arena list --domain 
rotifer list

阶段 3：结果分析

以表格形式展示搜索结果：

阶段 4：推荐

• 找到匹配的 Gene → 建议安装：rotifer install
• 找到部分匹配 → 建议 fork 并修改，或提交 Arena 挑战（路由到 rotifer-arena/SKILL.md）
• 未找到 → 建议创建新 Gene（路由到 scaffold）

5. upgrade — Fidelity 进化

阶段 1：评估当前状态

rotifer list

检查目标 Gene 的 phenotype.json — 确认当前 fidelity 和 express() 实现。

阶段 2：迁移路径决策

阶段 3：执行迁移

确认迁移计划后，路由到 gene-migration/SKILL.md 获取完整迁移工作流。

阶段 4：验证

rotifer test 
rotifer compile 
rotifer arena submit 

比较迁移前后的 F(g) 分数，确认排名连续性。