前言¶

多技能 Agent 常见做法是：人工挑选 Skill、固定编排、出问题再改提示词。预测该用哪些能力、把执行结果写回记忆、用健康度影响协作信任，往往要自己在业务里拼一套状态机。下面介绍 SkillHub 社区 Skill「PHOENIX v2.0 双循环智能体自主进化系统」（坐标 @user_23654e48/phoenix-v2），它在一份 SKILL 文档外加可运行的 Node 模块里，把「外循环」协作链路与「内循环」自我改进链路放在同一入口里描述和演示。

这是什么¶

PHOENIX v2.0 定位为双循环 AI Agent 生态：外循环覆盖技能预测、动态组合、版本树与信任网络；内循环覆盖学习闭环、记忆管理、规则引擎与健康监控，并通过 learn、composeGenes、createCapsule 等接口与外循环交汇。

• 维护与发布：SkillHub 社区来源（community），发布者 user_23654e48；SkillHub 页面标注作者「姝羽」。
• SkillHub 版本：1.0.1（与包内 package.json 的 2.0.0 并存，以商店页与 _meta.json 为准记录商店版本）。
• 分类与标签：ai-agent；requires_api_key=false，安装使用不依赖额外 API Key。
• 商店数据（SkillHub 抓取）：评分 100000，下载约 838 次（页面统计会变动，写作时以商店为准）。

官方入口：

• SkillHub 页面：https://www.skillhub.cn/skills/user_23654e48/phoenix-v2
• API 坐标：https://api.skillhub.cn/user_23654e48/phoenix-v2

核心功能¶

以下能力均来自已安装包内的 SKILL.md、README.md 与源码目录，按模块归纳。

外循环（协作进化）¶

1. 任务预测：predictTask(task, context) 分析任务并返回匹配套件（如 matched_genes、confidence）。
2. 执行与回写：execute(prediction) 走核心引擎执行；在 enableDualCycle 为真时，成功或失败都会调用 learn。
3. 组合与版本：composeGenes 在双循环开启时会向规则引擎取策略；createCapsule 可附带 memoryContext。
4. 信任网络：web-trust/ 模块；健康监控定时把分数同步到 webTrust.updateTrust（见 index.js 内 _startHealthMonitoring）。

内循环（自我进化）¶

self-evolution/ 包含：

• learning-loop.js：学习记录与准确率更新逻辑
• memory-manager.js：记忆读写
• rule-engine.js：规则评估与组合策略
• health-monitor.js：健康分与稳定性等指标

对外常用方法包括 getHealthScore()、getPredictionAccuracy()、getLearningRecords()、startSelfHealing()、getDashboard()。

统一入口与演示¶

• 主入口：index.js，通过 PHOENIX.create({ nodeId, enableDualCycle }) 创建实例。
• 演示脚本：node demo.js（package.json 中 npm run demo 同等）。
• 测试：tests/test_core.js（npm test 指向 test.js，若本地无 test.js 需以实际文件为准）。
• 运行环境：engines.node 要求 >=16.0.0；许可证 MIT；dependencies 为空。

说明：文档中的架构图列出了更细的文件名（如 gene-engine.js），当前 Skill 包以各子目录的 index.js 聚合实现为主，阅读时以安装目录实际文件为准。

安装与启用¶

1. 安装 SkillHub CLI¶

若尚未安装 CLI，按官方安装说明检查或安装：

command -v skillhub && skillhub --version

未安装时可执行（完整安装，含默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2. 安装本 Skill 到当前 Agent 的 skills 目录¶

SkillHub 要求安装时必须用 --dir 指向当前客户端的 skills 目录，否则默认落在 ./skills/ 且 Agent 可能无法加载。

Cursor：

skillhub install @user_23654e48/phoenix-v2 --dir ~/.cursor/skills/

Claude Code：

skillhub install @user_23654e48/phoenix-v2 --dir ~/.claude/skills/

Codex CLI： 用户目录或项目内二选一（以当前环境为准）：

skillhub install @user_23654e48/phoenix-v2 --dir ~/.codex/skills/
# 或项目下
skillhub install @user_23654e48/phoenix-v2 --dir .agents/skills/

安装完成后重启或重新加载 Agent，使其读取技能目录下的 SKILL.md。

