convez.ai
AgenteDevOps & InfraestruturaAvançado
hongmaple0820

SCALE Engine

hongmaple0820/scale-engine

Governança de código para Agents via restrições executáveis, não apenas prompt engineering

Ver no GitHub
BomPluginScore · de 0 a 100

Motor de engenharia para AI Agents que implementa restrições físicas (comandos, portas e registros de evidência) garantindo conformidade a padrões de engenharia. Coordena exploração, planejamento, implementação, verificação, revisão e deploy com rastreabilidade completa de ações e resultados.

Instalação

$npx convez-ai hongmaple0820/scale-engine

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
61
Forks
8
Acompanhando
0
Saúde
71%
Último commit
há 1 dia
Versão
v0.58.0
Issues abertas
17
Contribuidores
10

Casos de uso

  • Validar que Agents realmente testaram código antes de afirmar sucesso
  • Forçar ciclos completos de requisito, design, TDD e review automaticamente
  • Coordenar múltiplas sessões de Agents evitando conflitos de git e workspace
  • Orquestrar workflows em múltiplos repositórios com branch/merge disciplinado

Veredito

Solução madura (v0.50.6) que resolve problemas reais de confiabilidade em automação com Agents. Exige Node.js 20+ e investimento em entender governance profiles, mas elimina gaps críticos entre o que Agents dizem fazer e o que realmente fazem.

README

A tradução para o português deste README ainda está na fila.

RepoStars

SCALE Engine v0.50.6

SCALE Engine 让 AI Agent 不再只靠"自觉"遵守工程规范。它把探索、规划、实现、验证、评审、发版这些要求变成可执行的命令、门禁和证据文件,让人类可以看见 Agent 做了什么、跳过了什么、为什么能交付或不能交付。

源码仓库:https://github.com/hongmaple0820/scale-engine 国内镜像:https://gitee.com/hongmaple/scale-engine npm:https://www.npmjs.com/package/@hongmaple0820/scale-engine 语言:中文 | English 更新记录:CHANGELOG.md

它解决什么问题

常见问题SCALE 的处理方式
Agent 没验证却说"测试通过"通过 verification profile 和 evidence store 记录真实命令与结果
Agent 跳过需求澄清、设计、TDD 或 review通过 scale context、scale diagnose、scale tdd、scale status 生成下一步动作
Agent 攒代码不提交,最后难以分段通过 Commit Discipline 监控 git 状态,双阈值告警,自动分组建议
Agent 误提交无关文件或跨仓库改错位置通过 review-gated ship、MOE workspace 和子仓库 blocker 控制边界
多会话并行开发产生冲突通过 Session Coordinator 文件重叠检测、冲突记录、依赖拓扑排序
多仓库项目 Git 工作流混乱通过 Cross-Repo Orchestrator 协调分支、合并计划、ship 流水线

3 分钟看到效果

mkdir scale-demo && cd scale-demo
npx -y @hongmaple0820/scale-engine@latest quickstart --dir . --profile standard
npx -y @hongmaple0820/scale-engine@latest setup --dir .
npx -y @hongmaple0820/scale-engine@latest preflight --preflight-profile quick --dir .

你会得到一套可提交到项目里的治理文件:

  • .scale/verification.json:服务矩阵和验证 profile
  • .scale/skills.json:skill 路由和证据要求
  • .scale/tools.json:CLI/MCP/browser/desktop 工具编排规则
  • docs/workflow/templates/:Mini-PRD、plan、verification、review、summary 模板
  • docs/standards/:工程规范、Git 协作、资源治理规则

继续体验完整闭环:

scale context grill --task-id TASK-001 --task "加固 OAuth callback"
scale diagnose plan --task-id TASK-001 --symptom "callback 在 state 过期时返回 500"
scale tdd slice --task-id TASK-001 --behavior "拒绝过期 OAuth state" --failing-test "expired state returns 401"

