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/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我正在设计一个客服对话智能体，需要处理多轮对话和外部API调用，应该选择哪种架构模式？’ 它会引导你分析任务特性，建议采用Orchestrator-Workers模式，并提醒你注意对话状态管理和错误处理。或者，
对AI说：‘帮我评审一下这个SKILL.md草案，看看是否符合规范。’ 它会对照指南中的检查清单，指出文档在输入输出描述、错误示例和隐私声明方面的缺失。
介绍
本指南旨在解决开发者在设计AI技能时面临的架构选择困难、模式混乱、文档不规范等核心问题。它通过系统化的方法论，帮助开发者在项目初期就做出清晰的技术决策。
指南提供了从宏观架构（如Workflow与Agent的选择）到具体实现模式（如提示词链、路由、并行化等）的完整设计路径。它包含详细的质量检查清单，确保技能在开发、文档和治理层面都符合高标准。
它非常适合正在构建复杂AI应用的智能体开发、全栈开发和后端开发工程师，尤其是那些需要确保技能可维护性、可扩展性和符合团队规范的项目。对于希望提升技能设计系统性的产品经理和项目经理也很有参考价值。
使用建议是，在项目启动阶段或重构现有技能时，参照本指南的决策树和模式库进行设计评审。注意事项是，它提供的是设计原则和模式，而非可直接运行的代码库，需要开发者结合具体技术栈进行实现。
核心特点
与零散的技巧分享不同，它提供了一套从架构决策到代码实现的完整、系统化的设计框架，并附带了结合治理要求（如安全性、合规性）的质量检查清单，确保技能从设计之初就具备生产级质量。
注意事项
不适合寻求即插即用代码片段或快速原型工具的开发者，它更侧重于设计方法论和架构指导。
常见问题
如何决定使用Workflow还是Agent架构？
指南提供了决策树，根据任务确定性、是否需要自主决策、交互复杂度等因素帮助你选择。
SKILL.md文件应该包含哪些内容？
指南提供了标准模板，包括技能描述、输入输出、使用示例、依赖项、配置项和治理检查项等。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/skill-design-guide-x/raw/index.md 读取 Skill Design Guide 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/skill-design-guide-x/raw/index.md（查看排版版本）