mcpField
G
goap-agent

goap-agent

github.com/d-o-hubAgent 工作流1336 次安装今天更新
代码仓库

关于 goap-agent

goap-agent 是面向 Claude 的规划技能,通过目标分解、执行策略和专用 Agent 协调来组织复杂的多步工作,并提供质量检查与架构决策参考。

主要功能

  1. 01目标导向任务规划
  2. 02原子任务分解
  3. 03并行与顺序执行策略
  4. 04专用 Agent 协调
  5. 05质量关卡与验证
  6. 06结合 ADR 制定执行计划

适用场景

  1. 01规划包含五步以上的任务
  2. 02协调跨领域工作
  3. 03管理大型重构或架构变更

安装

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

$npx skills add https://github.com/d-o-hub/rust-self-learning-memory --skill goap-agent

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

包含的文件

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

agents.md
examples.md
execution-strategies.md
methodology.md
patterns.md
skills.md

详细介绍

GOAP Agent 技能

面向复杂多步骤任务的目标导向行动规划,具备智能规划与多 Agent 协调能力。

快速参考

适用场景

  • 复杂的多步骤任务(5 个以上不同步骤)
  • 跨领域问题(存储、API、测试、文档)
  • 需要并行或顺序执行的任务
  • 需要质量验证检查点的关键工作
  • 大型重构或架构变更

重要:技能与任务 Agent 的区别

技能(通过 Skill 工具):直接指导 Claude 的指令集 Agent(通过 Task 工具):执行任务的自主子流程

示例:

  • 错误:Task(subagent_type="code-quality", ...) → 错误!
  • 正确:Skill(command="code-quality") → 成功

完整技能列表请参阅 skills.md,Agent 能力请参阅 agents.md。

核心流程

  1. 分析 → 理解目标、约束和资源
    • 检查 ADR:规划前阅读 plans/adr/ 中相关的 ADR
  2. 分解 → 将任务拆分为具有依赖关系的原子任务
    • 任务分解:创建包含成功标准的目标层级(参见 patterns.md)
    • 依赖类型:顺序(A→B)、并行(A─┐B─┐)、汇聚(A─┐B─┼─>D)
  3. 制定策略 → 选择执行模式
  4. 协调 → 分配给专门的 Agent
  5. 执行 → 在监控和质量关卡下运行
  6. 综合 → 汇总结果并验证是否成功

PR 监控防护措施

  • 对于 PR 工作,在执行和综合阶段始终验证最新 head SHA 上的 statusCheckRollup。
  • 将必需检查汇总为空视为阻塞事项,并记录在 plans/STATUS/VALIDATION_LATEST.md 中。
  • 在补救检查附加之前,避免添加仅涉及计划的后续提交。

阶段的详细说明请参阅 methodology.md,常见执行模式请参阅 patterns.md。

ADR 集成工作流

必须遵守:创建执行计划前,始终检查 plans/adr/ 中的 ADR:

第 1 步:发现 ADR
# List all ADRs to identify relevant ones
ls plans/adr/ADR-*.md
第 2 步:阅读相关 ADR
  • 搜索与你的任务领域相关的 ADR
  • 记录架构决策和约束
  • 检查 ADR 状态(已接受/已实施或已弃用)
第 3 步:纳入规划
  • 分解任务时采用 ADR 中的约束
  • 在执行计划中引用 ADR
  • 确保遵循架构决策
第 4 步:在 plans/ 中更新进度
  • 在 plans/ 中创建或更新执行计划文件
  • 记录进度、阻塞事项和决策
  • 在计划文件中链接相关 ADR

评论

支持 Markdown