TAGAI 一个让程序员上班写代码偷懒的神器

我开发了一个为Agent设计的简易文档管理平台，个人感觉对上班偷懒还挺有帮助的，非常想和大家分享一下。

（PS：请不要攻击我的服务器，这个是一个免费服务，服务器也是阿里云的99块钱一年的，扛不住攻击）

项目地址：https://tagai.zklighting.ltd/

事情的起因是我之前开发了一个Spec Flow MCP的工具

Spec Flow MCP 在Cursor中的使用指南

之前制作了一个简易的MCP工具来实现文档的管理，虽然它的效果页很不错，但是这个工具并不能很好的满足类似数据隔离、团队文档管理、方便查看等要求。

这是一个什么工具？

简单来讲：这是一个可以让我们在开发中偷懒的神器

这是一个外挂的知识库，或者说类似Spec Kit、Open Spec的一类别的Spec管理工具，但是我更愿意叫我这个工具为知识库。

虽然我个人没有用过类似Spec Kit的工具，但是我从他们的描述上能感觉到，这种使用外挂知识库来管理的方法本质上都是一种“AI 工程方法论”

当然，我的这个工具肯定没有Spec Kit做得好，我只是在我自己的实践过程中，发现将项目的一些经验归纳总结出来，让后再次执行的时候AI又会去归纳总结，非常的慢，以及不准确的问题，通过增加缓存的形式可以非常好的改善这种开发体验。

上面可能说的比较抽象，下面实际举几个例子来说明一下，因为我主要是做前端开发的，所以大部分都是以前端开发为例子

🌰 举个例子

第一个例子是一个简单的前端任务，就是让Cursor帮助我将一个组件的展示增加一个判断条件

这个任务的难点在于，AI并不知道US站点是什么东西，就是下面图片中的任务

这个站点相关的内容，在我们的团队文档中是有具体的说明的，我是知道的，我该怎么让AI也知道

方法其实也很简单，把文档给AI看。

这中间就会涉及查找文档、复制、粘贴、对话、执行乱七八糟一堆东西，这么麻烦的工作当然不适合一个喜欢偷懒的程序员。

更简单的方法就是将文档备份在项目中，引用这个文档，这个方法缺点也很明显，文档没人维护，无法更新，无法团队共享，不过我只是自己用，好像也没必要更新。

那如果，我们有一份儿团队级别的文档，AI 又可以直接检索到，是不是，就可以直接偷懒了？

偷懒教程详细版

下面介绍一下我是如何偷懒的

第一步，先打开网站并完成注册

第二步、创建一个组织

我设计的时候只考虑了团队版本，完全没考虑个人使用，个人比较懒，将就用哈

第三步、创建一个项目

然后打开详情

第四步、复制MCP配置信息到你的AI工具中

先到详情的这个位置

复制MCP的配置到你的AI工具，这里以Cursor为例子，其他的工具自己搜索一下哈

推荐直接放在项目里面，注意启用MCP服务

第五步、增加一个command来方便操作

使用 【你的项目名称】 MCP 文档服务，根据用户指令自动判断并执行相应操作：

**主要功能：**

1. **查询文档**：当用户需要参考开发规范、查找文档、了解组件用法等时，自动调用 MCP 文档查询功能（如 `mcp_plut_search_documents`、`mcp_plut_get_development_spec` 等）
2. **保存总结**：当用户要求保存项目总结、创建或更新开发规范文档时，自动调用 MCP 文档保存功能（如 `mcp_plut_create_development_spec`、`mcp_plut_edit_development_spec` 等）

**判断逻辑：**

- 如果用户指令包含"查询"、"查找"、"参考"、"规范"、"文档"、"如何"、"用法"等关键词，优先使用查询功能
- 如果用户指令包含"保存"、"创建"、"更新"、"总结"、"记录"、"文档化"等关键词，使用保存功能
- 如果指令不明确，根据上下文和实际需求智能判断

**设计稿处理流程（重要）：**

- **设计稿读取后必须查询文档**：当通过 Figma MCP 工具（如 `mcp_Figma_Desktop_get_design_context`、`mcp_Figma_Desktop_get_screenshot` 等）读取完设计稿后，必须根据设计稿的实际内容自动查找相关开发规范和文档
- **分析设计稿内容**：读取设计稿后，分析设计稿中包含的组件、功能模块、交互模式、设计模式等关键信息
- **自动文档查询**：根据分析结果，使用 `mcp_plut_search_documents` 或 `mcp_plut_get_development_spec` 查找相关的：
  - 组件开发规范（如表单组件、表格组件、抽屉组件等）
  - 功能模块规范（如列表页、详情页、编辑页等）
  - 交互设计规范
  - 样式规范
- **查询时机**：设计稿读取完成后，在开始编写代码之前，必须先完成相关文档的查询，确保生成的代码符合开发规范

**用户纠正错误时的处理流程（重要）：**

- **反思问题**：当用户纠正代码错误时，必须首先反思错误的根本原因
  - 分析为什么会出现这个错误（如：使用了错误的组件、没有查询相关规范、没有优先使用标准组件等）
  - 理解正确的做法和错误做法之间的区别
- **查询相关文档**：查找相关的开发规范文档，确认正确的实现方式
- **更新文档库**：将正确的方案保存到文档库中
  - 如果相关规范文档已存在，使用 `mcp_plut_edit_development_spec` 更新文档，加入正确的用法和常见错误提醒
  - 如果相关规范文档不存在，使用 `mcp_plut_create_development_spec` 创建新文档
  - 在文档中明确标注：优先使用标准组件库（如 `@spotter/plut-ui`）中的组件，避免使用项目自定义组件（除非有特殊需求）

**注意事项：**

- 查询前先使用 `mcp_plut_list_specs` 或 `mcp_plut_search_documents` 了解可用文档
- 保存时确保内容格式正确（Markdown 格式），并选择合适的分类（frontend/backend/mobile/design）
- 创建新规范时使用 `mcp_plut_create_development_spec`，更新现有规范时使用 `mcp_plut_edit_development_spec`

不过你需要编辑一下上面的指令，根据需要改改吧，不改也能用

这个command的位置在这儿