expert-instruction

专家级指令设计

概述

专家级指令设计专注于编写系统提示词，以定义 AI Agent 的行为、能力边界，以及其在不同交互中的响应方式。与通用提示词工程（优化单个查询）不同，这项技能涵盖塑造 Agent 身份、能力和约束的持久行为层。

**适用场景：**为 AI 产品编写系统提示词、为面向客户的工具定义 Agent 角色、指定行为护栏、编写工具使用指南，或设计多步骤 Agent 工作流。

**不适用场景：**优化一次性提示词（使用 prompt 技能）、微调或训练时配置、基础设施层面的安全措施（使用模型提供商的安全功能），或不涉及大模型 Agent 行为的任务。

快速参考

模式	用途	要点
身份模块	定义 Agent 的身份	角色、专业知识、沟通风格
能力声明	说明 Agent 能做什么	明确的工具列表、领域边界
约束规范	定义行为边界	硬性限制、软性偏好、升级规则
输出格式规则	确保响应结构一致	模板、渐进式披露、长度限制
工具使用说明	指导何时以及如何使用工具	选择标准、错误处理、调用顺序
多轮交互行为	处理对话连续性	上下文跟踪、话题切换、记忆
护栏	防止有害或超出范围的行为	内容边界、指令层级
升级触发条件	定义何时转交给人工处理	置信度阈值、范围边界

常见错误

错误	正确做法
系统提示词超过 4000 个 token	控制在 2000 个 token 以内，将详细内容移至参考文档
指令相互矛盾	检查冲突，并确立优先级顺序
角色描述模糊（“乐于助人”）	明确指定专业领域、响应风格、知识边界
没有升级路径	定义 Agent 何时应交由人工处理或表示“我不知道”
列出所有边缘情况	说明原则，仅针对模糊情况提供示例
混淆身份与任务指令	分开编写：先写身份模块，再写任务指令
没有指定输出格式	定义结构：标题、列表、代码块、长度
工具指令未包含错误处理	加入工具失败或返回错误时的回退行为
只测试顺利输入	测试对抗性、离题和边缘情况输入
部署时未进行版本管理	跟踪系统提示词版本、记录变更并启用回滚

委派

• 探索提示词技巧：使用 Explore Agent 研究相关模式
• 测试系统提示词：使用 Task Agent 运行对抗性测试套件
• 代码审查：委派给 code-reviewer Agent 审查集成代码

如果有 prompt 技能，请将通用提示词工程技巧（CoT、few-shot、结构化输出）委派给它。 否则，建议使用：pnpm dlx skills add oakoss/agent-skills -s prompt -a claude-code -y

参考资料

• 系统提示词设计：结构、角色、工具和多轮对话行为
• 护栏与测试：行为边界、版本管理和生产就绪