Agentic Workflow

作者 parcadeid07ff4b06b62无许可证3.9K 个星标收录于 2026年10月8日更新于 2026年10月8日仓库8个月前更新

Agentic Workflow Pattern

AI 生成的概览

定义用于实现任务的五阶段多智能体流水线,研究、规划、验证、实现与审查智能体之间通过文件交接。

功能
该技能描述了一套用于实现工作的标准多智能体工作流模式。它规定了五个阶段——研究、规划、验证、实现和审查——每个阶段都作为后台子智能体运行,并把输出写入 .claude/cache/agents/ / 下的文件,供下一阶段作为上下文读取。它还涉及进度监控、卡住检测以及交接产物的目录结构。
适用场景
在为编码实现任务编排多智能体流水线,并希望有明确的阶段顺序和基于文件的交接时使用。它适合主对话只做编排、智能体在后台运行的场景。
运行要求
仅为说明性内容,技能不附带脚本。它假定运行环境具备 Task 工具和后台子智能体,以及指定的子智能体类型(oracle、plan-agent、validate-agent、agentica-agent、review-agent)、/nia-docs 技能、NIA Oracle、RP-CLI,以及可写的 .claude/cache/agents/ 目录。

Agentic Workflow Pattern

Standard multi-agent pipeline for implementation tasks.

Architecture Principles

  • Use run_in_background: true for all agents to keep main context minimal
  • Use Task tool (never TaskOutput) to avoid receiving full agent transcripts
  • Agents write outputs to .claude/cache/agents/<stage>/ for injection into subsequent agents
  • Main conversation is pure orchestration — no heavy lifting, only coordination

Workflow Stages

1. Research Agent

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""")
  • Enforce NIA as the research layer
  • Output: Research findings

2. Planning Agent

Task(subagent_type="plan-agent", run_in_background=true, prompt="""Read: .claude/cache/agents/oracle/<task>-research.mdUse RP-CLI to analyze the target codebase section.Generate implementation plan informed by research.
Output to: .claude/cache/agents/plan-agent/<task>-plan.md""")
  • Receives: Research agent output as context
  • Output: Implementation plan

3. Validation Agent

Task(subagent_type="validate-agent", run_in_background=true, prompt="""Read: .claude/cache/agents/plan-agent/<task>-plan.mdRead: .claude/cache/agents/oracle/<task>-research.mdReview plan against research findings and best practices.
Output to: .claude/cache/agents/validate-agent/<task>-validated.md""")
  • Reviews plan against research
  • Output: Validated plan with amendments

4. Implementation Agent

Task(subagent_type="agentica-agent", run_in_background=true, prompt="""Read: .claude/cache/agents/validate-agent/<task>-validated.mdRead: .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""")
  • Receives: Validated plan + research context
  • TDD: Failing tests first
  • Output: Implementation + tests

5. Review Agent

Task(subagent_type="review-agent", run_in_background=true, prompt="""Read: .claude/cache/agents/implement-agent/<task>-implementation.mdRead: .claude/cache/agents/validate-agent/<task>-validated.mdRead: .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""")
  • Cross-references all artifacts
  • Confirms tests pass
  • Output: Review summary

Agent Progress Monitoring

bash
# 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

Stuck detection:

  1. Progress reminders stop arriving
  2. Task output file size stops growing
  3. Expected output file not created after reasonable time

Directory Structure

.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

Key Rules

  1. Never use TaskOutput - floods context with 70k+ token transcripts
  2. Always run_in_background=true - isolates agent context
  3. File-based handoff - each agent reads previous agent's output file
  4. Poll, don't block - check file system for outputs, don't wait
  5. TDD in implementation - failing tests first, then make them pass

Source

  • Session 2026-01-01: SDK Phase 3 implementation using this pattern

来源与署名

来源:parcadei/continuous-claude-v3位于.claude/skills/agentic-workflow提交d07ff4b

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架