slug: fmode-skill-fmode-code-agent displayName: fmode-code-agent version: 0.1.1 name: fmode-code-agent description: "数字人开发基础规则：纯 JS 网页版 Bot 智能体开发（浏览器 + Node 双兼容、无构建）。Agent/MCP/Skill 三层分离、LangGraph.js 浏览器无构建配方、浏览器端 MCP（Web Worker）、token 实测、提交后自动部署。触发词:agent、智能体、MCP、Skill、LangGraph、function calling、工具调用、Re-act、Web Worker MCP、Agent 架构、token 实测、自动部署。" tags: [FmodeAgent, FmodeCode, 开发级, code-agent, 数字人基础规则] platform: Both level: 开发级 category: 开发规范 icon: 🤖 license: MPL-2.0 author: Fmode (未来飞马) homepage: https://github.com/fmodecn/fmode-code-agent

npm: "@fmode/skill-code-agent"

fmode-code-agent — 纯 JS 网页版 Bot 智能体

这是方便数字人（FmodeAgent / FmodeCode）进行项目开发的基础规则技能。 它把踩过的坑沉淀成硬性约束，让 AI 在生成代码时不重犯同类错误。

用纯 JS（浏览器 + Node 双兼容、无构建）写网页版 Bot 智能体：Agent 决策 / MCP 协议 / Skill 执行三层分离， LangGraph.js 浏览器直跑，token/速度实测，提交后自动部署。

npm 包：@fmode/skill-code-agent。完整规则见 references/RULES-INDEX.md 与其索引的 references/rules/。姊妹技能：fmode-code-lit（Lit 无构建前端），两者可叠加使用。

触发

新建网页内跑的智能体（对话 + 工具调用）· 把能力封装成 MCP 工具 / 接入多个 MCP · 用 LangGraph.js 做图编排（浏览器无构建）· 给智能体加 token/速度实测与输入输出比例 · 配自动部署。

一句话架构

Agent（决策：调不调工具、调哪个，可换框架）
  └─ MCP（协议：JSON-RPC 2.0，浏览器常跑在 Web Worker）
       └─ Skill（实现：纯函数式能力）

换 Agent 框架时，MCP 与 Skill 一行不改 —— 这是分层的验收标准。

四条铁律

浏览器 + Node 双兼容：核心纯 JS；fs/path 只在分发脚本里用。
不用构建：不引打包器；依赖走 importmap（浏览器）或 npm（Node）。
凭据不进 Worker / 日志 / 代码：要凭据的动作在主线程执行。
参数以实测为准：网关会静默忽略参数 —— 必须验证副作用，不能只看 200。

用法

npm i @fmode/skill-code-agent      # 安装（含本技能目录）

node scripts/scaffold.mjs ./my-agent --project my-agent   # 生成智能体骨架
node scripts/install-rules.mjs .                          # 给已有项目装规则
node scripts/smoke.mjs                                    # 自检（含 MCP 协议功能测试）

依赖版本（2026-10 实测可用）

@langchain/langgraph@1.5.1  @langchain/core@1.2.18
@langchain/langgraph-checkpoint@1.2.0  @langchain/protocol@0.0.19
uuid@11.0.5  zod@4.6.7

诚实失败

生成前先探测目标目录；已存在文件不覆盖（除非 --force）。未实测的能力（多 MCP 并发、HTTP/SSE 传输…）在规则里明确标注「未验证」，不写成规范。

SKILL.md 3.2 KB Historia Czysty