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-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我正在设计一个客服工单自动分类和路由的AI技能，应该选择哪种架构模式？’ 它会引导你分析任务特性，判断是适合使用确定性的工作流（Workflow）还是需要自主决策的智能体（Agent），并推荐Prompt Chaining或Routing等具体模式。接着，你可以要求它：‘根据评估器-优化器模式，帮我规划这个技能的质量检查点。’ 它会生成一份涵盖准确性、响应时间、隐私保护等维度的检查清单。
介绍
本指南旨在解决开发者在设计和构建AI技能时，面临架构选择困难、模式应用不当、文档不规范以及质量把控不严等核心问题。它提供了一套系统化的方法论，帮助开发者从零开始规划并实现高质量的AI技能。
通过提供Workflow与Agent的决策框架，以及Prompt Chaining、Routing、Parallelization等具体架构模式，本指南将复杂的AI技能设计过程结构化。开发者可以参照其中的步骤和示例，选择适合的模式来组织智能体或工作流，并利用附带的检查清单来确保技能的质量与合规性。
本指南非常适合正在或计划开发AI技能的前后端工程师、智能体开发者、项目经理以及任何希望系统化提升AI应用设计能力的技术人员。无论是构建简单的自动化脚本还是复杂的多智能体系统，都能从中找到对应的设计思路和避坑指南。
使用前建议先通读核心架构模式部分，明确自己的技能类型。在设计过程中，应反复对照质量检查清单，尤其是在涉及用户隐私、内容合规等治理要求时。注意，本指南提供的是设计原则和模式，而非可直接运行的代码库，需要开发者结合具体技术栈实现。
核心特点
与零散的技巧分享不同，它系统整合了Anthropic、OpenAI和LangChain等主流框架的设计原则，提供了一套从架构决策到质量审计的完整、可操作的设计流程。其核心在于提供了一个治理感知的质量检查清单，帮助开发者在设计阶段就规避常见的合规与架构风险。
注意事项
本指南主要提供设计方法论和模式，不包含可直接部署的代码或运行时环境，不适合需要开箱即用解决方案的场景。
常见问题
如何决定使用Workflow还是Agent架构？
指南中提供了决策框架，主要根据任务的确定性、是否需要自主决策和工具使用来判断：确定性任务用Workflow，复杂开放任务用Agent。
SKILL.md文件应该包含哪些内容？
指南提供了标准模板，包括清晰的描述、输入输出示例、使用场景、依赖项以及合规性声明，确保技能的可维护性和可复用性。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/skill-design-guide-x-2/raw/index.md 读取 Skill Design Guide 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/skill-design-guide-x-2/raw/index.md（查看排版版本）