能力标签

⚙️

Agent工作流

AI工作流

基于 TypeScript · 无代码搭建完整 AI 自动化流程

英文名：ax

⭐ 9 Stars 🍴 1 Forks 💻 TypeScript 📄 NOASSERTION 🏷 AI 8.0分

8.0AI 综合评分

AI工作流TypeScript智能代理

⚙️ 配置说明

✦ AI Skill Hub 推荐

经 AI Skill Hub 精选评估，AI工作流获评「强烈推荐」。这款Agent工作流在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 8.0 分，适合有一定技术背景的用户使用。

📚 深度解析

AI工作流是一套完整的 AI Agent 自动化工作流方案。随着 AI 能力的不断提升，基于 Agent 的自动化工作流正在成为提升个人和团队效率的核心方式。区别于传统的 RPA 自动化（模拟鼠标键盘操作），AI Agent 工作流通过理解任务意图、动态规划执行路径，能够处理更复杂的非结构化任务。

AI工作流工作流的设计遵循"最小配置，最大复用"原则：核心逻辑已经封装好，用户只需配置自己的 API Key 和业务参数即可快速上手。工作流内置错误处理和重试机制，在网络波动或 API 限速等情况下仍能稳定运行，适合作为生产环境的自动化基础设施。

在实际部署时，建议先在测试环境中运行 3-5 次，验证各个环节的输出结果符合预期，再部署到生产环境。AI Skill Hub 评分 8.0 分，是同类 Agent 工作流中的精选推荐。

📋 工具概览

AI工作流是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。

GitHub Stars

⭐ 9

开发语言

TypeScript

支持平台

Windows / macOS / Linux

维护状态

轻量级项目，按需更新

开源协议

NOASSERTION

AI 综合评分

8.0 分

工具类型

Agent工作流

Forks

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

📌 核心特色

可视化 Agent 工作流编排，无需编写复杂代码
支持多步骤自动化任务链，实现全流程无人值守
与外部 API、数据库和第三方服务无缝集成
内置错误处理与自动重试机制，保障稳定运行
提供可复用的自动化模板，快速在同类场景部署

🎯 主要使用场景

自动化日常重复性工作，将精力集中于创造性任务
构建数据采集 → 处理 → 输出的完整自动化管线
实现跨平台、跨系统的数据流转和业务协同

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：npm 全局安装
npm install -g ax

# 方式二：npx 直接运行（无需安装）
npx ax --help

# 方式三：项目依赖安装
npm install ax

# 方式四：从源码运行
git clone https://github.com/Necmttn/ax
cd ax
npm install
npm start

📋 安装步骤说明

访问 GitHub 仓库获取工作流文件
在对应平台（Dify / Flowise / Make 等）中找到「导入工作流」功能
上传工作流文件
按照提示配置必要的环境变量和 API Key
运行测试确认流程正常后投入使用

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 命令行使用
ax --help

# 基本用法
ax [options] <input>

# Node.js 代码中使用
const ax = require('ax');

const result = await ax.run(options);
console.log(result);

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

# ax 配置说明
# 查看配置选项
ax --config-example > config.yml

# 常见配置项
# output_dir: ./output
# log_level: info
# workers: 4

# 环境变量（覆盖配置文件）
export AX_CONFIG="/path/to/config.yml"

📑 README 深度解析真实文档完整度 52/100 含工作流图查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

ax

###### the retro loop for AI coding agents

Make your agent learn. Reflects. Experiments. Improves. Across every session.

---

Every sub-agent you spawn finishes its work and disappears. Whatever it figured out - which command failed three times before the right one, which file actually mattered, which approach to skip - dies with it. The next sub-agent rediscovers it from scratch. Your own next session does too.

ax is the loop that closes before the session ends. A Stop hook fires at session-end (main or sub-agent), asks the agent for a structured retro (tried · worked · failed · next), and indexes the result as a typed experiment in a local graph. Friction patterns become proposals you triage. Accepted proposals become experiments with t+7 / t+30 / t+90 verdicts. The next session reads what worked.

