ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

SuperClaude Framework 的 /sc:task 深入指南:多智能体协调与智能任务执行的实战方案

SuperClaude Framework 的 /sc:task 深入指南:多智能体协调与智能任务执行的实战方案 SuperClaude Framework 的 /sc:task 深入指南多智能体协调与智能任务执行的实战方案【免费下载链接】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:task命令src/superclaude/commands/task.md为核心系统讲解这一增强型任务管理命令的触发场景、参数语法、五阶段行为流、MCP 服务器路由机制、任务层级拆解模式与严格边界约束。读完本文你将掌握如何用/sc:task执行需要跨多个专业领域架构、前端、后端、安全、DevOps协同的复杂任务理解其与/sc:pm会话级编排、/sc:spawn任务分解、/sc:workflow计划生成的分工差异并能在真实项目中正确使用其三种执行策略systematic / agile / enterprise与--parallel、--delegate标志。一、/sc:task 是什么定位与适用场景/sc:task是 SuperClaude Framework 中一条category: special、complexity: advanced的高级斜杠命令。它的定位是用户显式触发的离散任务执行器当用户明确给出一个具体任务描述后它负责用多智能体persona协调、MCP 服务器智能路由与分阶段执行的方式把该任务做完并在完成后主动停止等待用户决定下一步。根据 task.md 中声明的 frontmatter它绑定了 6 个 MCP 服务器sequential, context7, magic, playwright, morphllm, serena与 7 个 personaarchitect, analyzer, frontend, backend, security, devops, project-manager。适合使用 /sc:task 的触发场景包括需要多智能体协调与委派的复杂任务需要结构化工作流管理与跨会话持久化的项目需要智能 MCP 服务器路由与领域专家能力的操作能从系统化执行与渐进式增强中获益的任务。反过来说如果任务足够简单、不需要高级编排就不该使用它——这一点在文档的 Boundaries 中写得很明确Will Not: Execute simple tasks that dont require advanced orchestration.二、用法与参数语法、动作与三个策略标志2.1 完整语法/sc:task [action] [target] [--strategy systematic|agile|enterprise] [--parallel] [--delegate]各组成部分的含义如下部分取值说明actioncreate/execute等执行动作如创建任务分解或执行任务target任务描述字符串用引号包裹的目标任务如enterprise authentication system--strategysystematic/agile/enterprise执行策略系统化、敏捷迭代或企业级治理--parallel布尔标志开启并行执行跨领域同时推进--delegate布尔标志开启智能委派将子任务路由给相应 persona2.2 三种策略的语义差异文档 Key Patterns 一节给出了策略选择的方向性指引Systematic系统化→ 全面comprehensive适合需要一次性完整拆解、覆盖所有领域的任务如从零构建企业级功能Agile敏捷→ 迭代iterative适合以迭代方式推进的任务强调每轮可交付、可验证如处理 backlogEnterprise企业级→ 治理governance适合需要合规校验、审计与质量门禁的企业级工程。2.3 与相邻命令的语法对照便于快速选用在 docs/user-guide/commands.md 的命令参考中与/sc:task容易混淆的三个命令是/sc:spawn [complex-task] [--strategy sequential|parallel|adaptive] [--depth normal|deep]—— 只做任务分解产出任务层级文档不执行实现详见 spawn.md/sc:workflow [prd-file|feature-description] [--strategy systematic|agile|enterprise] [--depth shallow|normal|deep] [--parallel]—— 只做计划生成从 PRD 产出实施路线图/sc:implement [feature-description] [--type ...] [--framework ...] [--safe] [--with-tests]—— 直接写代码不做多智能体编排。三者的核心区分文档中的spawn vs task vs implement对比表可以这样概括spawn 是项目经理解任务、task 是技术负责人带队执行、implement 是开发工程师直接实现——只有/sc:task通过委派既能协调又能执行且以任务完成即停止为边界。三、行为流Analyze → Delegate → Coordinate → Validate → Optimize/sc:task的执行遵循五阶段行为流Analyze分析解析任务需求判断最优执行策略Delegate委派路由到合适的 MCP 服务器并激活相关 personaCoordinate协调以智能工作流管理与并行处理执行任务Validate验证应用质量门禁quality gates与全面的任务完成校验Optimize优化分析执行性能给出增强建议。其核心行为可归纳为四点多 persona 协调跨越 architect、frontend、backend、security、devops 等领域协同工作智能 MCP 路由按任务阶段选择 Sequential、Context7、Magic、Playwright、Morphllm、Serena系统化执行渐进式任务增强progressive enhancement与跨会话持久化高级任务委派层级化拆解hierarchical breakdown与依赖管理dependency management。3.1 源码佐证并行执行引擎/sc:task所描述的并行执行 依赖管理能力在项目源码中有对应实现。位于 src/superclaude/execution/parallel.py 的ParallelExecutor提供了完整的并行编排原语Task数据类包含id、description、execute与depends_on字段can_execute()方法校验依赖是否全部满足源码 L30-L44ParallelExecutor.plan()用拓扑排序构建依赖图、识别可并行执行的组ParallelGroup并在检测到循环依赖时抛出ValueError源码 L103-L167execute()按组依次并行执行收集结果并统计实际加速比源码 L169-L234。源码中的示例example_dependent_tasks()直观展示了Wave 1 三个并行读取 → Wave 2 依赖分析 → Wave 3 生成报告的分波执行模式这正是/sc:task文档中并行执行 渐进式增强的工作形态。值得注意的工程经验来自 docs/research/parallel-execution-complete-findings.md该项目曾实测 PythonThreadPoolExecutor因 GIL 限制并行度仅有 0.91x反而更慢而改用Task 工具在 API 层并行每次 Task 调用都是独立 API 请求后获得 4.1x 加速。这意味着在 Claude Code 环境中并行更应依赖任务级/API 级并行而非进程内多线程。四、MCP 集成六个服务器的分工协作/sc:task声明依赖 6 个 MCP 服务器每个服务器在任务生命周期中承担不同职责MCP 服务器职责典型使用阶段Sequential MCP复杂多步骤任务分析与系统化执行规划分析、规划Context7 MCP框架特定模式与实现最佳实践查询设计与实现Magic MCPUI/UX 任务协调与设计系统集成前端设计Playwright MCP测试工作流集成与验证自动化测试验证Morphllm MCP大规模任务转换与基于模式的优化批量改造Serena MCP跨会话任务持久化与项目记忆管理全程持久化这种按阶段路由的思路与/sc:pm的 Phase-Based Tool Loading 模式一致可参考 pm.mdDiscovery 阶段加载 sequential、context7Design 阶段加载 magicImplementation 阶段加载 morphllmTesting 阶段加载 playwright——工具按需加载、阶段完成后卸载从而实现资源与 token 的高效利用。五、工具协调TodoWrite / Task / 读写编辑 / sequentialthinking/sc:task在 Claude Code 层面对工具的使用约定如下TodoWrite层级化任务拆解与进度追踪贯穿 Epic → Story → Task 三个层级Task高级委派用于复杂多智能体协调与子任务管理这与并行索引研究中的 Task 工具并行用法一致参见 docs/research/task-tool-parallel-execution-results.mdRead / Write / Edit任务文档编写与实现协调sequentialthinking针对复杂任务依赖分析的结构化推理。六、关键模式任务层级、策略选择、多智能体协调与跨会话管理6.1 任务层级Task HierarchyEpic 级目标 → Story 级协调 → Task 级执行 → Subtask 级粒度。任务首先被分解为层级结构再用 TodoWrite 逐级追踪保证大目标可拆解、小步骤可验证。6.2 策略选择Strategy SelectionSystematic全面→ Agile迭代→ Enterprise治理根据任务特性选择最匹配的执行策略见 2.2 节。6.3 多智能体协调Multi-Agent CoordinationPersona 激活 → MCP 路由 → 并行执行 → 结果整合。这与 docs/capability-mapping-v5.md 中描述的 persona-能力映射一致每个 persona如 security-engineer、frontend-architect只在其专业领域内被激活并被委派对应子任务。6.4 跨会话管理Cross-Session Management任务持久化 → 上下文延续 → 渐进式增强。通过 Serena MCP 保存任务状态使复杂任务可在多个会话之间无缝延续避免上下文丢失。七、实战示例三种典型用法7.1 复杂功能开发系统化 并行/sc:task create enterprise authentication system --strategy systematic --parallel # 全面的任务拆解与多领域协调 # 激活 architect、security、backend、frontend 等多个 persona典型拆解路径结合 spawn.md 中的分解逻辑可推断数据库设计 → 后端 API → 前端 UI → 安全审计 → 测试验证各阶段按依赖关系串行/并行组合。7.2 敏捷冲刺协调迭代 委派/sc:task execute feature backlog --strategy agile --delegate # 迭代式任务执行与智能委派 # 通过跨会话持久化保证冲刺连续性7.3 多领域集成企业级 并行/sc:task execute microservices platform --strategy enterprise --parallel # 企业级规模协调与合规校验 # 在多个技术领域间并行执行八、边界与 CRITICAL BOUNDARIES何时执行、何时停止8.1 常规边界BoundariesWill会做以多智能体协调与智能委派执行复杂任务提供带跨会话持久化的层级化任务拆解协调多个 MCP 服务器与 persona 以获得最优任务结果。Will Not不会做执行不需要高级编排的简单任务为速度或便利妥协质量标准在没有验证与质量门禁的情况下执行。8.2 临界边界CRITICAL BOUNDARIES用户显式触发的离散任务执行这是task.md中最重要的设计约束文档用独立章节加以强调与 /sc:pm 的本质区别维度/sc:pm/sc:task形态会话级编排后台监控、持续运行用户显式触发的离散执行有明确的开始/结束激活方式自动激活每次会话开始即运行用户输入/sc:task [description]显式触发运行特征连续、默认托管所有交互执行完指定任务后停止行为约束用户调用/sc:task [description]后命令只执行该具体任务使用多智能体协调完成任务任务完成即 STOP——在没有用户输入的情况下不得自行继续执行下一个任务。完成标准Completion Criteria任务目标已达成TodoWrite 中所有子任务被标记为 completed验证已通过Validation passed。输出Output一份任务完成报告包含完成了什么What was accomplished修改了哪些文件Files modified测试状态Tests status如适用。下一步Next Step由用户决定后续动作——用户可以选择再次调用/sc:task或改用其他具体命令如/sc:implement、/sc:test、/sc:design等。这一完成任务即交还控制权的设计正是/sc:task区别于持续编排型/sc:pm的核心。九、安装与使用前提/sc:task与其余 30 个斜杠命令通过 Python 包分发。命令源文件同时存在于两处且需保持同步src/superclaude/commands/README.md 说明了同步约定src/superclaude/commands/task.md —— 打包分发副本plugins/superclaude/commands/task.md —— 插件分发副本。安装命令详见 docs/reference/commands-list.mdsuperclaude install # 安装全部命令 superclaude install --list # 列出已安装命令 superclaude update # 更新到最新版安装完成后需重启 Claude Code即可在/sc:命名空间下使用。由于/sc:task依赖多个 MCP 服务器建议按 docs/mcp/mcp-integration-policy.md 提前配置好相关服务器同时可参考 docs/user-guide/commands.md 的命令分类总览ORCHESTRATION 类理解/sc:task在整体命令体系中的位置。十、总结/sc:task是 SuperClaude Framework 编排命令族中执行型的代表它承接/sc:spawn拆解出的任务层级、比/sc:workflow更进一步进入实际执行、又比/sc:implement多一层多智能体与 MCP 协调能力。它的价值不在于取代其他命令而在于为复杂、跨领域、需要专业分工与质量门禁的任务提供一条结构化执行路径同时用显式触发、完成即停、输出完成报告的严格边界保证用户始终掌控执行节奏。【免费下载链接】SuperClaude_FrameworkA configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies.项目地址: https://gitcode.com/gh_mirrors/su/SuperClaude_Framework创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进