SkillHub 页面亦支持将下列提示交给 AI 执行（与官方页一致）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_23654e48/phoenix-v2`。

3. 在 Node 中运行包内逻辑（可选）¶

Skill 包内含可执行演示，进入安装后的 phoenix-v2 目录即可：

node demo.js

SKILL.md 中还写了 git clone https://github.com/phoenix-ai/phoenix-v2.git 与 npm install 的手动路径；若你已通过 SkillHub 安装，一般无需再 clone，除非你要对齐上游仓库开发。

典型用法¶

下列示例摘自 SKILL.md / README.md，与包内 API 一致，可在安装目录内复现。

启动双循环实例¶

const PHOENIX = require('./index');

const phoenix = PHOENIX.create({
  nodeId: 'my_agent',
  enableDualCycle: true
});

console.log('健康度:', phoenix.getHealthScore());
console.log('预测准确率:', phoenix.getPredictionAccuracy());

enableDualCycle 默认为开启（构造函数里 config.enableDualCycle !== false）；设为 false 会跳过学习、健康与自愈相关路径。

预测 → 执行 → 自动学习¶

const prediction = phoenix.predictTask('处理API错误');
const result = phoenix.execute(prediction);

phoenix.learn({
  task: prediction.task,
  predictedSkills: prediction.matched_genes,
  executionResult: result,
  success: result.success
});

在双循环开启时，execute 已会自动调用 learn；上式展示的是显式调用形态。

健康分写入信任网络¶

const health = phoenix.selfEvolution.healthMonitor.getScore(agentId);

phoenix.webTrust.updateTrust(agentId, {
  healthScore: health.overall,
  stabilityScore: health.stability,
  errorRate: health.errorRate
});

实例运行后，每分钟健康检查也会向信任网络同步当前 nodeId（见 index.js）。

规则驱动的组合¶

const strategy = phoenix.selfEvolution.ruleEngine.getOptimalStrategy('api_secure');

const bundle = phoenix.composeGenes(selectedGenes, {
  strategy: strategy.recommended,
  priority: strategy.priorityMatrix
});

带记忆上下文的版本¶

const capsule = phoenix.createCapsule({
  gene: geneId,
  summary: 'API安全调用 v2',
  memoryContext: {
    relatedLearnings: phoenix.selfEvolution.memory.getRelevant(geneId),
    pastFailures: phoenix.selfEvolution.memory.getFailures('api_call')
  }
});

在双循环开启且传入 gene 时，createCapsule 也会自动填充 memoryContext 字段。

适用场景与注意¶

更适合谁

• 正在搭建多 Skill / Gene 编排，并希望用统一对象描述「预测—执行—学习—健康—信任」闭环的团队。
• 使用 OpenClaw 兼容栈、希望在 skills 目录里同时放 Agent 说明与可跑演示的 Node 模块的开发者。
• 需要演示脚本向同事说明双循环数据流的产品或架构角色（先跑 demo.js 再谈落地）。

使用上需要注意

1. 指标表述：文档与 demo.js 中有预测准确率、Token 节省等对比表与叙事；包内准确率为本地学习逻辑更新结果，并非独立第三方测评，生产环境应接真实遥测再评估。
2. 版本号：SkillHub 登记 1.0.1，包内 package.json 为 2.0.0，对接工单或依赖声明时两边都要核对。
3. Agent Skill 与运行时：装入 Cursor 等目录后，Agent 主要遵循 SKILL.md 中的架构与示例；真正调用 PHOENIX.create 需在 Node 进程或你自建的服务里引用安装路径。
4. 后台任务：双循环开启后会 setInterval 做分钟级健康检查，长期驻留进程时要考虑进程生命周期与资源占用。
5. 商业模式文案：SKILL.md 提及专业版 / 企业版价格，属于作者文档说明，与 SkillHub 免费安装条目分开理解。

结尾¶

PHOENIX v2.0 把外循环协作（预测、组合、版本、信任）和内循环自改进（学习、记忆、规则、健康）写在同一 Skill 与同一 index.js 入口里，适合作为多智能体编排的原型与演示底座。若要安装或查看详情，请打开 SkillHub 官方页：https://www.skillhub.cn/skills/user_23654e48/phoenix-v2 ，API 坐标：https://api.skillhub.cn/user_23654e48/phoenix-v2 。