用途
prompt-optimization 技能用于将任意请求转换为面向 Claude 4.x 的、可直接投产的优化提示词，重点解决两类问题：一是把含糊、结构松散的请求变得清晰可执行；二是通过调查优先协议与防幻觉护栏，降低模型编造事实的风险，提高首次回答的准确率。
主要能力
该技能围绕六项核心策略展开：
- 情境与动机说明：不只写“做什么”，还解释“为什么”。例如与其写“不要用省略号”，更有效的写法是“回答会被文本转语音朗读，TTS 无法读出省略号，因此不要使用省略号”。
- 调查优先：在给出答案前必须先调查。文档给出的示例是用户要求“修复这个 bug”时，不要立刻给修复建议，而应先查看代码结构、定位错误位置、追踪执行路径、检查日志、形成基于证据的假设，然后才提出解决方案。
- 多示例：提供覆盖不同场景的 2—3 个示例，包括典型情况（约 80% 场景）、边界情况（不常见但有效）和错误情况（不应怎么做）。
- 明确的输出格式：精确规定输出应是什么样子，例如结构为“摘要（2—3 句）→ 关键发现（要点列表）→ 建议（编号）→ 后续步骤（行动项）”，并声明不要包含观点或推测。
- 扩展思考：对复杂任务启用逐步推理，拆解为“要实现什么、已有哪些信息、需要哪些步骤、哪里可能出错、如何验证”。
- 防幻觉护栏：规则包括不编造事实或统计数据、有来源时始终引用、不确定时使用“我不知道”、回答前先调查、对照上下文核实；当信息不在上下文中时，说明已知内容、解释缺失什么、建议如何找到，而不是猜测。
使用方式
该技能提供了一套可直接套用的优化提示词模板，结构包括：role（具体专家角色与领域知识）、context（任务为何重要及背景）、investigation（回答前要检查什么：需收集的信息、要查阅的资源、要澄清的问题）、thinking（逐步方法：分析请求、识别需求、考虑边界情况、规划回答、验证假设）、execution（执行任务的步骤、工具/方法、质量检查）、output_format（精确的输出格式）、anti_hallucination（绝不推测，不确定时明确说明）、examples（典型、边界、错误三类示例）。
触发时机包括：用户要求改进或优化提示词；提示词中出现“optimize”“improve my prompt”“make this better”等表述；模糊请求需要澄清与结构化；现有提示词存在幻觉问题；用户提到“investigation first”“anti-hallucination”“production-ready”。
快速上手示例：用户输入“optimize: [粘贴提示词]”，技能会分析结构、应用 Claude 4.x 模式，返回生产版本；用户输入“fix hallucinations in: [prompt]”，技能会加入调查协议、插入验证检查点、移除引发推测的触发词。
针对 Claude 4.x 特性，文档还给出若干模式：扩展思考用于多步分析、复杂问题求解与长周期规划；并行工具调用用于相互独立的操作同时执行；长周期任务通过创建 progress.txt 记录已完成子任务、阻碍项，并在恢复时读取进度、验证上一状态、继续下一任务；MCP 集成包括发现（检查 MCP 资源、识别相关工具、加载上下文提示）与执行（搜索 MCP 资源、用 MCP 工具获取实时数据、应用 MCP 格式化提示、组合回答），并给出“Q4 销售报告里有什么”这一示例链路。
此外还包含高级模式：自我验证（生成后对照需求、检查幻觉、核实事实、确认格式、测试边界情况，发现问题先修订再交付）、渐进式细化（从基础版开始，用样本测试，找出失败点，添加护栏，重新测试，记录，按表现迭代）、上下文管理（核心指令放最前，细节按需展开，用引用代替内联，示例放最后；超过 2000 词时拆分为 skill 加 references/ 目录，或使用 MCP 获取外部资源）。
优化完成后的交付物模板包含：优化后的完整提示词（XML 格式），以及优化总结（已做的更改、预期改进、测试清单：典型情况、边界情况、错误/无效输入、含糊请求、信息缺失）。
适用场景
适合需要把模糊需求转为结构化提示词的场景、需要修复已有提示词幻觉问题的场景、需要为复杂任务（如 bug 修复、数据分析、网站构建等）设计调查优先工作流的场景，以及希望复用统一提示词模板与质量指标的团队。
限制
文档仅给出质量指标的目标值（幻觉率低于 5%、首次回答成功率高于 90%、所需迭代 1—2 次、清晰度评分高），但未提供实测数据或达成这些指标的验证结果。文档中引用的具体示例文件（website-build-example.md、bug-fix-example.md、data-analysis-example.md）仅指明参考位置，未提供其内容。关于收费、价格、平台支持范围等信息暂未提供。版本信息为 1.0.0，目标优化对象为 Claude 4.x。