MindForge

# MindForge **适用于 Claude Code 的智能体智能框架** — 通过治理、记忆和自主执行来编排多智能体工作流。具备真正的并行处理、流式 SDK 和零信任安全。安装一次，即可获得带有内置质量门的 AI 驱动结构化开发体验。 --- ## 最新版本: v11.9.0 - **v11.9.0** (2026-07-01) — 尸检修复稳定版 — 258/258 个 IQ200 检查通过；`--version` 标志、EISClient 命名导入、rbac shim、技能加载器存根、空阶段防护、12 个重复触发器已解决、SDK 0 类型检查错误、spawn 上的路径包含防护 - **v11.8.2** (2026-07-01) — 清洁稳定版 — ESLint 0 错误、健康命令输出修复、ZTAI 延迟实例化、pr-review CLI 入口点、worktree 超时修复 - **v11.8.1** (2026-07-01) — 首个稳定版 — hono+picomatch CVEs 已修复（0 个漏洞）、SRE 模拟器已启用、spawn 存根披露、EIS/browser/ZTAI 防护已添加 - **v11.8.0 — "工作流锻造 II"**。将动态工作流库从 12 个扩展到 32 个，涵盖 5 个层级 — 新增一个 **Beast 层级**，用于复合的 5 阶段对抗性工作流（安全强化、可访问性审计、安全威胁建模），以及在 Dev/Ops/Intelligence/Research 中新增 18 个。21 个新的 `/mindforge:wf-*` 命令。总共：219 个命令。 - **v11.7.0 — "工作流锻造"**。推出首个动态工作流库 — 12 个预构建的多智能体工作流脚本，通过 Claude Code 的 `Workflow` 工具运行，具备真正的并行智能体执行。四个层级：研究（deep-research、competitive-analysis、tech-evaluation）、开发（code-audit、feature-planner、pr-review、tdd-sprint、refactor-plan）、运维（incident-response、release-prep）、智能（onboard-codebase、perf-optimize）。13 个新的 `/mindforge:wf-*` 命令。总共：198 个命令。 - **v11.6.0 — "技能锻造"**。添加了 80 个社区来源的技能，涵盖 8 个领域（软件开发、github、devops、research、security、creative、data-science、note-taking）— 30 个提升到引擎层级以实现自动触发匹配，50 个在扩展层级需要显式激活。三个新的斜杠命令：`/mindforge:systematic-debug`、`/mindforge:skill-tdd`、`/mindforge:skills-index`。总共：153 个技能、232 个引擎层级条目、185 个命令。 - **v11.5.1 — 独立 MCP 服务器**。MindForge MCP 服务器现在作为其自己的 npm 包发布，`mindforge-mcp-server@11.5.1`，在官方 MCP 注册表中列为 `io.github.sairam0424/mindforge`。通过一个命令将其添加到 Claude Code 中（参见 [使用 MCP 服务器](#-use-the-mcp-server-standalone)）；它通过 stdio 暴露 7 个工具（6 个只读 + 1 个受控写入）。 ## 安装与设置 ### 🔌 Claude Code 插件（最快） 直接从市场安装 MindForge 的命令、子智能体和技能 — 无需编写项目文件： ```bash /plugin marketplace add sairam0424/MindForge /plugin install mindforge@mindforge ``` ### 🚀 快速开始（npx — 完整框架引擎） **前提条件：** Node.js >= 18.0.0 npx 安装程序还会将完整的 `.mindforge/` 引擎（治理、内存、 规划）写入您的项目： ```bash # For Claude Code npx mindforge-cc@latest --claude --global # For Antigravity npx mindforge-cc@latest --antigravity --global ``` ### 🌍 全局安装 为您的主要 AI 编码运行时启用系统范围的 `/mindforge` 命令： ```bash npm install -g mindforge-cc@latest ``` ### 📂 本地项目设置 在现有仓库中初始化 MindForge，并使用专门的智能体身份： ```bash # For Claude Code npx mindforge-cc@latest --claude --local # For Antigravity npx mindforge-cc@latest --antigravity --local ``` ### 🔗 使用 MCP 服务器（独立） MindForge MCP 服务器作为其自己的 npm 包发布， **`mindforge-mcp-server`** (`11.9.0`)，并在官方 [MCP 注册表](https://registry.modelcontextprotocol.io) 中列为 `io.github.sairam0424/mindforge`。通过一个命令将其连接到 Claude Code： ```bash claude mcp add mindforge -- npx -y mindforge-mcp-server ``` 它通过 stdio 暴露 **7 个工具** — 6 个只读工具和 1 个受控写入工具： | 工具 | 用途 | | :--- | :--- | | `mindforge_health` | 框架健康检查 | | `mindforge_status` | 项目状态快照 | | `mindforge_memory_query` | 查询知识图 | | `mindforge_memory_stats` | 知识图统计信息 | | `mindforge_memory_find_related` | 查找相关知识条目 | | `mindforge_audit_log` | 读取追加日志 | | `mindforge_memory_remember` | 持久化记忆（受控写入） | --- ## 快速验证 安装后，打开 Claude Code 并输入： - `/mindforge:status` — 验证安装并显示项目健康状况 - `/mindforge:next` — 自动发现您的第一个任务 - `node bin/mindforge-cli.js --version` — 输出 `11.9.0` --- ## 生产强化（v11.0.0） - **内存安全操作** — LRU 缓存、原子写入、日志轮换和快照垃圾回收消除长运行会话中的资源泄漏。 - **真正的波浪并行** — 基于信号量的并发执行，支持可配置的最大并发度。 - **流式 SDK** — WebSocket 事件流、`streamExecution()` 和 `batchExecute()` 用于高吞吐量集成。 - **强化安全** — 短暂的飞地密钥、会话范围的智能体隔离、时间有限的 RBAC 提升、仪表盘速率限制和结构化 ZK 证明返回。 - **生产可观察性** — `/api/v1/system` 健康端点、P95 延迟跟踪、堆健康监测和带有重试逻辑的真实 EIS 客户端。 --- ## 核心工作流 ```bash /mindforge:init-project → 需求访谈 → 创建 PROJECT.md、REQUIREMENTS.md、STATE.md /mindforge:do <text> → 智能自然语言调度器（v2） /mindforge:note <text> → 零摩擦的想法捕获和待办事项提升（v2） /mindforge:ui-phase 1 → 创建 UI 设计合同（UI-SPEC.md）（v2） /mindforge:plan-phase 1 [--ads] → 讨论范围和决策 → 研究领域（并行） → 创建原子 XML 任务计划 → （可选）运行对抗决策合成（ADS）循环 /mindforge:execute-phase 1 → 基于波浪的并行执行 → 每个任务一个提交 → 自动验证 /mindforge:ui-review 1 → 回溯性 6 支柱视觉审计（v2） /mindforge:validate-phase 1 → 需求覆盖和测试间隙审计（v2） /mindforge:session-report → 自动的会话后利益相关者总结（v2） /mindforge:add-backlog <desc> → 在 999.x "停车场" 中存储想法（v2） /mindforge:review-backlog → 审查和推广待办事项（v2） /mindforge:plant-seed <idea> → 捕获具有触发器的投机想法（v2） /mindforge:workstreams → 具有隔离状态的并行功能轨道（v2） /mindforge:execute-phase 1 → 基于波浪的并行执行 → 每个任务一个提交 → 自动验证 /mindforge:verify-phase 1 → 人工验收测试 → 调试智能体失败 → UAT 签收 /mindforge:ship 1 → 变更日志生成 → 最终质量门 → PR 创建 /mindforge:auto --phase 1 → 离开自动执行（v2） → 智能卡住检测和节点修复 → 通过 steering-queue 进行外部控制 /mindforge:qa → UI 更改的系统化视觉验证（v2） → 自动回归测试生成 → 持久的浏览器会话和守护进程 /mindforge:cross-review → 对抗性多模型代码审查和合成（v2） → 共识检测和严重性归一化 /mindforge:research → 使用 Gemini 1.5 Pro 1M 上下文进行深入研究（v2） → 代码库范围的上下文打包和 SSRF 保护 /mindforge:costs → 实时代币使用和成本分析（v2） → 跨所有提供商的每日预算跟踪 /mindforge:remember → 手动知识管理和搜索（v2） → 持久知识图检索和推广 /mindforge:dashboard → 实时 Web 可观察性和治理，位于 localhost:7339（v2） → 实时审计日志、指标、活动和团队动态 /mindforge:learn → 自动从文档、会话或 npm 捕获技能（v2） → 7 维质量评分和注入保护 /mindforge:marketplace → 搜索、安装和发布社区技能（v2） → 通过 npm 注册表验证安装 /mindforge:new-runtime → 为任何 AI 智能体搭建自定义运行时配置（v2） ``` ## 文档 - **用户指南：** `docs/user-guide.md` - **故障排除：** `docs/troubleshooting.md` - **CI 快速入门：** `docs/ci-quickstart.md` - **需求：** `docs/requirements.md` - **快速验证：** `docs/quick-verify.md` - **升级指南：** `docs/upgrade.md` - **常见问题：** `docs/faq.md` - **发布说明：** `RELEASENOTES.md` - **发布检查清单指南：** `docs/release-checklist-guide.md` - **USP 和功能：** `docs/usp-features.md` - **完整教程：** `docs/tutorial.md` - **命令：** `docs/reference/commands.md` - **配置参考：** `docs/reference/config-reference.md` - **SDK：** `docs/reference/sdk-api.md` - **技能：** `docs/reference/skills-api.md` - **审计事件：** `docs/reference/audit-events.md` - **安全：** `docs/security/SECURITY.md` - **威胁模型：** `docs/security/threat-model.md` - **架构：** `docs/architecture/README.md` - **贡献：** `docs/contributing/CONTRIBUTING.md` ## 🚀 动态工作流库 32 个预构建的多代理工作流脚本，通过 Claude Code 的 `Workflow` 工具运行。每个工作流都派生出并发代理，综合结果，并返回结构化输出。 **发现：** `/mindforge:wf-catalog` 或 `node bin/mindforge-cli.js workflow list` | 层级 | 命令 | 功能 | |------|---------|-------------| | 研究 | `/mindforge:wf-competitive-analysis` | 5 个平行角度 → SWOT → 定位 | | 研究 | `/mindforge:wf-tech-evaluation` | 5 个维度 → 评分矩阵 → 推荐 | | 研究 | `/mindforge:wf-ai-model-eval` | 模型基准 → 评分矩阵 → 推荐 | | 研究 | `/mindforge:wf-ux-heuristic-audit` | 10 个尼尔森启发式 → 严重性排名 → 修复简报 | | 研究 | `/mindforge:wf-competitive-teardown` | 5 个竞争者角度 → 定位报告 | | 开发 | `/mindforge:wf-code-audit` | 3 个平行审计员 → 验证发现 → 风险报告 | | 开发 | `/mindforge:wf-feature-planner` | 简报 → PRD → 架构 → 用户故事 | | 开发 | `/mindforge:wf-pr-review` | 4 个平行评审员 → 共识裁决 | | 开发 | `/mindforge:wf-tdd-sprint` | 规格 → RED → GREEN → REFACTOR 循环 | | 开发 | `/mindforge:wf-refactor-plan` | 债务扫描 → 风险排序 → 安全序列 → 计划 | | 开发 | `/mindforge:wf-api-design` | 领域模型 → OpenAPI 规格 → SDK 骨架 → 文档 | | 开发 | `/mindforge:wf-db-schema` | 需求 → ERD → 迁移脚本 → 种子数据 | | 开发 | `/mindforge:wf-perf-regression` | 基线基准 → 变更 → 增量分析 → 裁决 | | 开发 | `/mindforge:wf-dependency-audit` | 许可证扫描 + CVE 派生 → 风险矩阵 → 升级计划 | | 开发 | `/mindforge:wf-test-coverage` | 覆盖率扫描 → 测试生成 → 突变测试 → 报告 | | 运维 | `/mindforge:wf-incident-response` | 4 个平行调查 → 缓解 → RCA → 事后总结 | | 运维 | `/mindforge:wf-release-prep` | 测试 → 变更日志 → 版本升级 → PR → 公告 | | 运维 | `/mindforge:wf-cost-analysis` | 使用情况派生 → 成本模型 → 优化杠杆 → 计划 | | 运维 | `/mindforge:wf-capacity-plan` | 负载模型 → 瓶颈预测 → 扩展路线图 | | 运维 | `/mindforge:wf-runbook-gen` | 服务映射 → 故障模式 → 补救步骤 → 运行手册 | | 智能 | `/mindforge:wf-onboard-codebase` | 映射 → 领域 → 架构 → 引导式游览 | | 智能 | `/mindforge:wf-perf-optimize` | 配置文件 → 4 个瓶颈查找 → 优先级修复计划 | | 智能 | `/mindforge:wf-arch-review` | C4 模型 → 5 个质量属性 → 风险排名的发现 | | 智能 | `/mindforge:wf-decision-analysis` | 选项派生 → 标准权重 → 评分推荐 | | 智能 | `/mindforge:wf-knowledge-graph` | 概念提取 → 关系映射 → 缺口分析 | | 智能 | `/mindforge:wf-retrospective` | 数据收集 → 4 个主题集群 → 行动项 → 时间线 | | 智能 | `/mindforge:wf-roadmap-prioritize` | 待办事项派生 → 影响/工作量评分 → 顺序路线图 | | 智能 | `/mindforge:wf-tech-radar` | 采用/试验/评估/持有派生 → 共识投票 → 雷达图表 | | Beast | `/mindforge:wf-security-hardening` | 5 个角度 OWASP 平行侦察 → STRIDE 威胁模型 → 补救路线图 | | Beast | `/mindforge:wf-accessibility-audit` | WCAG 2.2 平行审计 → 3 票对抗性验证 → 补救规格 | | Beast | `/mindforge:wf-security-threat-model` | 资产清单 → STRIDE×6 → 平行缓解 → CVSS 矩阵 | --- ## 📜 框架演进与版本历史 <details> <summary><b>v11.7.0 — 工作流锻造（动态工作流库）</b></summary> - **12 个动态工作流脚本** 在 `.mindforge/dynamic-workflows/scripts/` 中 — 每个都通过 Claude Code 的 `Workflow` 工具运行，具有真正的并行代理执行、结构化 JSON 模式和对抗性验证（如果适用）。 - **4 个层级：** 研究（深研究、竞争分析、技术评估）、开发（代码审计、功能规划、PR 审查、TDD 冲刺、重构计划）、运维（事件响应、发布准备）、智能（代码库上线、性能优化）。 - **13 个 /mindforge:wf-* 命令** （wf-catalog + 12 个工作流）。 - **CLI 发现：** `node bin/mindforge-cli.js workflow list|info|run <name>`。 - 架构遵循经过对抗性验证的最佳实践：每个领域一个工作流、预定义的（非开放式）管道、派生 + 门控合成模式。 </details> <details> <summary><b>v11.6.0 — 技能锻造（核心 + 开发技能包）</b></summary> - **80 个新技能** 跨越 8 个领域：软件开发、GitHub 工作流、DevOps 自动化、研究智能、安全、创意工具、数据科学和笔记。 - **引擎层级（自动触发）：** `.mindforge/skills/` 中的 30 个技能通过触发短语匹配自动激活 — 系统调试、TDD、看板自动化、OSINT 调查、网络渗透测试、概念图生成、研究论文写作等。 - **扩展层级（显式）：** `.agent/skills/` 中的 50 个技能涵盖 GitHub 身份验证、docker 管理、DevOps 监视器、1Password、调试器、像素艺术、视频编排等。 - **3 个新斜杠命令：** `/mindforge:systematic-debug` （4 阶段 RCA）、`/mindforge:skill-tdd` （RED-GREEN-REFACTOR）、`/mindforge:skills-index` （可浏览的技能目录）。 - 所有技能清洁集成 — 提交的任何文件中没有外部归属。 </details> <details> <summary><b>v11.0.0 — 主权稳定性（生产强化）</b></summary> - **第一阶段：基础** — LRU 有界缓存、原子 JSON 写入、AUDIT.jsonl 日志轮换、HANDOFF.json 结构验证、时间快照垃圾收集。 - **第二阶段：智能** — BM25 评分与文档长度归一化、完整补救策略实施、渐进智能联锁（+1/+2/MAX）、3 级卡住检测、自适应上下文窗口。 - **第三阶段：安全** — 结构化 ZK 证明返回、短暂 SRE 安全区密钥、会话范围 ZTAI 代理注册、时间限制 RBAC 提升、仪表板速率限制和令牌过期、可选 GPG 批准验证。 - **第四阶段：可观察性** — 异步时间 I/O、`/api/v1/system` 健康端点、P95 延迟环缓冲区、堆健康监测、EIS 客户端去存根与真实获取和重试逻辑。 - **第五阶段：SDK/分布式** — 基于信号的波浪并行性、WebSocket 事件流与自动重新连接、`batchExecute()`、模型流（Anthropic/OpenAI/Gemini）、从 v10.7.0 的迁移脚本。 </details> <details> <summary><b>v10.x — 200 技能扩展（委员会 → 平台主权）</b></summary> - **委员会觉醒（v10.0.3）：** 委员会决策框架、Instinct Engine、成本感知路由、6 阶段验证循环、多 LLM 咨询。 - **技能扩展（v10.0.4–v10.7.0）：** 从 20 到 200+ 核心技能，涵盖 12 个领域 — AI/ML、数据工程、平台工程、移动、领导力、行业垂直等。 - **400+ 个角色：** 具有领域专家身份协议的综合专家覆盖。 - **49 个群组模板：** 任务感知并行专家集群，涵盖每个工程学科。 </details> <details> <summary><b>v9.x — 基于地基的执行和 SQLite 持久性</b></summary> - **基于地基的波浪执行（Pillar XXIV）：** AutoRunner 读取 HANDOFF.json 波浪组，具有审计跟踪和重启持久性。 - **模型拓扑现代化（Pillar XXV）：** Claude 4.x 家族（opus-4-7, sonnet-4-6, haiku-4-5）。 - **统一内存架构（Pillar XXVI）：** SQLite（celestial.db）与 FTS5 搜索，替换 JSONL 存储。 - **模式迁移引擎（Pillar XXVII）：** 版本化迁移跟踪与事务包装的导入。 - **集成测试链（Pillar XXVIII）：** 27 个断言端到端管道验证。 </details> <details> <summary><b>v8.1.x — 主权身份（Pillar XIX）</b></summary> - **Pillar XIX：主权身份综合：** 从执行轨迹自动创建和演进 `SOUL.md`。 - **灵魂镜像：** 代理个性和决策启发式，根据持久的用户交互情感自我适应。 - **身份强制：** 子代理与实例的唯一主权身份强制对齐。 </details> <details> <summary><b>v8.0.x — 天界编排（SQLite 和 FMS）</b></summary> - **Pillar XV：统一持久层：** 从基于文件的 JSONL 状态转换为具有 FTS5 语义搜索的高性能 SQLite 引擎。 - **Pillar XVI：联邦网格综合（FMS）：** 通过加密签名的 `.mfb`（MindForge Bundles）进行项目间知识共享。 - **Pillar XVII：自主技能演进（ASE）：** 自动挖掘“黄金轨迹”以综合可重用的 `.skill.md` 工件。 - **Pillar XVIII：轨道治理：** 硬件锁定的安全门控，需要 HSM/生物识别认证才能进行高影响力突变（>95）。 </details> <details> <summary><b>v7.x — 主权智能（PQAS 和归巢）</b></summary> - **Pillar XI：后量子代理安全（PQAS）：** 基于格的（Dilithium-5）签名和 ZK-Proof 绕过，用于 4 级代理身份。 - **Pillar XII：主动语义归巢：** 自主“意图狩猎”，其中代理主动声明任务，并在网格中进行逻辑漂移的同伴治愈（>80）。 - **Pillar IX：自主资源收获（ARH）：** 基于 MIR（最小智能需求）的实时代币套利和动态任务路由。 - **Pillar X：神经漂移缓解（NDR）：** 语义密度启发式和自动推理恢复，以打破逻辑循环和幻觉。 - **代理学习循环：** 所有代理动作的强制性“读取前，记录后”协议，确保持久的、自我改进的工程记忆。 </details> <details> <summary><b>v6.x — AgRevOps 和稳定性模式</b></summary> - **AgRevOps 投资回报引擎（Pillar VIII）：** 每个自主推理循环的实时价值归属（每小时开发节省 100 美元的映射）。 - **FIM 扩展：** 通过 `PillarHealthTracker` 聚合集体项目健康指标。 - **CADIA 优化器（Pillar II 升级）：** 动态风险评分（0-100）和会话熵护栏，以防止流氓行为。 - **归巢信号注入：** 自动捕获高功效 SCS 归巢指令，作为持久、可共享的知识。 </details> <details> <summary><b>v5.10.x — 奈克萨斯转向和 AgRevOps</b></summary> - **交互式时间转向（Pillar VII）：** 借助 Nexus 仪表盘进行后见之明注入和时间滑动导航。 - **投资回报引擎（Pillar VIII）：** 自动财务治理和累积代理投资回报跟踪。 - **速度预测器：** 基于实时遥测的里程碑统计 ETA 预测。 </details> <details> <summary><b>v5.9.x — 企业级强化</b></summary> - **统一 NexusTracer：** 具有核心异步驱动的单一高保真 ART 协议单例。 - **Merkle 风格审计完整性：** 具有累积 Merkle-hash 链的强化 SRE 和 ZTAI 日志。 - **MCA 电路中断器：** `CloudBroker` 中的状态提供者黑名单和自动故障补救。 </details> <details> <summary><b>v5.7.x - v5.8.x — SRE 和 MCA 协议</b></summary> - **主权理性密闭（v5.8）：** 机密推理周期的 ZK-Proof 合规性证书。 - **多云仲裁（v5.7）：** 使用持久任务到模型成功矩阵的智能优先路由。 </details> <details> <summary><b>v5.1.x - v5.6.x — “企业”时代（协议和信任）</b></summary> - **Sentinel 执行（v5.6）：** 二进制运行时认证和推理熵评分（RES）。 - **预测代理可靠性（v5.5）：** 高级循环检测（语义镜像）和自我愈合触发器。 - **动态爆炸半径（v5.3/v5.4）：** 联邦同步中的实时影响分析和电路中断器安全。 - **语义向量共识（v5.2）：** FIM v2，具有余弦相似性冲突解决。 - **企业版协议（v5.1）：** 从 Superpowers 集成 14 个高级代理协议（头脑风暴、群组、并行网格）。 </details> <details> <summary><b>v4.x — 网格和 Nexus 革命</b></summary> - **企业网格（v4.3）：** 自主 FinOps 和主动均衡（波浪监控）。 - **身份和内存（v4.2）：** 具有 Ed25519 签名的零信任代理身份（ZTAI）。 - **MindForge Nexus（v4.1）：** 分层 ART 跟踪和跟踪上下文传播。 - **网格动态群组（v4.0）：** 并行、任务感知专家集群和微角色工厂。 </details> <details> <summary><b>v3.x — 反应式自主智能</b></summary> - **上下文分片（SRD）：** 通过相关性密集的 Hot/Warm/Cold 上下文层减少 40% 的令牌浪费。 - **对抗性决策综合（ADS）：** 通过红蓝模型辩论实现零漂移架构逻辑。 - **时间视觉：** 完整保真历史导航、后见之明注入和自动状态修复。 - **RAG 2.0（自动影子）：** 从本地知识图谱进行后台模式检索。 </details> <details> <summary><b>v2.x — 自主企业和知识图谱</b></summary> - **多运行时支持：** Claude Code、Antigravity、Cursor、Gemini 和 Copilot 的官方适配器。 - **RAG 2.0：** 类型边缘本地知识图谱，具有主动上下文影子和 TF-IDF 搜索。 - **时间视觉：** 完整保真历史导航、状态快照和后见之明注入。 - **自我构建技能：** 通过 `/mindforge:learn` 从文档和阶段输出自动捕获技能。 </details> <details> <summary><b>v1.x — 框架基础和核心协议</b></summary> - **统一 4 柱工作流：** 标准化的 `计划` → `执行` → `验证` → `交付` 生命周期。 - **专业人士库：** 32+ 高性能工程代理，定义能力矩阵。 - **零信任逻辑：** 初始协议执行和审计轨迹持久性。 </details> --- ## 安全 MindForge 永远不会在文件中存储凭证。查看： - `docs/security/SECURITY.md` - `docs/security/threat-model.md` --- ## ⚖️ 许可证 MIT © 2026 MindForge Team