# vstack：在VS Code中构建结构化多智能体工作流的新范式

> vstack是一个原生集成于VS Code的AI工程工作流系统，通过六个固定角色（产品、架构、设计、工程、测试、发布）实现从需求到发布的完整软件开发生命周期管理。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-04-19T22:45:08.000Z
- 最近活动: 2026-04-19T22:51:46.208Z
- 热度: 148.9
- 关键词: AI Agent, VS Code, Multi-agent Workflow, GitHub Copilot, Software Development, Code Review, Automation
- 页面链接: https://www.zingnex.cn/forum/thread/vstack-vs-code
- Canonical: https://www.zingnex.cn/forum/thread/vstack-vs-code
- Markdown 来源: ingested_event

---

# vstack：在VS Code中构建结构化多智能体工作流的新范式

## 项目背景与定位

在AI辅助编程工具日益普及的今天，开发者面临着一个核心挑战：如何让多个AI智能体协同工作，而不是各自为战。vstack项目正是针对这一痛点而诞生的解决方案。它受到gstack启发，但选择了一条不同的路径——完全围绕VS Code原生环境重建，采用模板驱动的工作流模型。

vstack的核心定位是成为VS Code内的AI工程工作流系统，提供结构化技能（skills）——这些技能可由GitHub Copilot在Agent模式下执行——涵盖软件开发的规划、审查、验证和发布等关键环节。与通用AI工具不同，vstack的设计理念是：构建什么（微服务、API、包、应用、全栈系统）由产品愿景决定，而vstack通过六个固定角色来适应这一愿景。

## 六大核心角色与职责划分

vstack的创新之处在于其明确的角色分工体系。每个角色都有特定的职责和对应的技能集：

### 1. 产品角色（@product）
产品智能体是需求的入口点，负责收集需求、定义验收标准，并在整个流程中保持产品愿景的一致性。它使用的主要技能包括vision（愿景验证）、requirements（需求分析）、onboard（项目引导）和docs（文档生成）。产品角色默认采用紧凑模式（compact）输出，确保信息密度。

### 2. 架构角色（@architect）
架构智能体负责技术设计的审查和决策记录。它的核心技能是architecture（架构审查）和adr（架构决策记录）。与其他角色不同，架构角色默认使用标准模式（normal）输出，因为架构决策通常需要更详尽的解释。

### 3. 设计角色（@designer）
设计智能体专注于API契约和接口规范的定义。它掌握的技能包括design（设计模式）、openapi（OpenAPI规范生成）、consult（设计咨询）和docs（文档）。设计角色同样采用紧凑模式，确保设计文档简洁明了。

### 4. 工程角色（@engineer）
工程智能体是代码实现的核心执行者。它的技能涵盖code-review（代码审查）、debug（调试）、refactor（重构）、migrate（迁移）、dependency（依赖管理）和docs（文档）。工程角色默认紧凑模式，适合快速迭代的开发场景。

### 5. 测试角色（@tester）
测试智能体负责全面的质量保证工作。它的技能最为丰富，包括verify（验证）、inspect（检查）、security（安全审计）、incident（事件响应）、dependency（依赖检查）和docs（文档）。测试角色默认使用超紧凑模式（ultra），只输出事实和命令，适合高效的自动化测试流程。

### 6. 发布角色（@release）
发布智能体负责发布门禁管理和发布说明生成。它的技能包括release-notes（发布说明）、pr（PR管理）和docs（文档）。发布角色采用紧凑模式，确保发布流程高效顺畅。

## 工作流编排机制

vstack的一大亮点是其强大的工作流编排能力。产品智能体可以调用其他智能体作为子智能体，协调完成完整的端到端流程。例如，当开发者输入"@product Deliver a requirements-to-release plan for a new payments service"时，系统会自动触发以下流程：

1. @product → 需求收集与分析
2. @architect → 架构设计审查
3. @designer → API契约定义
4. @engineer → 代码实现
5. @tester → 全面验证
6. @release → 发布门禁控制

这种编排不是简单的顺序执行，而是基于依赖关系的智能调度。每个角色完成自己的任务后，会将结果传递给下游角色，形成一条完整的价值交付链。

## 技能调用与响应控制

vstack提供了灵活的调用方式。开发者可以直接通过@角色名来调用特定智能体，也可以直接调用技能（如/verify、/security）。更精细的控制是通过/concise命令来调整响应密度：

- /concise normal：完整解释（架构角色默认）
- /concise compact：简短散文，保持技术准确性（大多数角色默认）
- /concise ultra：最大简洁度，仅事实和命令（测试角色默认）
- /concise status：显示当前模式、会话覆盖和智能体默认设置

这种模式控制是会话范围的，无需重新安装即可切换。值得注意的是，安全警告和破坏性操作提示始终使用normal模式，不受当前模式设置影响。

## 模型选择建议

vstack针对不同场景推荐了不同的模型选择策略：

对于产品规划和架构审查这类需要深度推理的任务，推荐使用Claude Sonnet 4.6或Claude Opus 4.6。测试和工程任务使用Claude Sonnet 4.6即可在速度、质量和成本之间取得最佳平衡。发布任务同样适合使用Claude Sonnet 4.6。对于复杂调试场景，可以考虑升级到Claude Opus 4.6或GPT-5.3 Codex。

## 典型开发工作流

vstack设计了一个典型的新功能开发工作流：

1. /vision — 验证方案可行性
2. /architecture — 锁定技术设计
3. （实际编码实现）
4. /verify — 测试和验证
5. /release — 执行发布

这个流程体现了vstack的核心理念：AI智能体不是替代开发者，而是作为结构化流程中的协作伙伴，每个环节都有明确的输入输出和质量门禁。

## 技术实现与扩展性

vstack使用Python 3.11-3.14开发，通过pip安装后即可使用。安装后可以通过vstack install --target命令将vstack工件安装到指定项目，或使用--global标志安装到VS Code用户配置文件，使其在所有项目中可用。

项目采用模板驱动架构，源文件位于src/vstack/_templates/目录下，包含skills、agents、instructions和prompts四个类别。每个模板由config.yaml（前置元数据字段）和template.md（指令主体）组成。这种设计使得扩展新角色或技能变得简单直观。

## 实践意义与展望

vstack代表了AI辅助软件开发的一个重要发展方向：从单点工具向系统化工作流的演进。它解决了当前AI编程工具普遍存在的碎片化问题，通过明确的角色定义和流程编排，让多个AI智能体能够像真正的团队一样协作。

对于开发团队而言，vstack的价值在于提供了一套可重复、可审计的开发流程。每个决策都有对应的角色负责，每个输出都有明确的技能支撑，整个流程可以被记录、回放和优化。这种结构化方法不仅提高了开发效率，更重要的是提升了软件质量和团队协作的可预测性。

随着AI能力的不断增强，类似vstack这样的系统化工作流框架将成为大型软件项目的标准配置，帮助人类开发者更好地驾驭AI的力量，构建更复杂、更可靠的软件系统。