Flue Framework Skill — Development skill for Claude Code

---

name: flue-framework description: Flue Agent Framework v0.9.1+ — TypeScript harness-driven agent framework. Covers createAgent, init, defineTool, defineAgentProfile, routing, SSE streaming, production deployment, and all known pitfalls.

Flue Framework Skill

Flue is a TypeScript framework for building AI agents using the harness-driven architecture. This skill provides comprehensive guidance for creating, developing, and deploying Flue agents (tested with v0.9.1).

介绍怎样使用，很简单：

❯ 请先阅读文章Astro-flue简要.txt，新需求为利用skill: flue-framework 创建一个完整的 针对 skill:tikhub-api-helper （替换成你的skill）的社交网络信息搜索agent， 请你先给我具体方案

深度调研：Flue vs Claude Agent SDK（`@anthropic-ai/claude-agent-sdk`）——架构、差异与选型

---

0. 先定调：它们甚至不完全在同一个分类层上

这是整个对比里**最重要的一句话**：

**Flue 是 "Agent Harness / 框架层"**（怎么组织 agent、在哪跑、怎么隔离、怎么部署）；**Claude Agent SDK 是 "Claude Code 的可编程运行时"**（你把 Claude Code 当库用，它自带 agentic loop + 内置工具 + 权限，但你被绑定到 Claude 的生态与 CLI 架构）。

所以它们之间**不是简单的竞品关系**，更像两个不同哲学下的解答：

	Flue	Claude Agent SDK
回答的问题	"我怎么用一个框架把 agent 的定义、沙箱、session、部署形态标准化？"	"我想直接获得 Claude Code 级别的自主 agent 能力，包进我自己的服务里"
类比	Next.js/Astro for Agents（框架 + 约定）	Claude Code as a Library（平台运行时 API 化）

---

1. 两个项目分别是谁、出自哪、什么性质

Flue

项目	值
全称	Flue — The Agent Harness Framework / Sandbox Agent Framework
出处	https://github.com/withastro/flue（Fred K. Schott，Astro 联合创始人）
License	Apache-2.0
语言	TypeScript（全栈 TS 优先）
包	@flue/sdk（核心构建系统/sessions/tools）、@flue/cli、@flue/connectors
版本状态	Experimental，core runtime ~0.7.x，README 明确说 APIs may change / no formal GitHub Release
仓库活跃度	2025年5月发布公开预览，持续高频更新（3000+ stars，活跃 commit）
官方 slogan	"像 Claude Code，但 100% 无头（headless）且可编程。No TUI. No GUI. Just TypeScript."

Flue 的自我定位原话很关键：

*"Flue isn't another AI SDK. It's a proper **runtime-agnostic framework** — think Astro or Next.js, **but for agents**. Write once, build, an