Communitygithub.com

imMamdouhaboammar/agentic-workflow

多能干细胞框架与通用智能体工具链,用于自主多智能体工作流。

agentic-workflow 是什么?

AgenticWorkflow 是一个多能干细胞框架与多智能体执行引擎,旨在将复杂任务转化为确定性、自我验证的自主工作流。它支持设计(DESIGN)、执行(EXECUTE)、自动驾驶(AUTOPILOT)、超严格模式(ULW)、验证(VERIFY)和优化(OPTIMIZE)等多种运行模式,每种模式都有对应的触发词和核心执行流程。其核心理念是三个绝对标准:最终交付物质量优先、单文件状态对象树(SOT)加层次化内存、以及代码变更协议。系统内置四层质量保证栈(L0防跳过守卫、L1验证门、L1.5预测性智能体置信度评分pACS、L2对抗性审查),以及工作流优化引擎(瓶颈分析、自动化潜力评估、错误减少与周期压缩)、自主自补能引擎与断路器、清洁代码守卫和AI工程评估模块。用户可通过CLI工具链轻松启动自动执行、代码审查、测试、状态查询等操作。

兼容平台✓Claude Code~Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add imMamdouhaboammar/agentic-workflow

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

AgenticWorkflow:通用智能体技能与执行工具链

一种多能干细胞框架和多智能体执行引擎,将复杂任务转化为确定性、自我验证的自主工作流。

执行不变量

$$\text{意图} \xrightarrow{\text{研究}} \text{计划(SOT state.yaml)} \xrightarrow{\text{实现}} \text{四层质量门} \xrightarrow{\text{pACS 增量}} \text{已验证的交付物}$$


⚡ 动态模式路由器

从上下文或显式标志中检测所需的模式:

模式触发短语核心执行流
1. DESIGN(设计)"design workflow"、"new pipeline"、"workflow.md"研究 → 规划 → 实现三阶段蓝图生成
2. EXECUTE(执行)"run workflow"、"execute pipeline"、"start step"SOT状态机驱动,逐步生成交付物
3. AUTOPILOT(自动驾驶)"autopilot"、"fully automated"、"hands-off"自动批准 (human) 检查点,记录决策日志;强制启用安全挂钩
4. ULW(超严格工作)"ulw"、"ultrawork"、"maximum rigor"三个增强器:西西弗斯持久性、强制分解、重试升级
5. VERIFY(验证)"verify step"、"quality gates"、"run pacs"L0防跳过 → L1验证 → L1.5 pACS → L2对抗性审查
6. OPTIMIZE(优化)"optimize workflow"、"reduce cycle time"、"streamline"精益瓶颈分析、自动化评分、周期时间压缩

三个绝对标准(宪法准则)

由此技能创建或管理的每个工作流、工具和子智能体都严格继承三个绝对标准:

  1. 绝对标准 1:最终交付物的质量

    完全忽略速度、代币成本、工作量和长度限制。每个决策的唯一标准是最终交付物的质量。

  2. 绝对标准 2:单文件 SOT + 层次化内存

    所有共享状态集中在一个文件(state.yaml)中。SOT写入权限专属于编排器/团队负责人。并行智能体从不同时修改共享文件。

  3. 绝对标准 3:代码变更协议(CCP)

    在编写、修改、添加或删除代码之前,内部执行:步骤1(理解意图)→ 步骤2(涟漪效应分析)→ 步骤3(变更计划)。受编码锚点(CAP-1~4)约束。


四层质量保证栈

flowchart TD
    StepStart["步骤执行"] --> L0["L0:防跳过物理守卫(文件存在且 >= 100 字节)"]
    L0 -->|通过| L1["L1:验证门(100% 功能目标达成)"]
    L0 -->|失败| Diag["溯因诊断"]
    L1 -->|通过| L15["L1.5:pACS 自评分(F/C/L 事前评分)"]
    L1 -->|失败| Diag
    L15 -->|红色:<50| Diag
    L15 -->|绿色/黄色| L2["L2:对抗性审查(@reviewer + @fact-checker)"]
    L2 -->|通过| SOT["推进 SOT(current_step + 1)"]
    L2 -->|失败| Diag
    Diag --> Retry["使用替代假设重试(最多 3 次)"]
  1. L0 防跳过守卫:确定性验证交付物存在于磁盘上且非空(MIN_OUTPUT_SIZE >= 100 字节)。
  2. L1 验证门:语义验证所有验收标准 100% 达成。
  3. L1.5 pACS(预测性智能体置信度评分):在忠实度、完整性和逻辑方面进行事前评估。$pACS = \min(F, C, L)$。
    • 绿色(>= 70):自动推进。
    • 黄色(50 - 69):在决策日志中标记薄弱维度并继续。
    • 红色(< 50):停止并触发返工。
  4. L2 对抗性审查:由 @reviewer 和 @fact-checker 进行独立的生成器-批评者评估。

工作流优化引擎(精益与自动化)

在分析或优化工作流时:

  • 瓶颈严重性:对瓶颈进行 1 到 5 分的评分。
  • 自动化潜力:量化适合智能体委托的手动任务。
  • 错误减少:在故障传播之前,在根本原因处实施质量门。
  • 周期时间缩减:目标是减少 >= 40% 的周期时间,同时提高交付物质量。

自主自补能引擎与断路器

系统作为一个端到端的自主引擎运行,并带有内置的能量管理:

  1. 自补能与能量循环:动态代币和上下文余量监控,在上下文耗尽前自动进行 RLM 状态压缩和补能检查点。
  2. Fable 断路器:状态转换 CLOSED → OPEN → HALF_OPEN。当连续失败次数 $\ge 2$ 时,自动停止推测性抖动,通过溯因诊断(diagnose_context.py)隔离根本原因,并执行结构化恢复。
  3. 清洁代码守卫:自动 AST 守卫通道,检查 24 条清洁代码准则(小型函数、意图揭示名称、最多 4 个参数、不吞没异常、不使用虚假成功模拟)。
  4. AI 工程评估:集成的五分之四差异影响测试($\ge 0.80$)、PSI 分布漂移监控以及对抗性提示注入净化。

CLI 与工具链集成

# 启动带有自补能与能量管理的端到端自动驾驶工作流
agentic-workflow autopilot --title "Production Pipeline" --goal "Autonomous Delivery"

# 运行清洁代码守卫审计(SOLID、24 条准则、AI 故障模式)
agentic-workflow guard [directory]

# 执行 AI 工程师公平性、漂移和提示注入评估门
agentic-workflow eval

# 查询多智能体可观测跟踪日志和跨度
agentic-workflow traces

# 初始化基础设施、SOT 运行时目录和健康检查
agentic-workflow init

# 验证工作流模式、SOT 完整性和 pACS 日志
agentic-workflow validate

# 检查实时工作流仪表板和可观测性指标
agentic-workflow status

# 运行完整的自动化测试套件(安全性、守卫、MAS、评估器)
agentic-workflow test

参考地图

  • 架构与DNA:soul.md、AGENTICWORKFLOW-ARCHITECTURE-AND-PHILOSOPHY.md
  • 操作手册:AGENTICWORKFLOW-USER-MANUAL.md
  • 通用指令:AGENTS.md、CLAUDE.md、GEMINI.md
  • 协议:docs/protocols/(autopilot-execution、quality-gates、ulw-mode、code-change-protocol、context-preservation-detail)
  • 子智能体:.claude/agents/(reviewer、fact-checker、translator)
  • 脚本:.claude/hooks/scripts/(context_guard、validate_pacs、validate_review 等)

相关技能