mcpField
A
agent-patterns

agent-patterns

github.com/jeremylongshoreAgent 工作流2.9k39 次安装2 天前更新
代码仓库

关于 agent-patterns

agent-patterns 规定 Sprint 中项目架构师协调实施与测试 Agent 的方式。它通过限定范围的启动请求和结构化报告来组织并行工作、审查进度。

主要功能

  1. 01限定范围的 Agent 启动请求
  2. 02结构化完成报告
  3. 03按领域划分并行任务
  4. 04UI 测试报告格式
  5. 05Sprint 状态跟踪

适用场景

  1. 01协调后端与前端实施
  2. 02安排实施 Agent 完成后的测试
  3. 03审查规格符合度与测试结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace --skill agent-patterns

安装后在 Claude Code 中输入/agent-patterns确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
errors.md
examples.md
ui-test-report.md

详细介绍

Agent 模式

概述

Agent 模式定义了 Sprint 插件中多 Agent 冲刺执行的协调协议。它规定了项目架构师如何启动实现和测试 Agent、Agent 如何通过结构化报告交流结果，以及并行 Agent 如何避免冲突。

前提条件

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

说明

  1. 使用 SPAWN REQUEST 格式构造每次 Agent 启动请求。包含 Agent 名称、它应读取的规范文件，以及任何范围限制：

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

  2. 确保每个启动的 Agent 只接收与其范围相关的文件。将 api-contract.md 作为共享接口传递，以便后端和前端 Agent 保持同步。

  3. 在每个 Agent 完成后收集结构化报告。每份报告都必须包含：已完成的工作、修改的文件、新增的测试，以及相对于规范的符合状态。

  4. 并行运行 Agent 时，按领域边界划分工作（例如，后端、前端、CI/CD）。切勿将重叠的文件路径分配给并行 Agent。

  5. 将 Agent 报告反馈给项目架构师进行审核。架构师决定是迭代（使用范围更窄的规范重新启动 Agent），还是进入下一阶段。

  6. 对于测试 Agent，传递 ${CLAUDE_SKILL_DIR}/references/ui-test-report.md 中所示的 UI 测试报告格式，使结果遵循统一的架构，包括测试数量、覆盖率、失败项和控制台错误。

输出

  • 供 Sprint 编排器使用、用于启动 Agent 的 SPAWN REQUEST 块
  • 包含以下内容的结构化 Agent 报告：摘要、变更文件、测试结果和符合状态
  • 包含通过/失败数量、覆盖率详情、失败描述和控制台错误日志的 UI 测试报告
  • 每次迭代后更新的 status.md，反映已完成和剩余的工作

错误处理

错误原因解决方案
Agent 收到错误的规范文件SPAWN REQUEST 中的路径不正确启动前核对 Sprint 目录编号和文件名
并行 Agent 修改的文件发生重叠范围边界定义不清晰按领域划分工作；为每个 Agent 分配不同的目录
Agent 报告缺少必填字段Agent 指令中缺少报告格式在 Agent 提示词中加入结构化报告模板
无限迭代循环规范始终未能完全满足检查 status.md 中的阻塞问题；编排器会在 5 次迭代后暂停
找不到 AgentSPAWN REQUEST 中的 Agent 名称拼写错误确认 agents/ 目录中存在相应的 Agent Markdown 文件

示例

启动并行实现 Agent：

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

两个 Agent 共用同一个 api-contract.md，以确保 API 兼容性。

结构化 Agent 报告格式：

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

测试 Agent 协调：

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，用于了解 Agent 架构

评论

支持 Markdown