Bob A Thon Submission

通用规范架构师——IBM Bob-a-thon提交

项目目的

这 通用规范架构师 是一个MCP（模型上下文协议）服务器，旨在为IBM Bob等AI编码助手实施严格的、规范驱动的工程工作流程。

它解决的核心问题是，人工智能助手在没有适当规划的情况下直接编写代码，导致架构漂移、遗漏需求和无法维护的代码库。这个项目迫使助手在编写一行实现代码之前暂停、思考和记录。

主要特点

• 强制三阶段工作流程：要求助理填写要求→ 设计→ 编码前的任务。
• EARS符号验证：自动验证所有需求是否遵循需求语法的简易方法([WHEN ] THE SHALL ).
• 实时任务跟踪：为助手提供更新任务状态的工具(todo, in_progress, completed)在一个集中 tasks.md 文件。
• IBM Bob集成：包括自定义 .bob/modes/spec-architect.json 和 .bob/rules/spec-workflow.md 与IBM Bob的转向机制无缝集成。
• 通用兼容性：不仅适用于IBM Bob，还适用于Cline、Cursor、VS Code（Copilot）、Windsurf和Claude Desktop。

技术实现

该项目是使用基于Python的MCP服务器构建的 fastmcp 框架。

它向AI助手展示了6个核心MCP工具：

1. initialize_spec：脚手架 .specs/ 目录结构。
2. write_requirements：验证并写入 requirements.md.
3. write_design：结构和写作 design.md.
4. write_tasks：将工作分解为 tasks.md.
5. update_task_status：动态修改任务状态。
6. run_hook：执行生命周期挂钩(pre_task, post_task).

服务器在本地运行，并使用MCP协议通过stdio与IBM Bob通信。

如何在本地运行应用程序

先决条件

• Python 3.11+
• uv 已安装包管理器

安装

1. 克隆此存储库。
2. 安装依赖项：

   pip install fastmcp pydantic
   pip install -e .

与IBM Bob一起运行

1. 复制 .bob/ 将此存储库中的目录添加到目标项目的根目录中。
2. 确保 .bob/mcp.json 指向正确的服务器路径：

   {
     "mcpServers": {
       "universal-spec-architect": {
         "command": "uvx",
         "args": ["fastmcp", "run", "src/universal_spec_mcp/server.py"],
         "env": { "PYTHONPATH": "src" }
       }
     }
   }

1. 在启用IBM Bob扩展的VS Code中打开您的项目。
2. 选择 规范建筑师 模式在鲍勃。
3. 让Bob“构建一个新功能”——Bob将自动启动MCP服务器并开始3阶段工作流。

运行测试

要在本地验证MCP服务器逻辑：

python3 tests/test_server.py

演示视频

在最终提交给IBM Bob-A-thon组织之前，将向此存储库添加一个3分钟的演示视频。该视频将涵盖：

• 项目结构演练
• IBM Bob Spec Architect模式正在运行
• 生成的规范工件（需求、设计、任务）
• 在本地运行测试套件