What did this sub-agent learn? Which experiments are still open? Which skills earned their keep? Which hooks blocked anything useful? ax answers these by reading what already happened.

ax · the retro loop for AI coding agents

Install

curl -fsSL https://raw.githubusercontent.com/Necmttn/ax/main/install.sh | bash
PATH="$HOME/.local/bin:$PATH" axctl ingest --since=7

Skills are distributed via the skills.sh marketplace. After the CLI is installed, drop the agent skills into your Claude Code session with:

npx skills add Necmttn/ax           # installs ax:setup + ax:retro skills

Requires Bun ≥ 1.3 and SurrealDB ≥ 3.0. macOS-first; Linux works for ingest and CLI (no launchd reactivity).

For dev install, schema, queries, and benchmarks, see docs/development.md.

Quickstart

axctl ingest --since=7     # backfill last 7 days of transcripts + skills + git
axctl serve                # live dashboard at http://127.0.0.1:8520
axctl skills taste         # CLI view: which skills earned their keep
axctl recall "auth bug"    # full-text recall across past sessions

CLI shape

axctl ingest [--since=N] [--reset]         # backfill the graph
axctl ingest here [--since=Nd]             # scope ingest to the git repo at $PWD
axctl derive-signals                        # re-run derive pass standalone
axctl derive-intents                        # re-run user-intent derive standalone
axctl serve                                 # live web dashboard (API for ax studio)
axctl report                                # one-shot static HTML
axctl tui                                   # interactive terminal dashboard

axctl recall <query> [--sources=turn,commit,skill] [--scope=here|all]
                                            # cross-session BM25 full-text search
axctl context [file] [<query>]              # file/agent-context grounding
axctl skills <search|taste|unused|pairs|recovery|classify|tag|lint|weighted|by-role|roles>
axctl insights <view>                       # 19 read-only graph views
axctl classifiers <list|eval|explain>       # classifier coverage and turn explanations
axctl costs <summary>                       # token/cost usage by provider/model quality
axctl sessions <here|around <date>|near <sha>|show <id>>
                                            # windowed session queries
axctl costs summary [--since=N]             # estimated token cost by provider/model
axctl costs for --session <id>              # cost for one session
axctl costs for --query <text> [--limit=N]  # cost for sessions matching turn text
axctl costs for --terms <a,b,c> [--since=N] # cost for sessions matching any term
axctl costs for --commit <sha>              # cost for sessions that produced a commit
axctl costs for --branch <name>             # cost for sessions linked to a branch
axctl pricing [--query <model>]             # inspect imported model pricing rows
axctl share <session-id>                    # publish a sanitized session share via GitHub Gist
axctl roles                                 # list role labels with skill counts
axctl project <context|verify|harness>
axctl evidence <guidance-next|session-summary|weekly>
axctl improve <list|show|accept|reject|verdict|checkpoint|reset>
axctl retro <emit|list|reflect|plan>        # the retro-loop CLI
axctl hook <fire>                           # hook helper invoked from settings.json
axctl hooks <summary|invocations|backtest>

axctl daemon <status|start|stop|restart>
axctl doctor                                # local-install health check
axctl install                               # wire launchd + hooks + DB
axctl uninstall                             # remove launchd + bin symlink
axctl update [--check]                      # pull latest release
axctl version [--check|--banner]

Full reference: docs/insights-cli-reference.md.

Agent integration

ax ships two installable skills so a Claude Code / Codex agent can query its own evidence graph mid-session:

npx skills add git@github.com:Necmttn/ax.git --skill axctl    -g -a claude-code -a codex -y
npx skills add git@github.com:Necmttn/ax.git --skill retro -g -a claude-code -a codex -y

Recommended agent loop:

1. axctl project context --json before work - stack, recent friction, verification commands. 2. Do the work. 3. axctl project verify --json before reporting done - runs the checks the project actually expects.

🎯 aiskill88 AI 点评 A 级 2026-06-01

高质量的开源AI工作流项目，值得关注