@agentworkforce/sage

中文文档
1.5.41发布于 2026/05/15TypeScriptES Module近 30 天下载 1730

研究,澄清,计划。 将分散的对话转化为可执行开发工作流程的AI代理.

中文使用文档
文档目录15 节
  1. 如何运作
  2. 建筑
  3. V1 (当前)
  4. 五. 2级
  5. 五.3
  6. 设置
  7. 先决条件
  8. 1. 安装依赖关系
  9. 2. 配置环境
  10. 3. 创建 Slack 应用程序
  11. 4. 在当地运行
  12. 5. 运用
  13. 以工作流程构建
  14. 项目结构
  15. PDERO 的一部分

贤人

研究,澄清,计划。 将分散的对话转化为可执行开发工作流程的AI代理.

圣贤是 计划 阶段 佩德罗 (计划,代表,执行,审查,央视). 它观察团队对话、跨越整合的研究、提出澄清问题并制订结构化计划,成为接力工作流程定义.

如何运作

你个 @sage 在 Slack (V2 中的WhatsApp 和 Telegram) 中。 贤曰:

  1. 研究 搜索网络和您的 GitHub 重置上下文
  2. 澄清 ——在跳出解决方案前提出探查问题
  3. 记得 ——通过Supermemory进行的对话持续记忆
  4. 计划 (V3)——将一切合成可执行中继工作流程

建筑

V1 (当前)

单代理Slack Webhook服务器,具有网页搜索和GitHub集成功能.

Slack Events API → Hono server → Sage agent (Sonnet 4.6) → Slack response
                                    ├── OpenRouter (web search)
                                    ├── GitHub (via Nango)
                                    └── Supermemory (persistent memory)

五. 2级

多平台(Slack + WhatsApp + Telegram),由多剂组通过车盖下 @agent-relay/gateway。 。 。 .

五.3

全面规划管线. 规划代理 (Opus 4.6) 将上下文合成结构化的计划并生成可执行接力工作流程定义.

设置

先决条件

  • 节点.js 20+
  • 代理转发 已安装 CLI
  • Slack 应用程序( Events API, 不是 Socket 模式)
  • GitHub 整合的南戈账户
  • OpenRouter API 密钥
  • 超模 API 密钥

1. 安装依赖关系

npm install

2. 配置环境

cp .env.example .env

填写:

变量来源目的
OPENROUTER_API_KEY开口/钥匙Sonnet 4.6+网络搜索
SUPERMEMORY_API_KEY超级记忆.ai持续记忆
SLACK_BOT_TOKENSlack app – OAuth 和权限瓶子身份( xoxb- )
SLACK_SIGNING_SECRETSlack app – 基本信息Webhook 校验
NANGO_SECRET_KEYapp.nango.dev (英语) — 设置Nango API 访问权
NANGO_GITHUB_CONNECTION_IDapp.nango.dev – 连接您的 GitHub 连接
SAGE_WORKSPACE_ID您选择( 如“ 默认 ” )内存命名空间
PORT可选( 默认: 3000)服务器端口

3. 创建 Slack 应用程序

  1. 转到 api.slack.com/应用程序 从零开始创建新 App
  2. OAuth 权限( C) - 瓶子范围:
    • app_mentions:read
    • chat:write
    • channels:history
    • channels:read
  3. 安装到工作区 — 复制 Bot Token
  4. 基本情况 - 复制签名秘密
  5. 事件订阅 启用 + 订阅机器人事件 : app_mention
  6. 将请求 URL 设定为您的公共 URL + /api/webhooks/slack

4. 在当地运行

npm run dev          # Starts Hono server on :3000
ngrok http 3000      # Expose webhook URL for Slack

将 ngrok URL 粘入 Slack 事件订阅为请求 URL :

https://your-ngrok-id.ngrok.io/api/webhooks/slack

5. 运用

提及 @sage 在任何Slack通道中:

  • "Node.js最好的队列库是什么?" ^ 网页搜索+综合
  • (原始内容存档于2013-10-12)
  • "我想加入实时通知" ——在规划前澄清问题
  • 回到同一个线 稍后 圣人记得背景

以工作流程构建

Sage通过接力工作流程来构建. 从零开始重建:

bash workflows/run-v1.sh      # Build V1 (~80 min)
bash workflows/run-v2.sh      # Build V2 (~130 min)
bash workflows/run-v3.sh      # Build V3 (~125 min)
bash workflows/run-all.sh     # Build everything (~5.5 hours)

见 工作流程/波浪计划 完全执行计划.

项目结构

src/
├── server.ts              # Hono HTTP server — webhook entry point
├── slack.ts               # Slack signature verification + event parsing
├── openrouter.ts          # OpenRouter client (Sonnet 4.6 + web search)
├── memory.ts              # Supermemory persistence layer
├── prompt.ts              # Sage system prompt / persona
├── nango.ts               # Nango client wrapper
└── integrations/
    ├── types.ts            # Shared integration types
    └── github.ts           # GitHub search, file read, PR diff via Nango

PDERO 的一部分

阶段探员作用
计划贤人 (这个回放)研究、澄清、计划
代表+执行梨树代理管弦乐图形界面
审查MSD 软件 + 键 轨迹守则审查+决定记录
观察夜视AI CTO 通讯
通讯代理中继代理通讯

版本与发布记录

@agentworkforce/sage 共发布 90 个版本,首次发布于 2026/04/10;过去 12 个月发布了 90 个版本。

版本发布日期距今
1.5.41latest2026/05/155 个月前
1.5.402026/05/086 个月前
1.5.392026/05/086 个月前
1.5.382026/05/076 个月前
1.5.372026/05/066 个月前
1.5.362026/05/066 个月前

关于 @agentworkforce/sage 的常见问题

@agentworkforce/sage 是什么?

研究,澄清,计划。 将分散的对话转化为可执行开发工作流程的AI代理.

如何安装 @agentworkforce/sage?

在项目目录运行 npm install @agentworkforce/sage,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 sage-vfs,可以用 npx sage-vfs 直接运行。

@agentworkforce/sage 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@agentworkforce/sage 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@agentworkforce/sage 可以商用吗?

@agentworkforce/sage 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@agentworkforce/sage 的下载量有多少?

根据 npm 官方下载统计,@agentworkforce/sage 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,730 次,日均约 58 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@agentworkforce/sage 还在维护吗?

最新版本 1.5.41 发布于 2026/05/15(5 个月前);至今共发布 90 个版本,其中过去 12 个月发布了 90 个;首次发布于 2026/04/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。