⚡

代理工作流模式Skill agentic-workflow

该技能提供了一种多代理工作流模式，用于自动化软件开发任务的实现，通过协调研究、规划、验证、实施和审查代理，确保高效、高质量的代码交付。关键词：AI代理，工作流，多代理系统，软件开发，自动化，TDD，智能体协调。

AI智能体 0 次安装 0 次浏览 更新于 3/14/2026

name: agentic-workflow description: 代理工作流模式 user-invocable: false

代理工作流模式

用于实现任务的标准多代理流水线。

架构原则

  • 对所有代理使用 run_in_background: true 以保持主上下文最小化
  • 使用 Task 工具（从不使用 TaskOutput）以避免接收完整的代理转录
  • 代理将输出写入 .claude/cache/agents/<stage>/ 以注入到后续代理中
  • 主对话是纯编排 — 无繁重工作，仅协调

工作流阶段

1. 研究代理

Task(subagent_type="oracle", run_in_background=true, prompt="""
Query NIA Oracle (via /nia-docs skill) to verify approach and gather best practices.

Output to: .claude/cache/agents/oracle/<task>-research.md
""")
  • 强制 NIA 作为研究层
  • 输出：研究结果

2. 规划代理

Task(subagent_type="plan-agent", run_in_background=true, prompt="""
Read: .claude/cache/agents/oracle/<task>-research.md
Use RP-CLI to analyze the target codebase section.
Generate implementation plan informed by research.

Output to: .claude/cache/agents/plan-agent/<task>-plan.md
""")
  • 接收：研究代理输出作为上下文
  • 输出：实施计划

3. 验证代理

Task(subagent_type="validate-agent", run_in_background=true, prompt="""
Read: .claude/cache/agents/plan-agent/<task>-plan.md
Read: .claude/cache/agents/oracle/<task>-research.md
Review plan against research findings and best practices.

Output to: .claude/cache/agents/validate-agent/<task>-validated.md
""")
  • 根据研究审查计划
  • 输出：验证后的计划及修订

4. 实施代理

Task(subagent_type="agentica-agent", run_in_background=true, prompt="""
Read: .claude/cache/agents/validate-agent/<task>-validated.md
Read: .claude/cache/agents/oracle/<task>-research.md

TDD approach: Write failing tests FIRST, then implement.
Run tests to verify.

Output summary to: .claude/cache/agents/implement-agent/<task>-implementation.md
""")
  • 接收：验证后的计划 + 研究上下文
  • TDD：先编写失败的测试
  • 输出：实施 + 测试

5. 审查代理

Task(subagent_type="review-agent", run_in_background=true, prompt="""
Read: .claude/cache/agents/implement-agent/<task>-implementation.md
Read: .claude/cache/agents/validate-agent/<task>-validated.md
Read: .claude/cache/agents/oracle/<task>-research.md

Cross-reference implementation against plan and research.
Run tests to confirm passing.

Output to: .claude/cache/agents/review-agent/<task>-review.md
""")
  • 交叉引用所有工件
  • 确认测试通过
  • 输出：审查摘要

代理进度监控

# Watch for system reminders:
# "Agent a42a16e progress: 6 new tools used, 88914 new tokens"

# Poll for output files:
find .claude/cache/agents -name "*.md" -mmin -5

# Check task file size growth:
wc -c /tmp/claude/.../tasks/<id>.output

卡住检测：

  1. 进度提醒停止到达
  2. 任务输出文件大小停止增长
  3. 合理时间后未创建预期的输出文件

目录结构

.claude/cache/agents/
├── oracle/
│   └── <task>-research.md
├── plan-agent/
│   └── <task>-plan.md
├── validate-agent/
│   └── <task>-validated.md
├── implement-agent/
│   └── <task>-implementation.md
└── review-agent/
    └── <task>-review.md

关键规则

  1. 从不使用 TaskOutput - 避免用70k+令牌转录淹没上下文
  2. 始终 run_in_background=true - 隔离代理上下文
  3. 基于文件的交接 - 每个代理读取前一个代理的输出文件
  4. 轮询，不阻塞 - 检查文件系统获取输出，不等待
  5. 实施中的 TDD - 先编写失败的测试，然后使它们通过

来源

  • 会话 2026-01-01：使用此模式进行SDK第三阶段实施