SuperHelper - SuperClaude命令智能推荐器

🚀 一个专业的SuperClaude命令推荐引擎，基于deepwiki专家咨询机制，为用户提供精准的命令建议 已经兼容最SuperClaude V3.0版本

📖 项目简介

SuperHelper是一个为SuperClaude用户设计的智能命令推荐器。它通过deepwiki专家咨询机制，分析用户需求并推荐最合适的SuperClaude命令组合，而不执行具体任务。

🎯 核心价值

🔬 专家级推荐: 基于deepwiki的SuperClaude专业知识提供精准建议
✅ 零妥协准确性: 宁可失败也不给错误建议，追求准确性第一
🔄 质量保证机制: 双重验证确保推荐的命令有效性和合理性
🎨 用户体验优先: 清晰的错误处理和明确的系统限制说明

🏗️ 项目架构

极简设计理念

用户需求 → sequential-thinking优化 → deepwiki专家咨询 → 质量审核 → 不满意就再问 → 输出准确推荐
                    ↓                        ↓
            Think Harder引擎          专家知识库查询
                    ↓                        ↓
              MCP工具不可用 → 告诉用户安装MCP工具

核心组件

🧠 deepwiki专家顾问: SuperClaude专业知识来源（主要工作者）
🔍 SuperHelper质量审核: 验证推荐准确性（质量把关）
💭 sequential-thinking: 智能需求分析和优化引擎

文件结构

superhelper/
├── README.md                      # 项目主要说明文档（本文件）
├── .claude/
│   └── commands/
│       └── superh.md              # 活跃命令文件（核心推荐逻辑）
├── docs/
│   ├── ARCHITECTURE.md            # 详细架构说明
│   ├── PLAN.md                    # 开发计划
│   └── USER_GUIDE.md              # 用户使用指南
├── backup/
│   └── superh.md                  # 核心命令推荐逻辑（5阶段智能流程）
├── CLAUDE.md                      # 项目内部说明文档
└── LICENSE                        # 许可证文件

🚀 快速开始

系统要求

Claude Code CLI工具
必需: SuperClaude
必需: deepwiki MCP工具 - 专家知识库查询
必需: sequential-thinking MCP工具 - 智能需求分析和优化引擎
可选: graphiti-memory MCP工具 - 用于记忆用户偏好

安装使用

克隆项目

git clone https://github.com/moriweiji/superhelper
cd superhelper
# 将backup/superh.md复制到你的Claude命令目录
cp backup/superh.md ~/.claude/commands/superh.md
# 或者复制到项目目录（如果项目使用本地配置）
cp backup/superh.md .claude/commands/superh.md

配置MCP工具（重要）确保已安装必需的MCP工具，这是SuperHelper的核心依赖

# 添加sequential-thinking
claude mcp add --scope user sequential-thinking npx @modelcontextprotocol/server-sequential-thinking

# 添加deepwiki
claude mcp add --transport sse --scope user deepwiki https://mcp.deepwiki.com/sse

开始使用

# 在Claude Code中使用
/superh "项目分析"
/superh "构建全栈应用"
/superh "优化代码性能"

# 技术说明：参数通过$ARGUMENTS占位符传递给命令文件

注意事项
- 重要提醒: 使用/superh命令后，务必执行/clear或开启新终端，避免上下文污染导致循环执行

💡 使用示例

基本用法

# 单命令推荐
/superh "项目分析"

# 复杂场景工作流推荐
/superh "构建React + Node.js全栈应用"

# 模糊需求自动优化
/superh "让代码跑得更快"

典型场景

📊 项目分析: 代码结构分析、依赖关系梳理
🏗️ 功能开发: 新功能实现、模块构建
⚡ 性能优化: 代码优化、构建优化
🧪 质量保证: 测试编写、代码审查
📚 文档生成: API文档、使用指南

🔧 工作原理

5阶段智能推荐流程

📥 用户需求输入: 接收用户输入的参数($ARGUMENTS)，启动智能流程
🧠 需求智能优化: 使用sequential-thinking处理模糊需求，转换为专业描述
🔍 专家知识库查询: 向deepwiki专家咨询SuperClaude命令推荐
✅ 质量确认: 验证命令有效性、参数合理性、解释完整性
📋 格式化输出: 按标准格式提供推荐、解释和后续建议

质量保证机制

审核标准:
  命令有效性:
    - 命令是否存在于SuperClaude中？
    - 参数组合是否合理？
    - 语法是否正确？
  
  推荐完整性:
    - 是否充分解释了选择理由？
    - 是否提供了预期效果？
    - 是否有后续步骤建议？
  
  用户体验:
    - 推荐是否匹配用户需求？
    - 复杂度是否适中？
    - 是否有必要的安全提示？

📚 文档

📐 架构说明 - 详细的系统架构和设计理念
📋 开发计划 - 项目路线图和开发计划
📖 用户指南 - 详细的使用说明和最佳实践

🛠️ 技术特点

核心优势

🎯 极简架构: 专注核心功能，避免不必要的复杂度
🔬 专家级咨询: 基于deepwiki的SuperClaude专业知识
✅ 质量保证: 双重验证确保推荐准确性
🔄 迭代改进: 不满意就继续优化直到获得满意结果
🚫 零妥协准确性: 宁可失败也不给错误建议

性能指标

准确性: 基于最新SuperClaude项目信息
响应速度: 取决于deepwiki查询（通常2-5秒）
资源占用: 基本为零（纯Markdown + MCP工具）
维护成本: 极低（主要依赖deepwiki专业知识）

⚠️ 重要说明

系统限制

仅推荐，不执行: SuperHelper只推荐命令，不执行具体任务
依赖MCP工具: 核心功能依赖sequential-thinking和deepwiki MCP工具的可用性
准确性第一: 追求准确性，不接受"凑合的备选方案"

错误处理

错误处理策略:
  MCP工具不可用:
    - 明确告知用户安装sequential-thinking和deepwiki要求
    - 不提供"凑合的备选方案"
    - 提供具体的安装命令和解决步骤

  推荐质量不达标:
    - 最多尝试3次deepwiki查询迭代
    - 持续优化直到满意
    - 如仍不满意，告知限制并建议用户澄清需求

🤝 贡献

欢迎贡献代码、报告问题或提出改进建议！

开发指南

Fork项目
创建特性分支
提交更改
推送到分支
创建Pull Request

改进方向

专家咨询优化: 改进向deepwiki提问的模板和策略
质量标准提升: 根据用户反馈完善审核标准
用户体验: 优化推荐格式、错误处理、说明文档
Think Harder引擎: 改进模糊需求的处理逻辑

📄 许可证

本项目采用MIT许可证 - 查看 LICENSE 文件了解详情

🔗 相关链接

SuperClaude项目 - 主项目
Claude Code文档 - 官方文档
deepwiki MCP工具 - 核心依赖

🚀 SuperHelper v2.0 - 专注、直接、有效的SuperClaude命令推荐器

</div>

Superhelper

Install / Use

README