关于 skelm

它是什么、为谁而生、以及它不是什么。

skelm 是什么

skelm 是 Node/TypeScript framework，工作单元是 typed pipeline：single agent、deterministic workflow、durable wait/resume flow 或 persistent chat workflow。Pipelines 从 CLI 运行，由 long-running gateway 托管，并在 explicit default-deny permissions 下集成 LLMs、agent runtimes、MCP servers 和 tool surfaces。

适合谁

面向构建 coding assistants、automation bots、queue workers、approval flows、compliance tools、research agents、dashboards 以及 chat/ticket triage workflows 的 TypeScript developers；这些场景需要 typed code、reviewable modules、isolation、audit 和 durable operation，而不是 node graph 或 JSON DSL。

三个原则，按此顺序

  1. 安全性. 处处 default-deny。Agent permissions 是 public API 的一部分，gateway 是 privileged actions、secrets、approvals、audit 和 enforcement 的唯一 trust boundary。
  2. 可维护性. 小 core、窄 public surface、可替换 internals。Workflows 是可以 grep、refactor、type-check、test 和 review 的 TypeScript modules。
  3. 健壮性. End to end typed context、explicit errors、deterministic event log、durable wait/resume、persistent session state，以及 long-running workflows 的 observable recovery paths。

状态

Version 0.4.7。API 在 v1 前仍不稳定；当前 docs 覆盖 quickstart、concepts、guides、recipes、backends 和 reference surfaces。