关于 goap-agent
goap-agent 是面向 Claude 的规划技能,通过目标分解、执行策略和专用 Agent 协调来组织复杂的多步工作,并提供质量检查与架构决策参考。
主要功能
- 01目标导向任务规划
- 02原子任务分解
- 03并行与顺序执行策略
- 04专用 Agent 协调
- 05质量关卡与验证
- 06结合 ADR 制定执行计划
适用场景
- 01规划包含五步以上的任务
- 02协调跨领域工作
- 03管理大型重构或架构变更
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ d-o-hub/ rust-self-learning-memory --skill goap-agent安装后在 Claude Code 中输入/goap-agent确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents.mdexamples.mdexecution-strategies.mdmethodology.mdpatterns.mdskills.md详细介绍
GOAP Agent 技能
面向复杂多步骤任务的目标导向行动规划,具备智能规划与多 Agent 协调能力。
快速参考
- 方法论 - GOAP 核心规划周期与阶段
- 执行策略 - 并行、顺序、群体、混合模式
- 技能参考 - 按类别列出的可用技能
- Agent 参考 - 可用任务 Agent 及其能力
- 模式 - 常见 GOAP 执行模式
- 示例 - 完整的 GOAP 工作流示例
- ADR-022 - 架构决策记录
适用场景
- 复杂的多步骤任务(5 个以上不同步骤)
- 跨领域问题(存储、API、测试、文档)
- 需要并行或顺序执行的任务
- 需要质量验证检查点的关键工作
- 大型重构或架构变更
重要:技能与任务 Agent 的区别
技能(通过 Skill 工具):直接指导 Claude 的指令集
Agent(通过 Task 工具):执行任务的自主子流程
示例:
- 错误:
Task(subagent_type="code-quality", ...)→ 错误! - 正确:
Skill(command="code-quality")→ 成功
完整技能列表请参阅 skills.md,Agent 能力请参阅 agents.md。
核心流程
- 分析 → 理解目标、约束和资源
- 检查 ADR:规划前阅读
plans/adr/中相关的 ADR
- 检查 ADR:规划前阅读
- 分解 → 将任务拆分为具有依赖关系的原子任务
- 任务分解:创建包含成功标准的目标层级(参见 patterns.md)
- 依赖类型:顺序(A→B)、并行(A─┐B─┐)、汇聚(A─┐B─┼─>D)
- 制定策略 → 选择执行模式
- 协调 → 分配给专门的 Agent
- 执行 → 在监控和质量关卡下运行
- 综合 → 汇总结果并验证是否成功
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