完整教程见 npx 与交互式安装指南、3 分钟快速开始、22 种 Agent 安装与使用教程 和 官方 Demo Walkthrough。如果你在评估 SCALE 和其他工作流的差异,先看 工作流能力与横向对比。

安装

首次试用推荐 npx,不需要全局安装:

npx -y @hongmaple0820/scale-engine@latest onboard --lang zh
npx -y @hongmaple0820/scale-engine@latest init --interactive --dir .

长期高频使用再安装全局 CLI:

npm install -g @hongmaple0820/scale-engine
scale --version

需要 Node.js 20 或更高版本。

如果你希望把 UI skills、RTK、记忆/知识图谱这类第三方能力一起补齐,使用显式 bootstrap,而不是依赖静默自动安装:

scale setup --pack full --memory-provider gbrain --memory-mode external-first --json
scale setup --pack full --memory-provider gbrain --memory-mode external-first --apply --yes
scale setup --verify --pack full --json

setup 默认先出计划;只有显式加 --apply --yes 才会执行安装命令。记忆供应商当前只走 gbrain,知识/代码图谱能力由 knowledge 包验证 CodeGraph 和 Graphify 的真实可用性。

安装入口变更后,先跑安装烟测:

npm run smoke:setup
make setup-smoke

它会验证中英文安装输出、运行时依赖诊断、记忆供应商切换,以及 Graphify/CodeGraph 状态路径;不会执行真实第三方安装。

如果用户机器出现 Windows/Unix 命令差异、PATH 不对、缺 Python/Bun/Cargo/RTK 等问题,先跑:

scale doctor env --json

适合谁

  • 正在用 Codex、Claude Code、Cursor、Gemini CLI、OpenCode、Aider 等 Agent 写真实项目的团队。
  • 有多服务、多仓库、MOE workspace、前后端分离需求的团队。
  • 希望 Agent 主动使用 skills、MCP、CLI、浏览器、E2E,但又需要安全边界和证据闭环的团队。
  • 经常遇到"AI 改得快,但难审、难验、难维护"的项目负责人。

核心能力

能力说明
Workflow Enginedefine → plan → build → verify → review → ship 阶段化交付状态机
Gate Systembuild、lint、test、coverage、security、TDD、review 门禁
AI OS Runtimescale ai-os plan/run/status — 任务规划、受控运行、治理仪表盘
Commit Discipline监控 git 状态,双阈值告警,自动分组未提交文件
Session Coordinator多会话并行协调,文件重叠检测,冲突记录
Cross-Repo Orchestrator多仓库 Git 工作流编排,协调分支/合并/ship
Task Dependency GraphDAG 依赖声明,拓扑排序,环检测
Ship Pipeline8 步 ship 闭环,支持 dry-run、skip、version bump
Security AuditOWASP Top 10 + STRIDE 安全审计引擎
Role Skills6 个角色化审查视角(eng-manager、security-reviewer、qa-lead 等)
Memory Intelligence6 信号质量评分,跨 provider 冲突检测,新鲜度衰减
Governance ROI端到端治理 ROI 度量 — token 成本 vs 质量 vs 门禁摩擦
Scale Shield退出码钩子拦截引擎 — YAML 策略 → hook 脚本编译,40+ 危险命令阻断,退出码协议
Scale Orchestrator声明式编排守护进程 — SCALE_POLICY.md 策略驱动,git worktree 隔离,协调循环
Scale Cortex证据驱动持续进化 — 本能提取 (Instincts 0.3-0.9),SessionStart 注入,跨 harness 适配器

SCALE 2.0 三引擎架构

SCALE 2.0 引入三层引擎,对齐业界前沿项目的核心模式:

