Skill Design Guide
AI技能设计指南，提供架构模式与最佳实践
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Skill Design Guide。 它的用途是：AI技能设计指南，提供架构模式与最佳实践 完整的 Skill 内容见：https://321skill.com/skills/skill-design-guide-x-3/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我需要设计一个能自动处理客户咨询并生成工单的AI技能，帮我分析一下应该用工作流还是智能体模式，并推荐一个合适的架构模式。”，它会引导你根据任务的复杂度和自主性需求进行分析，并可能推荐“路由”或“编排器-工作者”模式来构建你的技能。
介绍
本指南旨在解决开发者在设计AI技能时面临的架构选择困难、模式混乱和质量参差不齐的问题。它通过系统化的方法论，帮助开发者从顶层设计到细节实现，构建更可靠、更易维护的AI技能。
指南提供了从宏观到微观的完整设计路径。首先，它帮助你区分“工作流”与“智能体”两种核心范式，并指导你根据具体需求做出选择。接着，深入介绍了多种经过验证的架构模式，如提示链、路由、并行化、编排器-工作者、评估器-优化器等，并附有清晰的决策树和适用场景说明。
它非常适合智能体开发者、全栈开发者和产品经理使用。无论是正在构建复杂多智能体系统的资深工程师，还是初次尝试将AI能力集成到产品中的新手，都能从中获得结构化的指导。
使用建议是，将其作为设计阶段的参考手册，而非运行时工具。建议先通读核心模式部分，再结合具体的“SKILL.md”文件撰写规范和治理质量检查清单，在开发过程中进行自查，可以有效避免常见的设计陷阱和实现错误。
核心特点
与零散的技巧分享不同，本指南提供了一套完整的、基于Anthropic、OpenAI和LangChain等主流框架设计原则的系统化方法论，并附有治理意识的质量检查清单，确保技能设计不仅高效，而且可控、可维护。
注意事项
本指南侧重于设计模式与最佳实践，不提供具体的代码实现或可运行的技能模板。
常见问题
如何选择工作流模式还是智能体模式？
指南中提供了决策树，根据任务的确定性、是否需要自主决策和外部工具使用等维度来帮助你选择。
SKILL.md文件应该包含哪些内容？
指南提供了标准模板，包括技能描述、输入输出格式、使用示例、依赖项、配置项和错误处理等关键部分。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/skill-design-guide-x-3/raw/index.md 读取 Skill Design Guide 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/skill-design-guide-x-3/raw/index.md（查看排版版本）