ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

SuperClaude Framework `/sc` 命令分发器完全指南:架构、安装与命令实战

SuperClaude Framework `/sc` 命令分发器完全指南:架构、安装与命令实战 开发工具CLIAI 技能/插件测试人工智能AI 评测【免费下载链接】SuperClaude_FrameworkA configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies.项目地址https://gitcode.com/gh_mirrors/su/SuperClaude_Framework点击查看免费下载导读本文以 SuperClaude Framework 的命令分发器文档sc.md为核心系统讲解/sc:命令命名空间的设计、五大核心命令的用法、命令的安装与更新机制并结合仓库源码剖析其背后的安装流程与插件同步架构。读完本文你将掌握如何通过/sc入口高效调用研究、仓库索引、AI Agent 与命令推荐等全部功能并理解命令从源码到 Claude Code 的完整分发链路。一、什么是 SuperClaude Command DispatcherSuperClaude Framework 是一个为 Claude Code 提供专用命令、认知角色Cognitive Personas与开发方法论的配置框架。而命令分发器Command Dispatcher正是用户与这套框架交互的统一入口。在 src/superclaude/commands/sc.md 中该命令被明确定义为SuperClaude command dispatcher - Use/sc [command]to access all SuperClaude features也就是说/sc本身不执行具体业务逻辑而是扮演总菜单 路由器的角色它负责展示所有可用命令、帮助用户快速定位目标功能并确保所有命令统一挂在sc:命名空间之下避免与用户自建命令或 Claude Code 原生命令冲突。二、命令命名空间/sc:前缀机制所有 SuperClaude 命令统一使用/sc:前缀语法如下/sc:command [args...]这一设计带来的核心收益是组织性与可发现性✅/sc:research query—— 深度网络研究✅/sc:index-repo—— 仓库索引✅/sc:agent type—— 启动专用 AI Agent✅/sc:recommend—— 命令推荐✅/sc—— 帮助列出全部命令前缀之所以能生效取决于命令文件在 Claude Code 中的安装位置。从 src/superclaude/cli/install_commands.py 的源码可以看到命令默认安装到~/.claude/commands/sc/目录注释明确写道Default to~/.claude/commands/scto maintain/sc:namespaceClaude Code 的斜杠命令机制会将commands/下的子目录名作为命名空间前缀因此目录名sc直接决定了/sc:前缀的可用性——这是命名空间机制的底层原理。三、核心命令全解分发器目前主要承载四类核心命令下面逐一展开。3.1 研究与分析/sc:research/sc:research [query] - Deep web research with parallel search/sc:research是框架内最复杂的命令之一其完整定义见 src/superclaude/commands/research.md。它支持自适应规划adaptive planning、多跳推理multi-hop reasoning与基于证据的综合evidence-based synthesis上下文触发模式为/sc:research [query] [--depth quick|standard|deep|exhaustive] [--strategy planning|intent|unified]关键设计要点行为流遵循 Understand5-10%→ Plan10-15%→ TodoWrite5%→ Execute50-60%→ Track持续→ Validate10-15%的精力分配模型把主要算力投向搜索执行与证据验证并行优先执行同类型的查询总是批量并行发起只有存在依赖时才串行自适应深度--depth参数控制研究强度——quick为 1 跳基础搜索 摘要输出standard为 2-3 跳结构化报告deep为 3-4 跳详细分析exhaustive为 5 跳全量调查MCP 集成Tavily 作为主搜索与抽取引擎、Sequential 负责复杂推理综合、Playwright 处理 JavaScript 重内容抽取、Serena 承担研究会话持久化输出规范报告保存至claudedocs/research_[topic]_[timestamp].md包含执行摘要、置信度级别与带引用的来源列表。需要注意的硬性边界该命令只产出研究报告不实现、不写代码、不做架构决策后续动作需由用户决定可转用/sc:design或/sc:implement。3.2 仓库管理/sc:index-repo/sc:index-repo - Index repository for context optimization该命令用于为仓库生成索引显著压缩上下文占用。根据 src/superclaude/commands/index-repo.md 中的描述其核心收益是Before: 读取全部文件 → 每会话 58,000 tokensAfter: 读取PROJECT_INDEX.md→ 3,000 tokens94% 缩减索引创建分为四个阶段分析仓库结构通过 5 路并行的 Glob 搜索分别扫描代码src/**/*.{ts,py,js,tsx,jsx}等、文档、配置、测试与脚本目录提取元数据为每个文件类别提取入口点、关键模块与导出、API 面公开函数/类、依赖关系生成索引产出PROJECT_INDEX.md约 3KB人类可读与PROJECT_INDEX.json约 10KB机器可读两份文件结构涵盖项目结构树、入口点、核心模块、配置、文档、测试覆盖、关键依赖与快速开始验证检查入口点是否齐全、核心模块是否记录、索引大小是否 5KB、格式是否可读。使用模式还支持增量更新与快速模式/index-repo # 创建索引 /index-repo modeupdate # 更新已有索引 /index-repo modequick # 快速索引跳过测试其 ROI 计算索引创建一次性 2,000 tokens之后每会话仅 3,000 tokens 阅读成本对比例读取 58,000 tokens1 个会话即回本100 个会话可累计节省约 550 万 tokens。3.3 AI Agent 启动/sc:agent/sc:agent [type] - Launch specialized AI agents/sc:agent承担会话编排角色根据 src/superclaude/commands/agent.md 的描述它是session controller that orchestrates investigation, implementation, and review。典型用法/sc:agent deep-research /sc:agent self-review /sc:agent repo-index其任务协议强调先澄清范围再并行规划调查借助confidence-check实现前置信度需 ≥ 0.90、deep-research、repo-index、self-review等辅助技能/Agent 迭代到足够自信后才进入实现波次最后自审并记录残余风险。同时它强调令牌纪律使用短状态消息、合并冗余摘要、仅在用户要求时才持久化长文档。3.4 命令推荐/sc:recommend/sc:recommend [context] - Get command recommendations/sc:recommend是一个智能命令推荐引擎输入任意用户请求输出最匹配的 SuperClaude 命令组合。其完整设计见 src/superclaude/commands/recommend.md支持多语言检测土耳其语/英语、关键词抽取与 Persona 匹配、项目上下文探测React/Vue/Node API/Python/数据库项目自动识别、实时流式推荐--stream、备选方案--alternatives、时间与预算估算--estimate以及智能 Flag 推荐等八大能力。例如/sc:recommend Im new, I want to do machine learning会输出包含语言检测、等级判定Beginner Mentor Persona、四步推荐流程analyze → design → build → test、推荐 MCP 服务器与附加学习建议的完整响应。3.5 帮助/sc/sc - Show this help (all available commands)不带子命令直接输入/sc即可展示全部可用命令。实际上完整的命令参考文档位于 src/superclaude/commands/help.md其中列出了 24 个/sc命令覆盖分析/sc:analyze、头脑风暴/sc:brainstorm、构建/sc:build、设计/sc:design、文档生成/sc:document、估算/sc:estimate、实现/sc:implement、测试/sc:test、排障/sc:troubleshoot等完整能力矩阵。四、命令快速参考命令描述示例/sc:research深度网络研究并行搜索/sc:research topic/sc:index-repo仓库索引上下文优化/sc:index-repo/sc:agent专用 AI Agent 启动/sc:agent type/sc:recommend命令智能推荐/sc:recommend/sc显示全部命令帮助/sc五、安装与更新superclaude install分发器命令并非内置在 Claude Code 中需要通过 CLI 安装。入口位于 src/superclaude/cli/main.py 的superclaude install命令。5.1 安装命令参数参数默认值说明--target~/.claude/commands/sc命令安装目录--force关闭已存在时强制重装--list关闭仅列出可用/已安装命令不执行安装常用形式superclaude install # 默认安装到 ~/.claude/commands/sc superclaude install --force # 强制重装覆盖已有命令 superclaude install --list # 先查看可用命令与安装状态 superclaude install --target /custom/path执行superclaude install时CLI 会先安装斜杠命令到~/.claude/commands/sc/随后同时安装 Agent 文件到~/.claude/agents/源码见 src/superclaude/cli/main.py二者任一失败则退出码为 1。5.2 安装流程的源码细节从 src/superclaude/cli/install_commands.py 的install_commands函数可以还原完整流程定位命令源目录_get_commands_source()按优先级尝试包内commands/目录pip/pipx 安装场景即site-packages/superclaude/commands/与源码检出下的plugins/superclaude/commands/开发场景创建目标目录mkdir(parentsTrue, exist_okTrue)遍历源目录下所有*.md文件并shutil.copy2复制到目标对已存在且未加--force的命令跳过并提示输出安装/跳过/失败统计与目标目录并提示Restart Claude Code to use the new commands。superclaude update则是install --force的便捷别名见 src/superclaude/cli/main.py用于将命令刷新到当前包版本。5.3 双目录同步机制值得特别说明的是仓库中命令文件存在两份副本——plugins/superclaude/commands/源检出与src/superclaude/commands/打包分发。根据 src/superclaude/commands/README.md 的说明这些命令是plugins/superclaude/commands/的副本用于包分发更新命令时需先编辑plugins/下文件再同步到src/两处必须保持一致v5.0 中插件系统将直接使用plugins/。这一机制保证了在源码检出与pip 安装两种使用方式下_get_commands_source()都能找到命令源。六、分发器功能特性/sc分发器及其下属命令共同遵循以下设计特性并行执行Parallel Execution研究类命令的多次搜索并发运行/sc:index-repo使用 5 路并行 Glob 扫描基于证据Evidence-Based所有研究发现均附带来源与置信度标注上下文感知Context-Aware命令可感知当前仓库上下文/sc:recommend还能探测项目类型React/Vue/Python/Node API/数据库并给出针对性建议令牌高效Token Efficient通过仓库索引94% 缩减与短状态消息机制优化令牌占用行为 Flag 体系如 src/superclaude/commands/help.md 所载框架提供模式激活--brainstorm、--token-efficient、MCP 开关--c7、--seq、--magic、--no-mcp等、分析深度--think、--think-hard、--ultrathink与执行控制--validate、--safe-mode等 flag并有明确的优先级规则安全优先--safe-mode--validate、显式覆盖自动、深度层级--ultrathink--think-hard--think。七、帮助与故障排查对具体命令的深入帮助可对命令本身追加--help/sc:research --help /sc:agent --help或直接使用总帮助命令/sc查看全量命令列表。框架级文档可从仓库根目录获取PLANNING.md —— 架构与设计TASK.md —— 当前任务与优先级KNOWLEDGE.md —— 使用技巧与最佳实践八、版本信息与兼容性前提当前分发器文档对应的版本信息为SuperClaude Frameworkv4.1.7注意仓库 src/superclaude/version.py 中的 Python 包版本已迭代至4.3.0文档中的 4.1.7 反映的是该文档撰写时的状态实际版本以源码为准Python 包版本0.4.0内置 Pytest 插件已启用 PM Agent 模式使用前提命令安装完成后需要重启 Claude Code才能加载新命令所有命令均使用/sc:前缀例如/sc:research、/sc:agent。结语/sc命令分发器是 SuperClaude Framework 面向 Claude Code 用户的统一入口通过sc:命名空间将研究、仓库索引、AI Agent 编排与命令推荐四大能力组织为可发现的斜杠命令体系。其背后既有superclaude install这样封装完善的 CLI 安装链路main.pyinstall_commands.py双源目录解析也有plugins/与src/双目录同步的发布约定。理解这份分发器文档就等于拿到了整个框架命令体系的总地图。赞分享开发工具CLIAI 技能/插件测试人工智能AI 评测【免费下载链接】SuperClaude_FrameworkA configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies.项目地址https://gitcode.com/gh_mirrors/su/SuperClaude_Framework点击查看免费下载相关推荐SuperClaude Framework /sc: 命令分发器完全指南安装、命令全景与源码级解析SuperClaude Framework /sc: 命令分发器完全指南安装、命令全景与源码级解析 SuperClaude Framework 是一套为 Cl开发工具CLIAI 技能/插件测试人工智能AI 评测SuperClaude Framework 命令体系完全指南30 个 /sc 命令的定位、语法与实战编排SuperClaude Framework 命令体系完全指南30 个 /sc 命令的定位、语法与实战编排 SuperClaude Framework 是一个为开发工具CLIAI 技能/插件测试人工智能AI 评测SuperClaude Framework 命令指南21 个 Claude Code 命令的完整参考与实战用法SuperClaude Framework 命令指南21 个 Claude Code 命令的完整参考与实战用法 本文围绕 SuperClaude Framew开发工具CLIAI 技能/插件测试人工智能AI 评测创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表