引擎对标项目核心能力
Scale Shieldagent-hooks-in-depth退出码阻断 (exit 0/2)、stdin/stdout JSON 协议、40+ 危险命令拦截、.scale/ 完整性保护
Scale OrchestratorSymphony WORKFLOW.md声明式策略驱动、git worktree 隔离、协调循环、多轮 Worker
Scale CortexECC Instincts观察→模式→本能提取 (置信度 0.3-0.9)、SessionStart 注入、跨 harness (Claude/Codex/Cursor/Gemini)
# Shield: 编译策略并安装 hook
scale shield compile
scale shield status

# Orchestrator: 启动声明式编排守护进程
scale orch start
scale orch status

# Cortex: 从失败中学习
scale cortex evolve
scale cortex metrics --days 30
scale cortex inject --minimal

AI OS Runtime

Agent role planning is available through scale agent plan --task "<task>" --json and the dashboard Prompt Studio; the generated agentCollaboration plan includes selected agent profiles, DAG edges, handoff contracts, review gates, and per-role token budget. The same plan is embedded in scale ai-os plan/run; guarded runs with verification commands now add agentExecution settlement evidence, and scale ai-os status --json reports both through the agent-collaboration intelligence signal.

AI OS Runtime 是 SCALE 的核心运行时规划层。scale ai-os plan 在一次命令里生成风险治理模式、Context Compiler 预算、Memory Provider 召回、Skill Routing 执行计划和 Governance ROI,让 Agent 在开始任务前就知道应该加载什么上下文、调用什么能力、补什么证据。

scale ai-os plan \
  --task-id TASK-123 \
  --task "修复 OAuth callback auth token 并验证浏览器回调流程" \
  --level L \
  --files src/auth/oauth.ts,src/ui/callback.tsx \
  --budget 8000 \
  --json

详细命令见 AI OS Runtime 文档。

学习路径

目标入口你应该学会什么
无全局安装试用npx 与交互式安装指南用 npx 跑 onboard、init --interactive、setup
先跑起来3 分钟快速开始安装 CLI、初始化治理文件、运行 preflight
接入具体 Agent22 种 Agent 安装与使用教程Codex、Claude Code、Cursor、Cline、Windsurf 等 22 个 adapter 的初始化、验证和面板入口
看完整闭环官方 Demo Walkthrough任务上下文、诊断、TDD、artifact 和验证证据如何串起来
横向评估工作流能力与横向对比与 LangGraph、AutoGen、CrewAI、gstack、Superpowers、ECC、GitHub Agentic Workflows 的定位差异
接入已有项目SCALE 工作流升级指南init、upgrade check/plan/apply、本地 make 包装入口
选择治理包Governance Pack 文档不同项目形态应该选哪个 pack
维护或扩展 SCALEdocs/README.md文档地图、内部模块和长期维护资料
开发本仓库docs/guides/GETTING_STARTED.mdscale-engine 仓库自身的工程化工作流

更新工作流

scale upgrade check --dir . --lang zh
scale upgrade plan --dir . --html --lang zh
scale upgrade apply --dir . --confirm --lang zh

SCALE 把升级分成三层:CLI 自身、已生成到项目里的 governance pack 文件、第三方 skills/MCP/CLI 能力。默认只检查和生成计划,不自动覆盖用户改过的文件。详见 SCALE 工作流升级指南。

开发本仓库

make preflight
make gate-workflow
make gate-quality
make verify PROFILE=default

入口文档:

社区与推广

平台链接说明
GitHubhttps://github.com/hongmaple0820/scale-engine源码、Issues、PR
Giteehttps://gitee.com/hongmaple/scale-engine国内镜像与反馈
npmhttps://www.npmjs.com/package/@hongmaple0820/scale-engineCLI 包下载
QQ 群628043364国内用户交流、问题反馈
邮箱2496155694@qq.com合作、反馈、建议

赞赏与支持

如果 SCALE Engine 节省了你的工程治理时间,或帮助你的团队把 AI Agent 工作流落到可验证、可复盘、可发版的闭环里,欢迎赞赏支持。赞赏用于持续维护、示例项目、文档、测试矩阵和社区支持。

License

MIT

Ver o original no GitHub

Bom para

Relacionados