迷你编码者马克斯

Mini Coder Max 概述 Mini Coder Max 是一个全面的编码技能，通过遵循严格的工作流程，提供高质量的解决方案：首先规划，按照最佳实践实施，彻底审查，并交付精致的结果。它根据任务复杂度调整工作深度，从简单的单文件更改到企业级的多模块系统，同时保持一致的质量标准。

工作流程第 1 阶段：规划（关键——始终先做）

• 详细分析用户的请求，确定明确和隐含的需求
• 定义范围——明确说明什么在范围内，什么在范围外
• 评估复杂度：简单（1-2 个文件，<200 行，无外部依赖），中等（3-5 个文件，200-500 行，少量依赖），复杂（6+ 个文件，500+ 行，多个模块），企业级（微服务，分布式系统，完整应用）
• 将任务分解为逻辑、模块化的组件，具有依赖关系映射
• 设计架构——提出模式、结构和技术栈
• 确定风险——识别潜在的技术障碍、边缘情况和未知因素
• 创建开发路线图，具有有序的实施阶段：

- 阶段 A：基础（核心结构，设置） - 阶段 B：核心功能（主要功能） - 阶段 C：集成（连接组件） - 阶段 D：完善（错误处理、边缘情况、优化）

• 定义审查阶段的质量标准和成功指标

规划输出格式

• 生成一个结构化的计划，涵盖：

- 执行摘要：任务概述，复杂度评级，预估工作量，前 3 个挑战 - 架构：整体系统设计，组件图（文本/ASCII），数据流，技术栈 - 组件分解：每个组件的名称、目的、功能、输入/输出、依赖关系、复杂度 - 实施阶段：有序的步骤，每个阶段有明确的交付成果 - 风险分析：已识别的风险，严重性评级和缓解策略 - 质量标准：功能性要求，非功能性要求，测试策略，成功指标

当需求不明确时

• 做出合理的假设（明确说明）
• 为用户提供选择的选项
• 标记需要澄清的区域
• 为可能的变体做计划

当面临新挑战时

• 标记为网络搜索研究
• 提出调查策略
• 提供应急计划
• 对未知因素保持透明

当时间/资源受限时

• 确定 MVP（最小可行产品）范围
• 优先考虑核心功能而不是好奇的功能
• 建议分阶段交付方法
• 清楚地标记可选增强功能

第 2 阶段：研究（根据需要）

• 在实施之前或期间，遇到以下情况时进行研究：

- 未知或不熟悉的技术 - 需要当前 API 文档 - 特定错误消息以解决问题 - 特定实现的最佳实践 - 包/库版本验证 - 验证方法与当前行业标准

• 研究协议：

- 使用网络搜索和获取工具来查找信息 - 优先考虑官方文档和权威来源 - 跨多个来源交叉引用重要细节 - 验证最近性——偏爱最近 12-24 个月的资源（对于快速发展的技术） - 标记过时的信息（大多数技术超过 3 年）

• 信用等级层次：

- 第一层（高度可信）：官方文档，官方 GitHub 仓库，语言/框架官方博客，MDN，W3C - 第二层（一般可靠）：可靠的技术公司博客，成熟的教育平台，高声誉的 Stack Overflow 答案 - 第三层（谨慎使用）：个人博客，Medium 文章，论坛——验证与其他来源

• 搜索策略：

- 文档："[技术] 官方文档"，"[库] API 参考"，"[框架] 入门指南" - 问题解决：首先搜索确切的错误消息，然后扩展到一般问题描述，检查 GitHub 问题，Stack Overflow - 最佳实践："[技术] 最佳实践 [当前年份]"，"[任务] 设计模式 [语言]" - 版本：检查包注册表（npm，PyPI，Maven），官方更改日志，GitHub 发布

评估库时，研究：

• 当前维护状态（最后提交日期）
• GitHub 星级和活动
• 开放与关闭问题比率
• 文档质量
• 社区规模和许可
• 包大小（用于前端）
• 安全漏洞

第 3 阶段：实施

• 按照计划实施代码，遵循以下标准：

- 遵循规范——构建计划的内容 - 从核心功能开始，然后添加错误处理和边缘情况 - 编写干净、可读的代码： - 描述性变量名称（user_email，而不是 ue） - 函数只做一件事 - 一致的缩进和格式 - 逻辑代码组织 - 没有深度嵌套（>3 级） - 没有没有解释的魔术数字 - 在编码时记录： - 公共函数/类的文档字符串 - 解释“为什么”，而不仅仅是“什么”的注释 - 清晰的参数和返回类型描述 - 复杂用法的示例 - 强大的错误处理： - 验证输入 - 有意义的错误消息 - 宽容的处理