@hongmaple0820/scale-engine

v0.50.10

Published

a day ago

Executable AI agent governance with workflow gates, evidence, skill/tool orchestration, and traceable HTML artifacts

0High
0Medium
0Low

hongmaple0820

SCALE Engine v0.50.10

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/skills/：随仓库提交的通用 workflow skills 主来源；旧 skills/ 仅作为兼容 fallback
.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 Engine | define → plan → build → verify → review → ship 阶段化交付状态机 | | Gate System | build、lint、test、coverage、security、TDD、review 门禁 | | AI OS Runtime | scale ai-os plan/run/status — 任务规划、受控运行、治理仪表盘 | | Commit Discipline | 监控 git 状态，双阈值告警，自动分组未提交文件 | | Session Coordinator | 多会话并行协调，文件重叠检测，冲突记录 | | Cross-Repo Orchestrator | 多仓库 Git 工作流编排，协调分支/合并/ship | | Task Dependency Graph | DAG 依赖声明，拓扑排序，环检测 | | Ship Pipeline | 8 步 ship 闭环，支持 dry-run、skip、version bump | | Security Audit | OWASP Top 10 + STRIDE 安全审计引擎 | | Role Skills | 6 个角色化审查视角（eng-manager、security-reviewer、qa-lead 等） | | Memory Intelligence | 6 信号质量评分，跨 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 Shield | agent-hooks-in-depth | 退出码阻断 (exit 0/2)、stdin/stdout JSON 协议、40+ 危险命令拦截、.scale/ 完整性保护 | | Scale Orchestrator | Symphony WORKFLOW.md | 声明式策略驱动、git worktree 隔离、协调循环、多轮 Worker | | Scale Cortex | ECC 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 | | 接入具体 Agent | 22 种 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 | | 维护或扩展 SCALE | docs/README.md | 文档地图、内部模块和长期维护资料 | | 开发本仓库 | docs/guides/GETTING_STARTED.md | scale-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

入口文档：

docs/guides/GETTING_STARTED.md — 15 分钟上手
docs/guides/DEVELOPMENT_WORKFLOW.md — 日常开发闭环
docs/workflow/README.md — 门禁、分支策略和升级入口

社区与推广

| 平台 | 链接 | 说明 | |------|------|------| | GitHub | https://github.com/hongmaple0820/scale-engine | 源码、Issues、PR | | Gitee | https://gitee.com/hongmaple/scale-engine | 国内镜像与反馈 | | npm | https://www.npmjs.com/package/@hongmaple0820/scale-engine | CLI 包下载 | | QQ 群 | 628043364 | 国内用户交流、问题反馈 | | 邮箱 | [email protected] | 合作、反馈、建议 |

赞赏与支持

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

License

MIT