Agent 设计助手

要解决什么问题

Agent 上线后常见问题不是「能不能跑」，而是 loop 停不下来、工具一多就乱调、Subagent 把整段 coordinator 历史塞满 context，以及 access failure 被包装成空数组导致模型误判。团队里若缺少统一的架构语言，设计和 Review 往往各说各话。

本技能把 Claude Certified Architect 课程里的五个 Domain（D1 架构与编排、D2 工具与 MCP、D3 Claude Code 配置、D4 Prompt 与结构化输出、D5 Context 与可靠性）落成两类可执行工作流，而不是泛泛的「最佳实践」口号。

技能如何工作

模式一：规划 Agent 构建方案
当你描述业务需求时，技能按固定结构输出架构方案，并在每个决策上标注依据。规划阶段会强制对齐几条生产级约束，例如：用 stop_reason 控制 agentic loop（禁止靠解析自然语言判断终止）、单 Agent 工具数 ≤ 5（超出则拆多 Agent）、关键规则用 Hook 而非 Prompt、Subagent 只传最小相关 Context、以及 access failure 与 empty result 必须区分。

模式二：代码 Review
提交代码后，技能先识别涉及哪些 Domain，再按 Checklist 逐项检查并输出报告。覆盖点包括：Hub-and-Spoke 多 Agent、fork_session / --resume 用法、工具描述的输入/边界/示例/返回、错误响应里的 isError / errorCategory / isRetryable、MCP 密钥用 ${ENV_VAR}、Case Facts Block、升级触发基于客观标准而非情绪或自报置信度等。严重问题会给出 问题代码与修正示例；完整反模式可对照 references/anti-patterns.md。

各 Domain 的细则在技能内 references/d1～d5 参考文件中，规划或 Review 时会按需读取。

适用边界与注意点

• 面向 Claude / Agent 工程 语境（含 Claude Code、MCP、Skill 配置），不是通用 Web 后端或前端代码审查。
• Review 是规范对照与反模式识别，不能替代 你方业务测试、安全审计与线上监控。
• 若需求与五 Domain 无关（纯 UI、纯数据管道无 Agent 编排），规划模式产出可能偏空，需自行裁剪 Checklist。