Workspace Init MCP

工作区初始化mcp

workspace-init-mcp 是一个MCP服务器，用于向工作区添加AI治理和交付工具。

它生成复制指令、代理技能、治理文档、运行时切换文件、仪表板状态、准备状态检查和协调工具，因此人工智能辅助的工作可以在长时间运行的会话中保持可审查、可恢复和安全。

它专为VS Code、Cursor、Claude Code、OpenHands、Codex CLI/Desktop、GitHub Copilot以及基于可移植文件或CLI的代理运行时而设计。

核心保证

• 非破坏性遗产收养：初始化和协调是线束覆盖。它们不得删除、截断、移动或替换现有的应用程序源。
• 治理优先交付：通过持久文件计划、审查、承包、实施、评估和关闭有意义的工作。
• 并行代理支持：编排器可以拆分无依赖块，分配工作代理，并仅注入与任务相关的上下文。
• 独立评估：发电机输出通过自校正、评估员审查、验证和质量门进行检查。
• 可追溯性：运行时会话、切换、接收、仪表板状态、迁移和原子提交使工作历史可检查。

受保护的源根，如 src/, app/, packages/, services/, server/，以及 client/ 除非后来的明确实施合同将其列为批准的现代化范围，否则仍归项目所有。

快速开始

将MCP服务器添加到您的客户端，然后让您的代理分析或初始化工作区。

示例用户提示：

Analyze this existing repository and initialize workspace-init-mcp as a non-destructive AI harness overlay.
Preserve application source. Use strict governance, balanced autonomy, and include agent skills.

建议先通过现有存储库：

1. 跑 analyze_workspace.
2. 跑 preview_workspace_init 检查生成的文件。
3. 跑 initialize_workspace 和 force: false.
4. 跑 validate_workspace.
5. 对于较旧的已初始化工作区，请运行 reconcile_workspace_initialization 在应用更改之前进行模拟运行。

设置

VS Code settings.json

{
  "mcp": {
    "servers": {
      "workspace-init": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "workspace-init-mcp"]
      }
    }
  }
}

VS Code .vscode/mcp.json

{
  "servers": {
    "workspace-init": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "workspace-init-mcp"]
    }
  }
}

克劳德桌面版

将此添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "workspace-init": {
      "command": "npx",
      "args": ["-y", "workspace-init-mcp"]
    }
  }
}

Codex命令行界面/桌面

codex mcp add workspace-init -- npx -y workspace-init-mcp
codex mcp get workspace-init

它产生了什么

生成的文件有意限于治理、文档、IDE配置、仪表板、运行时、技能和代理界面。

运营模式

有意义的工作在实施之前遵循治理阶梯：

Governance open
Plan 1 -> Review 1
Plan 2 -> Review 2
Plan 3 -> Review 3
Goal freeze
Contract proposal -> Contract review
Implementation -> Self-check
Independent evaluation -> Remediation
Verification
Governance refresh -> Governance close

目标不是放慢工作速度。它是为了使人工智能的工作可恢复、可审计，并且更容易在会话或代理之间进行拆分，而不会失去意图。

遗产收养

当AI进入现有的代码库、客户端系统或操作环境时，使用此MCP。

安全的传统采用意味着：

• 在编写之前分析AS-IS存储库
• 在项目周围添加线束文件
• 保留应用程序源代码和现有业务逻辑
• 合并实时仪表板/运行时JSON，而不是盲目替换它
• 保存定制的托管文件以供审查
• 归档替换了以下托管文件 docs/ai-harness/migrations/
• 将传统的自定义技能或代理导入到canonical中 .github 适当时的路径

为了更安全地协调运行：

• reconcile_workspace_initialization 默认为干运行模式
• requireCleanGitWhenPresent: true 当工作树变脏时可以阻止写入
• requireZeroManualReviewItemsForApply: true 可以阻止应用程序运行，直到手动审核项目得到解决
• audit_workspace_upgrade_risk 和 audit_workspace_managed_semantic_diff 升级前暴露托管文件漂移
• export_reconcile_preflight_report 编写JSON、Markdown和HTML报告以供审阅
• restore_reconcile_backup 可以从迁移备份中还原托管文件

并行代理工作

线束包括 harness-orchestrator 用于并行执行的代理和运行时数据包字段。

编排者负责：

• 分析积压工作
• 将块标记为阻塞、顺序或并行就绪
• 仅将工作代理分配给独立块
• 定义预期的读取路径、写入路径、验证命令和合并所有权
• 仅注入相关的任务契约、代码片段、DB模式片段、API规范、日志和命令

只有在写入范围、架构更改、API约定、运行时副作用和部署顺序不冲突时，才允许并行工作。

Worker输出通过合约、评估者记录、收据、仪表板更新和原子提交返回。

质量门

每个实现块在结束之前都应该通过成熟度门：

1. 关键误差和稳定性检查：静态分析、语法检查、运行时异常风险和边界测试。
2. 版本兼容性：框架/运行时同步、Java/JDK或等效环境检查以及依赖兼容性。
3. 依赖审计：确认新的或更改的库与现有系统不冲突。
4. 可维护性：SOLID、复制、抽象级别、常量而不是硬编码以及业务/数据访问分离。
5. 自我纠正和可追溯性：发电机不确定性报告、独立评估、补救证据和原子提交参考。

管理员仪表板

每个初始化的工作区都包含一个文件系统仪表板，位于 docs/ai-harness/dashboard/.

仪表板首先是JSON，不需要数据库：

• state/dashboard-state.json 是真理的活源泉
• index.html 呈现进度、KPI、问题、工件、受管会话和git状态
• templates/*.state.json 为软件交付、创意叙事、知识工作流程和通用转型计划提供起点
• scripts/dashboard-ops.mjs 可以刷新、验证、本地服务和导出静态快照

初始化工作区中的有用命令：

node docs/ai-harness/dashboard/scripts/dashboard-ops.mjs refresh
node docs/ai-harness/dashboard/scripts/dashboard-ops.mjs validate
node docs/ai-harness/dashboard/scripts/dashboard-ops.mjs serve --port 43110
node docs/ai-harness/dashboard/scripts/dashboard-ops.mjs export-static --out docs/ai-harness/dashboard/exports/latest

运行时和代理切换

版本 4.2.1 在下面包含一个兼容层 docs/ai-harness/runtime/:

• version-index.json 按工作区init mcp版本记录功能
• compatibility-matrix.json 告诉 @latest 会话如何安全升级旧工作区
• adapter-contract.json 定义跨Copilot、Codex、Claude、Gemini、OpenHands、通用CLI和基于文件的运行时的稳定切换字段
• session-continuity.md 定义在代理之间移动工作时的真值顺序来源

如果较新的代理进入较旧的工作区，请运行 reconcile_workspace_initialization 在依赖最新的运行时行为之前。实时仪表板和运行时状态合并；生成的兼容性合同刷新到最新基线。

准备和归档

准备层回答：“在这个工作区准备好进行可重复的DX/AX操作之前，还需要满足哪些条件？”

• assess_workspace_readiness 可以对工作区进行评分，并可选择写入 maturity-scorecard.json
• audit_workspace_readiness_semantics 执行超出文件存在范围的保守语义审核
• compact_harness_runtime 存档较旧的已关闭会话，以便活动运行时账簿保持可读性

工具参考

初始化

调和与安全

运行时编排

适配器和执行桥

准备和技能

项目类型

支持的项目类型：

learning, web-app, api, mobile, data-science, devops, creative, library, monorepo, consulting, ecommerce, fintech, healthcare, saas, iot, other

发展

npm install
npm run build
npm test

许可证

麻省理工学院