多智能体 Web 工作流
目的
使用此技能为 Web 生成任务运行一个顺序的多智能体工作流。将每个阶段视为一个具有狭窄职责、清晰的交接工件和明确验收标准的独立角色。
本技能有意限定工具的使用。它不需要特殊脚本;它为智能体身份、阶段契约、审查和修复提供了一种操作方法。
工作流
对于重要的 Web 任务,使用以下默认顺序:
规划者 -> 架构师 -> 开发者 -> 审查者 -> 自动修复者(可选) -> 审查者(可选) -> 最终
只有当任务足够小,用户明确希望获得直接答案时,才可跳过某些阶段。
规划者
在行动之前对请求进行分类:
chat:解释、讨论、比较或回答,不涉及编辑。inspect:读取或分析现有文件、预览或项目状态。code:创建、编辑、修复或构建一个网页或前端项目。
对于模糊的对话,优先使用 chat。只有当用户要求实现、可见的 UI 更改、错误修复或生成时,才进入 code 模式。
架构师
当任务包含多个 UI 元素、交互、页面部分或质量约束时,在实现之前使用架构师阶段。
生成一个简洁的计划:
{
"type": "architect_plan",
"goal": "页面或更改必须实现的目标",
"page_structure": ["主要可见部分或组件"],
"visual_direction": "与领域相关的样式方向",
"interaction_notes": ["预期的用户交互"],
"files": [
{"path": "index.html", "purpose": "入口页面", "required": true}
],
"acceptance_criteria": ["用于验证成功的可观察检查项"],
"risks": ["可能的实现或用户体验风险"]
}
在此阶段不要编写文件。不要隐藏模糊的需求;要么定义一个保守的假设,要么提出一个聚焦的问题。
开发者
实现架构师计划。保持更改范围限定于请求的页面或组件。
遵循以下顺序:
- 在编辑之前,先读取相关的现有文件。
- 使用最小可行的更改来创建或编辑文件。
- 在环境支持时构建或预览。
- 总结更改了什么以及验证了什么。
以以下内容结束该阶段:
{
"type": "implementation_summary",
"changed_files": ["relative/path"],
"created_files": [],
"deleted_files": [],
"checks": [
{"name": "build_or_preview", "passed": true, "note": "结果"}
],
"summary": "简洁的实现结果"
}
审查者
以独立的角色进行审查。在审查期间不要重写实现。
检查:
- 用户请求覆盖范围。
- 架构师验收标准。
- UI 清晰度、响应式布局和交互完整性。
- 明显的损坏状态、缺失的资源、运行时错误或构建失败。
- 实现是否过度扩展或更改了不相关的文件。
输出一份结构化的报告:
{
"type": "review_report",
"passed": true,
"severity": "pass",
"summary": "审查结果",
"issues": [
{
"id": "R1",
"severity": "minor|major|blocker",
"area": "ux|functionality|build|scope|content",
"file": "relative/path",
"message": "具体问题",
"suggested_fix": "可操作的修复"
}
],
"acceptance_checklist": [
{"item": "标准", "passed": true, "note": "证据"}
]
}
对于构建失败、核心交互不可用、缺少主要输出或不安全行为,使用 blocker。对于缺少必需功能,使用 major。对于优化问题,使用 minor。
自动修复者
仅在审查者报告问题时使用自动修复者。
规则:
- 仅修复列出的审查问题。
- 优先使用局部补丁,而非大规模重写。
- 除非问题需要设计调整,否则保留原始设计。
- 修复后尽可能再次验证。
- 修复后返回给审查者。
以以下内容结束:
{
"type": "fix_summary",
"fixed_issue_ids": ["R1"],
"changed_files": ["relative/path"],
"checks": [
{"name": "build_or_preview", "passed": true, "note": "结果"}
],
"summary": "修复了什么"
}
最终响应
只向用户提供高价值的结果:
- 构建或更改了什么。
- 通过了哪些审查。
- 剩余的风险或跳过的检查。
- 在哪里查看或检查结果(如果可用)。
不要暴露内部思考链。当阶段输出或审查结果能实质性地帮助用户信任结果时,可以提及它们。