我开源了我自己？！

大家好，我是蘑菇（MoGuQAQ）。今天我想和大家分享一个我最近的开源项目——OpenMoGuQAQ。是的，你没看错，我把自己”开源”了。

什么是 OpenMoGuQAQ？

简单来说，OpenMoGuQAQ 是一个 AI 全栈开发技能集。它不是一个普通的代码库，而是一套完整的 AI 开发工作流规范，包含了从架构设计到代码实现，再到代码审查和迭代复盘的全套流程。

想象一下，你有一个 AI 助手，它不仅能帮你写代码，还能帮你设计架构、审查代码质量、管理技术债务——这就是 OpenMoGuQAQ 想要实现的目标。

为什么叫 “开源了我自己”？

因为这个项目本质上是我作为开发者的工作方式、思维模式和最佳实践的结晶。它包含了：

我的开发哲学：工程稳健 > 适度设计 > 风险前置 > 品味收敛
我的工作流程：从需求分析到代码实现的完整路径
我的质量标准：代码审查的严格标准和评分体系
我的复盘习惯：技术债务管理和规范迭代的方法

所以，当我把这个项目开源时，我确实是在”开源我自己”——把我的开发方式分享给全世界；也是在”规范我自己”——避免犯下红线中的错误。

项目架构

OpenMoGuQAQ 采用了分层架构设计，主要包括以下几个核心层：

架构层（Architecture）

负责需求分析和架构设计，包含：

前置三问：明确需求边界
五层拆解：系统化设计方法
破坏性评估：风险前置管理

当用户说 /design、/plan 或明确请求”设计架构/方案评审”时，AI 会自动加载架构层规范，执行完整的分析流程。

实现层（Implementation）

负责代码生成和功能实现，强调：

命名规范：驼峰命名、公有暴露
模块化设计：单职责原则
错误处理：全场景入参校验
嵌套控制：函数嵌套不超过 3 层

当用户说 /code、/impl 或明确请求”写代码/修复 Bug/实现功能”时，AI 会切换到实现层。

审查层（Review）

负责 PR 审查和代码诊断，采用四层过滤机制：

工程质量层：代码规范、错误处理、资源回收
业务逻辑层：功能正确性、边界条件
性能优化层：时间/空间复杂度、瓶颈分析
Linus 品味层：简洁性审查（仅用于收紧标准，不阻断合理实现）

审查层的设计参考了 Pensieve 项目中的代码审查理念，在其基础上进行了扩展和适配。

审查结果会以 🟢/🟡/🔴 三级评分输出，附带致命缺陷清单和优化指引。

迭代层（Iteration）

负责复盘沉淀和债务管理，包含：

高频反模式识别：发现重复出现的问题
技术债务追踪：记录和管理技术债务
规范演进建议：推动开发规范持续优化

智能路由系统

OpenMoGuQAQ 最主要的部分是它的智能路由系统。它能根据用户的指令自动判断应该加载哪个层的规范：

用户指令	加载层
`/design`、`/plan`、”设计架构”	架构层
`/code`、`/impl`、”写代码”	实现层
`/review`、`/check`、”审查代码”	审查层
`/iterate`、`/debt`、”复盘”	迭代层

这种设计让 AI 助手能够根据上下文智能切换工作模式，就像一个经验丰富的开发者会根据任务类型调整自己的工作方式一样。

ToolGuard：工具调用保障

项目还包含一个名为 ToolGuard 的透明保障层。当 AI 需要调用工具（如读取文件、搜索内容、执行命令等）时，ToolGuard 会自动介入，确保：

响应校验：确保工具返回有效结果
错误分类：智能判断错误类型
退避重试：自动重试失败的操作
降级处理：在必要时提供备选方案

这解决了 AI 开发中一个常见问题：工具调用失败时的优雅处理。

技术栈支持

虽然 OpenMoGuQAQ 本身是一个技能集规范，但它特别针对我个人常用的以下技术栈进行了优化：

Go 语言：后端服务开发
Vue3：前端界面开发
边缘计算：分布式系统设计
运维：系统部署和监控

开源协议与使用限制

项目采用 CC BY-NC-SA 4.0 协议，这意味着：

✅ 可以自由学习和参考
✅ 可以在非商业项目中使用
❌ 禁止商业使用
❌ 禁止用于商业 AI 模型训练

如何使用

OpenMoGuQAQ 可以作为：

AI 助手的技能扩展：为 AI 开发助手提供专业领域知识
开发团队的规范参考：作为团队开发规范的基础
个人学习材料：学习全栈开发的最佳实践

使用方式很简单，将项目中的 Skill 文件放到对应目录即可。

结语

开源 OpenMoGuQAQ 对我来说是一次有趣的尝试。它不仅仅是一个代码项目，更是我作为开发者的一次自我表达。

如果你对这个项目感兴趣，欢迎访问：https://github.com/mogumc/OpenMoGuQAQ

MoGuQAQ's blog