[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81629":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":13,"stars30d":13,"stars90d":15,"forks30d":15,"starsTrendScore":17,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":15,"starSnapshotCount":15,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},81629,"scale-engine","hongmaple0820\u002Fscale-engine","hongmaple0820","SCALE Engine 是一个 AI 工程化脚手架引擎，为 AI Agent（Claude Code、Codex CLI、OpenCode、Cursor、Gemini CLI 等）提供物理约束层，确保 AI 在编码过程中遵循工程规范，而不是依赖提示词的\"自律\"。","https:\u002F\u002Fscale-os.hongmaple.top\u002F",null,"TypeScript",27,5,22,0,1,3,2.33,"Other",false,"master",true,[],"2026-06-12 02:04:17","\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-0.42.0-orange?style=flat-square\" alt=\"version\" \u002F>\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatforms-22-blue?style=flat-square\" alt=\"platforms\" \u002F>\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fagents-12-blue?style=flat-square\" alt=\"agents\" \u002F>\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Ftests-verified-brightgreen?style=flat-square\" alt=\"tests\" \u002F>\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnpm-0.42.0-cb3837?style=flat-square&logo=npm\" alt=\"npm\" \u002F>\n\u003C\u002Fp>\n\n[![RepoStars](https:\u002F\u002Frepostars.dev\u002Fapi\u002Fembed?repo=hongmaple0820%2Fscale-engine&theme=copper)](https:\u002F\u002Frepostars.dev\u002F?repos=hongmaple0820%2Fscale-engine&theme=copper)\n\n# SCALE Engine \n\nSCALE Engine 让 AI Agent 不再只靠\"自觉\"遵守工程规范。它把探索、规划、实现、验证、评审、发版这些要求变成可执行的命令、门禁和证据文件，让人类可以看见 Agent 做了什么、跳过了什么、为什么能交付或不能交付。\n\n源码仓库：https:\u002F\u002Fgithub.com\u002Fhongmaple0820\u002Fscale-engine\n国内镜像：https:\u002F\u002Fgitee.com\u002Fhongmaple\u002Fscale-engine\nnpm：https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@hongmaple0820\u002Fscale-engine\n语言：[中文](README.md) | [English](README.en.md)\n更新记录：[CHANGELOG.md](CHANGELOG.md)\n\n## 它解决什么问题\n\n| 常见问题 | SCALE 的处理方式 |\n| --- | --- |\n| Agent 没验证却说\"测试通过\" | 通过 verification profile 和 evidence store 记录真实命令与结果 |\n| Agent 跳过需求澄清、设计、TDD 或 review | 通过 `scale context`、`scale diagnose`、`scale tdd`、`scale status` 生成下一步动作 |\n| Agent 攒代码不提交，最后难以分段 | 通过 Commit Discipline 监控 git 状态，双阈值告警，自动分组建议 |\n| Agent 误提交无关文件或跨仓库改错位置 | 通过 review-gated ship、MOE workspace 和子仓库 blocker 控制边界 |\n| 多会话并行开发产生冲突 | 通过 Session Coordinator 文件重叠检测、冲突记录、依赖拓扑排序 |\n| 多仓库项目 Git 工作流混乱 | 通过 Cross-Repo Orchestrator 协调分支、合并计划、ship 流水线 |\n\n## 3 分钟看到效果\n\n```bash\nnpm install -g @hongmaple0820\u002Fscale-engine\nmkdir scale-demo && cd scale-demo\nscale init --governance-pack standard\nscale bootstrap deps --pack external-cli --json\nscale preflight --preflight-profile quick\nscale status\n```\n\n你会得到一套可提交到项目里的治理文件：\n\n- `.scale\u002Fverification.json`：服务矩阵和验证 profile\n- `.scale\u002Fskills.json`：skill 路由和证据要求\n- `.scale\u002Ftools.json`：CLI\u002FMCP\u002Fbrowser\u002Fdesktop 工具编排规则\n- `docs\u002Fworkflow\u002Ftemplates\u002F`：Mini-PRD、plan、verification、review、summary 模板\n- `docs\u002Fstandards\u002F`：工程规范、Git 协作、资源治理规则\n\n继续体验完整闭环：\n\n```bash\nscale context grill --task-id TASK-001 --task \"加固 OAuth callback\"\nscale diagnose plan --task-id TASK-001 --symptom \"callback 在 state 过期时返回 500\"\nscale tdd slice --task-id TASK-001 --behavior \"拒绝过期 OAuth state\" --failing-test \"expired state returns 401\"\n```\n\n完整教程见 [3 分钟快速开始](docs\u002Fstart\u002Fquickstart.md) 和 [官方 Demo Walkthrough](docs\u002Fstart\u002Fagent-governance-demo.md)。\n\n## 安装\n\n```bash\nnpm install -g @hongmaple0820\u002Fscale-engine\nscale --version\n```\n\n需要 Node.js 20 或更高版本。\n\n如果你希望把 UI skills、RTK、记忆\u002F知识图谱这类第三方能力一起补齐，使用显式 bootstrap，而不是依赖静默自动安装：\n\n```bash\nscale bootstrap deps --profile advanced --governance-pack frontend-app --json\nscale bootstrap deps --pack ui,knowledge --apply\n```\n\n`bootstrap deps` 默认先出计划；只有显式加 `--apply` 才会执行安装命令。\n\n安装入口变更后，先跑安装烟测：\n\n```bash\nnpm run smoke:setup\nmake setup-smoke\n```\n\n它会验证中英文安装输出、运行时依赖诊断、记忆供应商切换，以及 Graphify\u002FCodeGraph 状态路径；不会执行真实第三方安装。\n\n如果用户机器出现 Windows\u002FUnix 命令差异、PATH 不对、缺 Python\u002FBun\u002FCargo\u002FRTK 等问题，先跑：\n\n```bash\nscale doctor env --json\n```\n\n## 适合谁\n\n- 正在用 Codex、Claude Code、Cursor、Gemini CLI、OpenCode、Aider 等 Agent 写真实项目的团队。\n- 有多服务、多仓库、MOE workspace、前后端分离需求的团队。\n- 希望 Agent 主动使用 skills、MCP、CLI、浏览器、E2E，但又需要安全边界和证据闭环的团队。\n- 经常遇到\"AI 改得快，但难审、难验、难维护\"的项目负责人。\n\n## 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| **Workflow Engine** | `define → plan → build → verify → review → ship` 阶段化交付状态机 |\n| **Gate System** | build、lint、test、coverage、security、TDD、review 门禁 |\n| **AI OS Runtime** | `scale ai-os plan\u002Frun\u002Fstatus` — 任务规划、受控运行、治理仪表盘 |\n| **Commit Discipline** | 监控 git 状态，双阈值告警，自动分组未提交文件 |\n| **Session Coordinator** | 多会话并行协调，文件重叠检测，冲突记录 |\n| **Cross-Repo Orchestrator** | 多仓库 Git 工作流编排，协调分支\u002F合并\u002Fship |\n| **Task Dependency Graph** | DAG 依赖声明，拓扑排序，环检测 |\n| **Ship Pipeline** | 8 步 ship 闭环，支持 dry-run、skip、version bump |\n| **Security Audit** | OWASP Top 10 + STRIDE 安全审计引擎 |\n| **Role Skills** | 6 个角色化审查视角（eng-manager、security-reviewer、qa-lead 等） |\n| **Memory Intelligence** | 6 信号质量评分，跨 provider 冲突检测，新鲜度衰减 |\n| **Governance ROI** | 端到端治理 ROI 度量 — token 成本 vs 质量 vs 门禁摩擦 |\n| **Scale Shield** | 退出码钩子拦截引擎 — YAML 策略 → hook 脚本编译，40+ 危险命令阻断，退出码协议 |\n| **Scale Orchestrator** | 声明式编排守护进程 — SCALE_POLICY.md 策略驱动，git worktree 隔离，协调循环 |\n| **Scale Cortex** | 证据驱动持续进化 — 本能提取 (Instincts 0.3-0.9)，SessionStart 注入，跨 harness 适配器 |\n\n## SCALE 2.0 三引擎架构\n\nSCALE 2.0 引入三层引擎，对齐业界前沿项目的核心模式：\n\n| 引擎 | 对标项目 | 核心能力 |\n|------|---------|---------|\n| **Scale Shield** | agent-hooks-in-depth | 退出码阻断 (exit 0\u002F2)、stdin\u002Fstdout JSON 协议、40+ 危险命令拦截、`.scale\u002F` 完整性保护 |\n| **Scale Orchestrator** | Symphony WORKFLOW.md | 声明式策略驱动、git worktree 隔离、协调循环、多轮 Worker |\n| **Scale Cortex** | ECC Instincts | 观察→模式→本能提取 (置信度 0.3-0.9)、SessionStart 注入、跨 harness (Claude\u002FCodex\u002FCursor\u002FGemini) |\n\n```bash\n# Shield: 编译策略并安装 hook\nscale shield compile\nscale shield status\n\n# Orchestrator: 启动声明式编排守护进程\nscale orch start\nscale orch status\n\n# Cortex: 从失败中学习\nscale cortex evolve\nscale cortex metrics --days 30\nscale cortex inject --minimal\n```\n\n## AI OS Runtime\n\nAI OS Runtime 是 SCALE 的核心运行时规划层。`scale ai-os plan` 在一次命令里生成风险治理模式、Context Compiler 预算、Memory Provider 召回、Skill Routing 执行计划和 Governance ROI，让 Agent 在开始任务前就知道应该加载什么上下文、调用什么能力、补什么证据。\n\n```bash\nscale ai-os plan \\\n  --task-id TASK-123 \\\n  --task \"修复 OAuth callback auth token 并验证浏览器回调流程\" \\\n  --level L \\\n  --files src\u002Fauth\u002Foauth.ts,src\u002Fui\u002Fcallback.tsx \\\n  --budget 8000 \\\n  --json\n```\n\n详细命令见 [AI OS Runtime 文档](docs\u002FAI_ENGINEERING_OS_POSITIONING.md)。\n\n## 学习路径\n\n| 目标 | 入口 | 你应该学会什么 |\n| --- | --- | --- |\n| 先跑起来 | [3 分钟快速开始](docs\u002Fstart\u002Fquickstart.md) | 安装 CLI、初始化治理文件、运行 preflight |\n| 看完整闭环 | [官方 Demo Walkthrough](docs\u002Fstart\u002Fagent-governance-demo.md) | 任务上下文、诊断、TDD、artifact 和验证证据如何串起来 |\n| 接入已有项目 | [SCALE 工作流升级指南](docs\u002Fstart\u002Fworkflow-upgrade.md) | `init`、`upgrade check\u002Fplan\u002Fapply`、本地 `make` 包装入口 |\n| 选择治理包 | [Governance Pack 文档](docs\u002Fstart\u002FREADME.md) | 不同项目形态应该选哪个 pack |\n| 维护或扩展 SCALE | [docs\u002FREADME.md](docs\u002FREADME.md) | 文档地图、内部模块和长期维护资料 |\n| 开发本仓库 | [docs\u002Fguides\u002FGETTING_STARTED.md](docs\u002Fguides\u002FGETTING_STARTED.md) | `scale-engine` 仓库自身的工程化工作流 |\n\n## 更新工作流\n\n```bash\nscale upgrade check --dir . --lang zh\nscale upgrade plan --dir . --html --lang zh\nscale upgrade apply --dir . --confirm --lang zh\n```\n\nSCALE 把升级分成三层：CLI 自身、已生成到项目里的 governance pack 文件、第三方 skills\u002FMCP\u002FCLI 能力。默认只检查和生成计划，不自动覆盖用户改过的文件。详见 [SCALE 工作流升级指南](docs\u002Fstart\u002Fworkflow-upgrade.md)。\n\n## 开发本仓库\n\n```bash\nmake preflight\nmake gate-workflow\nmake gate-quality\nmake verify PROFILE=default\n```\n\n入口文档：\n- [docs\u002Fguides\u002FGETTING_STARTED.md](docs\u002Fguides\u002FGETTING_STARTED.md) — 15 分钟上手\n- [docs\u002Fguides\u002FDEVELOPMENT_WORKFLOW.md](docs\u002Fguides\u002FDEVELOPMENT_WORKFLOW.md) — 日常开发闭环\n- [docs\u002Fworkflow\u002FREADME.md](docs\u002Fworkflow\u002FREADME.md) — 门禁、分支策略和升级入口\n\n## 社区与推广\n\n| 平台 | 链接 | 说明 |\n|------|------|------|\n| GitHub | https:\u002F\u002Fgithub.com\u002Fhongmaple0820\u002Fscale-engine | 源码、Issues、PR |\n| Gitee | https:\u002F\u002Fgitee.com\u002Fhongmaple\u002Fscale-engine | 国内镜像与反馈 |\n| npm | https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@hongmaple0820\u002Fscale-engine | CLI 包下载 |\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"image\u002Fwechat-public.jpg\" alt=\"SCALE Engine 微信公众号\" width=\"220\" \u002F>\n\u003C\u002Fp>\n\n## 赞赏与支持\n\n如果 SCALE Engine 节省了你的工程治理时间，或帮助你的团队把 AI Agent 工作流落到可验证、可复盘、可发版的闭环里，欢迎赞赏支持。赞赏用于持续维护、示例项目、文档、测试矩阵和社区支持。\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"image\u002FwxPay.jpg\" alt=\"微信赞赏\" width=\"220\" \u002F>\n    \n  \u003Cimg src=\"image\u002Fzfb.jpg\" alt=\"支付宝赞赏\" width=\"220\" \u002F>\n\u003C\u002Fp>\n\n## License\n\n[MIT](LICENSE)\n","SCALE Engine 是一个 AI 工程化脚手架引擎，旨在为多种 AI 编码助手提供物理约束层，确保其在编码过程中遵循工程规范。该项目通过将探索、规划、实现、验证、评审及发版等环节转化为可执行命令与门禁机制，并生成相应的证据文件，使得整个开发流程更加透明可控。采用 TypeScript 编写，支持包括 Claude Code、Codex CLI 在内的 12 种不同 AI Agent。适用于需要高度规范化管理的软件开发场景，特别是在多仓库项目或多人协作环境中，能够有效避免代码冲突、误提交等问题，提升团队工作效率与代码质量。",2,"2026-06-11 04:05:46","CREATED_QUERY"]