mcpField
A
agentic-workflow

agentic-workflow

github.com/parcadeiAgent 工作流3.9k567 次安装39 周前更新
代码仓库

关于 agentic-workflow

agentic-workflow 是面向实施任务的多 Agent 工作流技能，供协调研究、规划、验证、编码和审查的团队使用。它通过文件在后台 Agent 之间传递阶段产物。

主要功能

  1. 01研究到审查的五阶段流程
  2. 02后台运行 Agent
  3. 03基于文件传递产物
  4. 04TDD 实施指导
  5. 05进度监控与停滞检测

适用场景

  1. 01协调多 Agent 实施任务
  2. 02依据研究结果审查计划
  3. 03先编写测试再实施更改

安装

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

$npx skills add https://github.com/parcadei/continuous-claude-v3 --skill agentic-workflow

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

详细介绍

Agentic 工作流模式

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

架构原则

  • 对所有 Agent 使用 run_in_background: true，以尽量减少主上下文
  • 使用 Task 工具（绝不使用 TaskOutput），避免接收完整的 Agent 对话记录
  • Agent 将输出写入 .claude/cache/agents/<stage>/，供后续 Agent 注入
  • 主对话只负责编排——不承担繁重工作，只进行协调

工作流阶段

1. 研究 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
""")
  • 强制将 NIA 用作研究层
  • 输出：研究结果
2. 规划 Agent
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
""")
  • 接收：作为上下文的研究 Agent 输出
  • 输出：实现计划
3. 验证 Agent
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. 实现 Agent
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. 审查 Agent
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
""")
  • 交叉核对所有产物
  • 确认测试通过
  • 输出：审查摘要

Agent 进度监控

# 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——隔离 Agent 上下文
  3. 基于文件交接——每个 Agent 读取前一个 Agent 的输出文件
  4. 轮询，不阻塞——检查文件系统中的输出，不要等待
  5. 在实现阶段使用 TDD——先编写失败的测试，再让测试通过

来源

  • 会话 2026-01-01：使用此模式实现 SDK 第 3 阶段

评论

支持 Markdown