SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场agent-patterns

agent-patterns

智能体与模型

查看项目

更新于 10-16 09:09

技能介绍

用途

Agent Patterns 定义了 Sprint 插件内多智能体冲刺执行的协调协议。它管理项目架构师如何生成实现与测试智能体、智能体如何通过结构化报告沟通结果，以及并行智能体如何避免冲突。当用户询问 SPAWN REQUEST 格式、智能体报告、智能体协调、并行智能体、报告格式等内容时，应使用此技能。

主要能力

  • 以 SPAWN REQUEST 格式生成智能体，包含智能体名称、应读取的规格文件及范围约束。
  • 确保每个生成的智能体仅接收与其范围相关的文件，并将 api-contract.md 作为共享接口传递，使后端与前端智能体保持同步。
  • 在智能体完成后收集结构化报告，每份报告必须包含：已完成工作、修改的文件、新增的测试以及针对规格的合规状态。
  • 并行运行智能体时，按领域边界（如后端、前端、CI/CD）划分工作，绝不将重叠的文件路径分配给并发智能体。
  • 将智能体报告反馈给项目架构师进行审查，由架构师决定是迭代（以收窄的规格重新生成）还是推进到下一阶段。
  • 对于测试智能体，传递 ${CLAUDE_SKILL_DIR}/references/ui-test-report.md 中展示的 UI 测试报告格式，使结果遵循一致的架构，包括测试数量、覆盖率、失败和 console 错误。

使用方式

前置条件

  • 已安装并配置 Sprint 插件（/plugin install sprint）
  • 已在 .claude/sprint/[N]/ 初始化 Sprint 目录
  • 已编写 specs.md，包含明确的范围与测试配置
  • 熟悉冲刺阶段生命周期（参见 sprint-workflow 技能）

操作步骤

  1. 使用 SPAWN REQUEST 格式构建每次智能体生成。包含智能体名称、应读取的规格文件及任何范围约束：
SPAWN REQUEST
Agent: python-dev
Specs: .claude/sprint/1/backend-specs.md
Contract: .claude/sprint/1/api-contract.md
Scope: Authentication endpoints only

  1. 确保每个生成的智能体仅接收与其范围相关的文件。将 api-contract.md 作为共享接口传递，使后端与前端智能体保持同步。

  2. 在智能体完成后收集结构化报告。每份报告必须包含：已完成工作、修改的文件、新增的测试以及针对规格的合规状态。

  3. 并行运行智能体时，按领域边界（如后端、前端、CI/CD）划分工作。绝不将重叠的文件路径分配给并发智能体。

  4. 将智能体报告反馈给项目架构师进行审查。架构师决定是迭代（以收窄的规格重新生成）还是推进到下一阶段。

  5. 对于测试智能体，传递 ${CLAUDE_SKILL_DIR}/references/ui-test-report.md 中展示的 UI 测试报告格式，使结果遵循一致的架构，包括测试数量、覆盖率、失败和 console 错误。

输出

  • 由冲刺编排器消费以启动智能体的 SPAWN REQUEST 块
  • 包含摘要、更改的文件、测试结果和合规状态的结构化智能体报告
  • 包含通过/失败计数、覆盖率详情、失败描述和 console 错误日志的 UI 测试报告
  • 每次迭代后反映已完成和剩余工作的更新后的 status.md

适用场景

  • 多智能体冲刺执行中的协调与通信
  • 并行实现智能体（如后端与前端）的生成与同步
  • 测试智能体（QA、UI 测试）的协调与报告标准化
  • 项目架构师对智能体报告的审查与迭代决策

限制

  • 需要预先安装并配置 Sprint 插件，初始化 Sprint 目录并编写 specs.md。
  • 并行智能体必须按领域边界划分，不得分配重叠文件路径。
  • 编排器在 5 次迭代后暂停，以避免无限迭代循环。
  • 智能体名称必须与 agents/ 目录中的 markdown 文件匹配，否则会报“Agent not found”。
  • 智能体报告必须包含结构化模板中的必需字段，否则报告不完整。

错误处理

错误 原因 解决方案
智能体收到错误的规格文件 SPAWN REQUEST 中的路径不正确 在生成前验证冲刺目录编号和文件名
并行智能体修改重叠文件 范围边界未清晰定义 按领域划分工作；为每个智能体分配不同的目录
智能体报告缺少必需字段 智能体指令缺少报告格式 在智能体提示中包含结构化报告模板
无限迭代循环 规格从未完全满足 检查 status.md 中的阻塞问题；编排器在 5 次迭代后暂停
找不到智能体 SPAWN REQUEST 中智能体名称拼写错误 验证 agents/ 目录中存在智能体 markdown 文件

示例

生成并行实现智能体

SPAWN REQUEST
Agent: python-dev
Specs: .claude/sprint/1/backend-specs.md
Contract: .claude/sprint/1/api-contract.md

SPAWN REQUEST
Agent: nextjs-dev
Specs: .claude/sprint/1/frontend-specs.md
Contract: .claude/sprint/1/api-contract.md

两个智能体共享同一个 api-contract.md 以确保 API 兼容性。

结构化智能体报告格式

AGENT REPORT
Agent: python-dev
Status: COMPLETE
Files Modified: src/auth/routes.py, src/auth/models.py, tests/test_auth.py
Tests: 12 passed, 0 failed
Conformity: All backend-specs requirements implemented
Notes: JWT token expiry set to 24h per spec

测试智能体协调

SPAWN REQUEST
Agent: qa-test-agent
Specs: .claude/sprint/1/specs.md
Run After: python-dev, nextjs-dev

SPAWN REQUEST
Agent: ui-test-agent
Specs: .claude/sprint/1/specs.md
Run After: qa-test-agent

资源

  • ${CLAUDE_SKILL_DIR}/references/ui-test-report.md -- 包含覆盖率与失败跟踪的结构化 UI 测试报告格式
  • Sprint 工作流技能，用于阶段生命周期上下文
  • API 契约技能，用于共享接口设计
  • Sprint 插件 README，用于智能体架构概览