PM技能：代理更新工作流程Skill mpm-agent-update-workflow

PM Skill: 代理更新工作流程

触发模式

• “update agent”、“fix agent”、“improve agent”、“modify agent”
• “change {agent-name} agent”、“edit agent instructions”
• 任何修改代理行为的请求

基本规则：官方与自定义代理

官方 MPM 代理（切勿编辑已部署的副本）

来源: ~/.claude-mpm/cache/agents/ (来自 bobmatnyc/claude-mpm-agents 仓库) 部署位置: .claude/agents/ - 官方代理为只读

检测: 检查代理是否存在于 ~/.claude-mpm/cache/agents/

• 如果是 → 官方代理 → 遵循官方代理工作流程
• 如果不是 → 自定义代理 → 可以直接编辑 .claude/agents/

自定义/本地化代理

• 为项目专门创建
• 可以直接编辑 .claude/agents/
• 不属于官方 MPM 代理集

官方代理更新工作流程

步骤 1: 识别代理来源

ls ~/.claude-mpm/cache/agents/  # 查找源文件

步骤 2: 更新源文件

编辑代理源文件 ~/.claude-mpm/cache/agents/{agent-name}.md （或基于代理结构的适当路径）

步骤 3: 重建和重新部署

使用 MPM 部署工具：

# 重新部署特定代理
mpm agents deploy {agent-name}

# 或重新部署所有代理
mpm agents deploy --all

步骤 4: 验证（仅限 claude-mpm 项目）

在 claude-mpm 项目本身中工作时：

# 对已部署的代理指令运行 deepeval
deepeval test --agent {agent-name}

断路器

阻止 直接尝试编辑 .claude/agents/{official-agent}.md：

• 部署位置中的官方代理是构建输出
• 必须更新源 → 重建 → 重新部署
• 违规 = 架构破坏

示例

❌ 错误（编辑已部署的官方代理）

Edit: .claude/agents/web-qa.md  # 违规 - 这是构建输出

✅ 正确（更新源并重新部署）

1. Edit: ~/.claude-mpm/cache/agents/web-qa.md  # 更新源
2. Run: mpm agents deploy web-qa                # 重建/重新部署
3. Validate: deepeval test --agent web-qa       # （在 claude-mpm 项目中）

✅ 正确（自定义代理 - 可以直接编辑）

Edit: .claude/agents/my-custom-agent.md  # 正确 - 不是官方代理