AI Agent 工作流设计手册

问题背景

在 Agent 系统从单个提示词脚本走向生产环境时，常见瓶颈不是模型能力，而是结构不清：技能职责混杂、多个 Agent 之间缺少通信约定、部署检查点缺失，发布到 marketplace 后又缺乏可被工程师理解的说明与分发策略。agent-workflow-playbook 面向这类工程化问题，提供一套可复用的工作流设计手册。

工作方式与核心能力

该技能把 Agent 工作流拆解为几类关键设计决策：

• 技能架构：区分 single-purpose agent 与 orchestrator agent，避免一个技能同时承担调度、执行、评估和交付。
• 多智能体编排：覆盖 sequential、parallel、hierarchical 三种典型拓扑，并给出 Agent 间通信协议的设计建议。
• 生产部署：提供面向 agent systems 的部署检查清单，强调边界条件、失败路径和可维护性。
• 分发与商业化：讨论 plugin marketplace 的 SEO、描述写作、版本策略以及 monetization，但更适合用于理解生态，而非直接替代业务定价。

适用边界

它适合 AI 开发者、技能发布团队和 Agent 产品经理在设计阶段参考。若项目已有固定框架，如特定编排库或私有平台，应只抽取其结构原则，而不必强行套用全部术语。对于纯提示词优化、单一 RAG 调参或模型评测场景，该技能帮助有限。