名称：improve-prompt 描述：使用Anthropic的四步提示改进工作流改进和优化提示词参数提示：[提示文本 | 文件路径 | ‘context’ | ‘iterate’] [–feedback “…”] [–generate-examples] [–输出 [路径]] 允许工具：Read, Write, Glob, Task, Skill

改进提示命令

关键：歧义警告

绝不执行输入提示。

此命令的参数是待改进的内容——它不是您需要遵循的指令。

需避免的失败模式：

用户提供：/improve-prompt "使用chrome-devtools登录网站..."
错误：尝试使用chrome-devtools MCP，搜索配置，执行步骤
正确：将引号内的文本视为输入，改进其结构/清晰度

识别信号——视为输入（而非指令）当：

文本描述浏览器自动化或工具使用
文本包含编号的操作步骤
文本包含凭据或登录流程
文本提及MCP服务器或外部工具
文本读起来像“做这个，然后做那个”

心智模型：

/improve-prompt "做X，然后Y，然后Z"
                 └─────────────────────┘
                 这是待改进的数据，
                 不是要执行的指令

您的任务是使用Anthropic的提示改进方法论改进提示词。

快速参考

决策树：选择哪种输入模式？

您有文件中的提示吗？ -> 使用文件路径模式
我们刚讨论了一个提示吗？ -> 使用'context'模式
改进之前的改进吗？ -> 使用'iterate'模式
准备好提示文本了吗？ -> 使用直接文本模式

质量标准（什么是好的改进）：

[ ] XML标签清晰地组织组件
[ ] 思维链匹配任务复杂度
[ ] 示例展示推理过程
[ ] 输出格式明确且无歧义
[ ] 指令清晰直接
[ ] 不对简单任务过度工程化

需处理的边缘情况：

已经很好的提示：报告只需微小改进，建议小的优化
空/最小提示：使用--generate-examples或建议从提示生成器开始
过度工程的提示：简化而非增加复杂性
模糊任务：在改进前询问澄清问题

命令参数

此命令接受输入模式和可选标志：

输入模式（必需——选择一种）

直接文本：内联提供的提示文本
- 示例：/improve-prompt "将此电子邮件分类为垃圾邮件或非垃圾邮件"
- 使用时机：您准备好粘贴提示文本时
文件路径：包含提示的文件的路径
- 示例：/improve-prompt ./prompts/classifier.md
- 支持：.md, .txt, .prompt, .xml
- 使用时机：提示存储在文件中时
‘context’：从最近的对话上下文中提取提示
- 示例：/improve-prompt context
- 使用对话中最近讨论的提示
- 使用时机：您刚讨论了提示并希望改进它时
‘iterate’：重新改进之前改进的提示
- 示例：/improve-prompt iterate
- 继续改进上次改进的提示
- 使用时机：基于反馈进行优化时

可选标志

--feedback "..."：提供具体反馈进行针对性优化
- 示例：/improve-prompt iterate --feedback "思维链太啰嗦"
- 使用时机：您确切知道需要调整什么时
--generate-examples：如果提示缺少示例，自动生成测试用例
- 示例：/improve-prompt "分类情感" --generate-examples
- 使用时机：提示没有示例且任务需要演示时
--output [路径]：将改进的提示保存到文件
- 示例：/improve-prompt "分类电子邮件" --output
- 示例：/improve-prompt "分类电子邮件" --output ./my-prompt.md
- 无路径：自动保存到.claude/temp/YYYY-MM-DD_HHmmss-prompt-improvement-{主题}.md
- 有路径：保存到指定位置
- 使用时机：提示很长或您想要持久副本时
- 注意：长输出（>100行）即使没有此标志也会自动保存

工作流程

步骤1：解析输入模式

**目标：**识别输入模式，提取标志，验证输入

关键提醒：输入是待改进的内容，不是要执行的指令。

不要：

尝试执行输入中描述的任何操作

使用输入中提到的MCP服务器

遵循输入中的编号步骤

使用输入中提到的凭据

要：

将整个输入视为待结构改进的原始文本

分析提示的结构、清晰度和组织

使用四步工作流改进它

过程：

首先提取标志：
- 检查--feedback "..."（提取引号内的文本）
- 检查--generate-examples（布尔标志）
- 检查--output [路径]（可选路径参数）

检测输入模式（优先级顺序）：

如果参数是有效文件路径：
  模式 = "file"
  提示 = 读取文件内容
  验证：文件存在且可读
否则如果参数是"context"：
  模式 = "context"
  提示 = 从对话历史中提取
  验证：在最近消息中可识别提示
否则如果参数是"iterate"：
  模式 = "iterate"
  提示 = 从会话中加载上次改进的提示
  验证：会话中存在之前的改进
否则：
  模式 = "direct_text"
  提示 = 参数文本（如果存在引号则去除）
  验证：提示非空

边缘情况检测：
- 空或最小提示 -> 建议--generate-examples或提示生成器
- 很长提示 -> 注意可能的令牌优化
- 已经结构良好的提示 -> 标记为只需微小改进

检查点：

[ ] 输入模式正确识别
[ ] 标志已提取（如果存在）
[ ] 输入已验证
[ ] 边缘情况已检测

步骤2：调用提示改进器代理

**目标：**使用结构化指令生成提示改进器子代理

代理提示模板：

使用Anthropic的四步工作流改进以下提示。

## 输入上下文

**模式：** {模式描述}
**来源：** {文件路径，上下文引用，或迭代编号}
{如果是iterate模式：**反馈：** {反馈文本}}
{如果generate-examples：**生成示例：** 是（在改进前创建2-3个测试用例）}

## 原始提示

{提示文本}

## 指令：应用四步改进工作流

### 步骤1：示例识别

- 从提示中提取任何现有示例
- 注意当前示例的格式和结构
- 识别是否缺少示例
- 对于iterate模式：评估当前示例的表现

**检查点：**
- [ ] 现有示例已记录
- [ ] 示例格式已注意
- [ ] 缺少示例已识别

### 步骤2：初始草稿（XML结构）

- 将提示组件包装在XML标签中：
  - `<instructions>`用于任务定义
  - `<context>`用于背景（如果需要）
  - `<examples>`用于演示
  - `<formatting>`用于输出规范
- 在整个过程中使用一致的标签命名
- 将变量输入放在适当的标签中

**检查点：**
- [ ] 所有组件都有适当的XML标签
- [ ] 标签命名一致
- [ ] 变量部分明确标记

### 步骤3：思维链优化

- 评估任务复杂度
- 选择思维链级别：
  - 基本：简单的“逐步思考”指令
  - 引导：列出特定的推理步骤
  - 结构化：带`<thinking>`和`<answer>`标签的XML标记思考
- 添加适合复杂度的思考指令
- 指定推理和输出之间的分离

**检查点：**
- [ ] 思维链级别匹配任务复杂度
- [ ] 明确请求推理过程
- [ ] 思考与最终答案分离

### 步骤4：示例增强

- 为所有示例添加`<thinking>`部分
- 在示例中展示逐步分析
- 连接推理到最终输出
- 确保示例匹配输出格式规范

**检查点：**
- [ ] 所有示例包含推理
- [ ] 示例展示预期方法
- [ ] 格式匹配指令

## 质量标准

验证改进的提示符合这些标准：

- [ ] XML标签清晰地组织组件
- [ ] 思维链匹配任务复杂度
- [ ] 示例展示推理过程
- [ ] 输出格式明确且无歧义
- [ ] 指令清晰直接
- [ ] 不对简单任务过度工程化

## 输出格式

提供：

1. **分析**：改进了什么及原因
2. **前后对比**：显示结构、示例、思维链级别的表格
3. **改进的提示**：完整的提示，可直接使用
4. **权衡说明**：任何延迟/成本影响
5. **后续步骤**：测试或迭代建议

检查点：

[ ] 代理已使用Task工具生成
[ ] 子代理类型：“general-purpose”
[ ] 描述：“使用四步工作流改进提示”
[ ] 提示包含所有必需部分

步骤3：展示结果

**目标：**格式化代理输出以清晰呈现给用户

输出模板：

## 提示改进完成

### 输入模式
{使用的模式} {如果是文件：显示路径} {如果是iterate：显示迭代编号}

### 摘要
{1-2句改进描述}

### 前后对比

| 方面 | 之前 | 之后 |
| --- | --- | --- |
| 结构 | {之前} | {之后} |
| 示例 | {计数} | {计数} |
| 思维链级别 | {无/基本/引导/结构化} | {级别} |
| 格式规范 | {隐式/显式} | {带标签的显式} |

### 改进的提示

**重要：以下包含完整的改进提示——绝不总结或截断。**

```{语言}
{完整的改进提示——每行、每节、每个示例}
```

{如果文件已保存（--output或自动保存）：}
📁 **保存到：** `{输出路径}` {如果自动保存：“（由于长度自动保存）”}

### 权衡

{任何延迟/成本影响，或“此改进无显著权衡”}

### 推荐

**推荐：**

1. **测试**：尝试使用样本输入测试改进的提示
2. **迭代**：使用`/improve-prompt iterate --feedback "..."`进行优化
3. **保存**：将改进的提示复制到您的项目

**可选：**

- 比较原始和改进提示的输出
- 用真实用例运行A/B测试
- 与团队分享以获取反馈

检查点：

[ ] 接收到代理输出
[ ] 结果已格式化以清晰呈现
[ ] 包含前后对比
[ ] 提供了完整的改进提示
[ ] 权衡已说明
[ ] 后续步骤已建议

步骤3.5：保存到文件（自动检测或–output标志）

**目标：**当需要时将改进的提示保存到文件

过程：

确定是否需要文件输出：

如果存在`--output`标志：
  保存文件 = 真
  输出路径 = 提供的路径或自动生成
否则如果improved_prompt.lines > 100：
  保存文件 = 真
  输出路径 = 自动生成
  自动保存 = 真  # 注意：这是自动的
否则：
  保存文件 = 假

如果保存，确定输出路径：
- 如果提供了--output <路径>：使用该路径
- 否则：生成.claude/temp/YYYY-MM-DD_HHmmss-prompt-improvement-{主题}.md
- 主题源自提示内容（例如，“email-classifier”、“course-scraping”）

写入markdown文件包含：

# 改进的提示：{主题}

**生成时间：** {UTC时间戳}
**输入模式：** {模式}
**原始提示：** {前200字符...}

## 前后对比

方面	之前	之后
…	…	…

改进的提示

{完整的改进提示——绝不截断}

权衡

{权衡说明}

后续步骤

{推荐}

由/improve-prompt命令生成


4. **报告文件位置：**
- 始终显示：`📁 **保存到：** {输出路径}`
- 如果自动保存：添加说明“（由于长度自动保存）”

**检查点：**

- [ ] 输出决策已做（自动检测或明确标志）
- [ ] 输出路径已确定（如果保存）
- [ ] 文件已使用Write工具成功写入
- [ ] 路径已报告给用户

---

### 步骤4：跟踪迭代

**目标：**为后续优化启用iterate模式

**过程：**

1. **存储在会话上下文中：**
- 保存改进的提示文本
- 保存迭代计数（1, 2, 3, ...）
- 保存任何应用的反馈

2. **启用iterate模式：**
- 用户可以运行`/improve-prompt iterate`
- 用户可以添加`--feedback "..."`进行针对性更改

3. **会话状态跟踪：**
- 原始提示（迭代0）
- 改进的提示（迭代1）
- 优化的提示（迭代2+）

**检查点：**

- [ ] 改进的提示已存储以备迭代
- [ ] 迭代计数已跟踪
- [ ] iterate模式已启用

---

## 验证协议（在报告完成前）

### 关键：在报告完成前验证所有步骤

在说“完成”前，检查：

- [ ] **步骤1**：输入已解析和验证
- [ ] **步骤2**：代理已生成，包含完整指令
- [ ] **步骤2.5**：代理成功完成（接收到Task工具输出）
- [ ] **步骤3**：结果已格式化和呈现
- [ ] **步骤4**：会话状态已更新以备迭代
- [ ] **质量**：改进的提示符合质量标准
- [ ] **边缘情况**：任何特殊情况已适当处理

**如果任何复选框未勾选，在报告完成前完成该步骤。**

---

## 示例用法

### 示例1：直接文本输入

````text
用户：/improve-prompt "用3句话总结这篇文章"

Claude：[调用提示改进器代理]

## 提示改进完成

### 输入模式
直接文本输入

### 摘要
添加了XML结构、明确约束、用于总结构建的思维链，以及带推理的示例。

### 前后对比

| 方面 | 之前 | 之后 |
| --- | --- | --- |
| 结构 | 单句 | XML标记组件 |
| 示例 | 0 | 1 |
| 思维链级别 | 无 | 引导（识别关键点） |
| 格式规范 | 隐式 | 带`<summary>`标签的显式 |

### 改进的提示

```xml
<instructions>
您是一个专业的总结者。创建一个简洁的3句话总结。

要求：
- 恰好3句话（不多不少）
- 捕捉主要观点、关键证据和结论
- 使用清晰直接的语言
</instructions>

<article>
{{文章}}
</article>

<formatting>
首先在<thinking>标签中识别关键点：
- 主要主张或论文
- 支持证据
- 关键结论

然后在<summary>标签中提供恰好3句话。
</formatting>

<examples>
<example>
 <input>
   [关于气候变化影响的文章]
 </input>
 <thinking>
   主要主张：气温上升影响生态系统
   支持证据：极地冰融化、物种迁移
   结论：需要紧急行动
 </thinking>
 <summary>
   全球气温以前所未有的速度上升，导致极地冰融化和物种向更冷地区迁移。科学家已在全球多个生态系统中记录这些变化。需要立即行动以减轻进一步的环境损害。
 </summary>
</example>
</examples>
```

### 权衡分析

结构化思考可能增加10-20%延迟，但显著提高总结质量。

### 迭代建议

使用`/improve-prompt iterate --feedback "..."`进一步优化。

示例2：文件输入

用户：/improve-prompt ./prompts/email-classifier.md

Claude：正在从文件读取提示：./prompts/email-classifier.md

[调用提示改进器代理]

## 提示改进完成

### 输入模式
文件：./prompts/email-classifier.md

### 摘要
用XML标签重构，添加了分类推理的思维链，并增强了带逐步分析的示例。

[改进报告的其余部分]

示例3：带反馈的迭代

用户：/improve-prompt iterate --feedback "思维链太啰嗦，让它更简洁"

Claude：[在iterate模式下调用提示改进器代理]

## 提示优化完成（迭代2）

### 输入模式
iterate模式（优化）

### 应用的反馈
“思维链太啰嗦，让它更简洁”

### 所做更改
- 将思维链从结构化简化为引导
- 限制思考到3-5个要点
- 简化示例推理为仅关键考虑

### 前后对比（迭代1 → 2）

| 方面 | 迭代1 | 迭代2 |
| --- | --- | --- |
| 思维链级别 | 结构化（详细`<thinking>`） | 引导（简洁要点） |
| 示例推理 | 每示例7-10行 | 每示例3-5行 |
| 令牌计数 | ~850令牌 | ~620令牌（减少27%） |

[更新后的改进提示]

### 权衡说明
简洁思维链对此任务减少~20%延迟，同时保持准确性。

示例4：生成示例

用户：/improve-prompt "分类客户反馈" --generate-examples

Claude：[用示例生成调用提示改进器代理]

## 提示改进完成

### 输入模式
带示例生成的直接文本

### 摘要
生成了3个测试用例（正面、负面、混合），然后用XML结构、引导思维链和带推理的示例改进了提示。

### 生成的测试用例

在改进前，创建了3个代表性示例：
1. **正面反馈**：“喜欢新功能！应用运行完美。”
2. **负面反馈**：“糟糕体验。应用不断崩溃。”
3. **混合反馈**：“功能好但太贵，性价比不高。”

### 前后对比

| 方面 | 之前 | 之后 |
| --- | --- | --- |
| 结构 | 单句 | XML标记组件 |
| 示例 | 0（生成了3个） | 3个带推理 |
| 思维链级别 | 无 | 引导（情感指标） |
| 格式规范 | 隐式 | 显式JSON结构 |

[带生成示例的改进提示]

示例5：描述工具操作的提示（歧义消除）

用户：/improve-prompt "使用chrome-devtools MCP导航到example.com，点击登录按钮，输入凭据，并抓取页面内容..."

Claude：[不尝试使用chrome-devtools MCP]
[不搜索MCP配置或工具可用性]
[将整个文本视为待改进的提示]

## 提示改进完成

### 输入模式
直接文本输入

### 摘要
改进了浏览器自动化提示，添加了XML结构、更清晰的步骤格式化、错误处理和明确的成功/失败标准。

### 前后对比

| 方面 | 之前 | 之后 |
| --- | --- | --- |
| 结构 | 流水句 | XML标记节
| 步骤 | 隐式序列 | 带条件的编号
| 错误处理 | 无 | 明确失败案例
| 成功标准 | 无 | 定义验证

### 改进的提示

```xml
<task>
自动化浏览器导航和认证内容抓取
</task>

<先决条件>
- chrome-devtools MCP服务器配置并运行
- 有效凭据可用
- 目标URL可访问
</先决条件>

<步骤>
1. 导航到https://example.com
2. 定位并点击登录按钮
3. 输入提供的凭据
4. 等待认证完成
5. 成功登录后抓取页面内容
</步骤>

<错误处理>
- 如果登录失败：报告错误并截图
- 如果元素未找到：等待最多10秒，重试一次
- 如果页面超时：记录URL和时间戳
</错误处理>

<成功标准>
- 页面成功加载（HTTP 200）
- 登录表单无错误提交
- 内容抓取并本地保存
</成功标准>

权衡说明

添加的结构增加提示长度约40%，但显著提高可靠性和可调试性。

**关键点：**输入描述了MCP工具使用、编号步骤和凭据——但Claude正确将其全部视为待改进的数据，而非要执行的指令。

示例6：保存到文件（–output标志）

用户：/improve-prompt "按紧急程度分类客户支持票据并路由到相应团队" --output

Claude：[调用提示改进器代理]
[改进的提示120+行带示例]
[自动确定需要文件输出]
[写入.claude/temp/2025-12-03_143022-prompt-improvement-ticket-classifier.md]

## 提示改进完成

### 输入模式
直接文本输入

### 摘要
改进了支持票据分类器，添加了XML结构、3个紧急级别带示例、路由逻辑和结构化输出格式。

### 前后对比

| 方面 | 之前 | 之后 |
| --- | --- | --- |
| 结构 | 单句 | XML标记节
| 示例 | 0 | 6（每紧急级别2个）
| 思维链级别 | 无 | 引导（紧急指标）
| 路由 | 隐式 | 明确团队映射

### 改进的提示

[此处显示完整的改进提示——所有120+行]

📁 **保存到：** `.claude/temp/2025-12-03_143022-prompt-improvement-ticket-classifier.md`

### 权衡
结构化格式增加约50%令牌，但显著提高路由准确性。

示例7：长输出的自动保存（无标志）

用户：/improve-prompt "构建一个全面的代码审查提示，包含安全性、性能和可维护性检查..."

Claude：[调用提示改进器代理]
[改进的提示150+行——超过100行阈值]
[无需明确--output标志自动保存]

## 提示改进完成

### 输入模式
直接文本输入

### 摘要
改进了代码审查提示，添加了多类别分析、严重性级别和结构化反馈格式。

[控制台显示带关键节的摘要...]

📁 **保存到：** `.claude/temp/2025-12-03_150530-prompt-improvement-code-reviewer.md` （由于长度自动保存）

查看保存文件中的完整改进提示。

错误处理

文件未找到

错误：在路径处找不到文件：{路径}

请检查：
- 文件路径正确
- 文件存在且可读
- 如果相对路径失败，使用绝对路径

建议：使用`/improve-prompt "您的提示文本"`直接提供。

无上下文可用

错误：无法在最近对话中识别提示。

'context'模式要求最近讨论过提示。

请要么：
- 直接提供提示文本：`/improve-prompt "您的提示"`
- 提供文件路径：`/improve-prompt ./path/to/prompt.md`
- 确保最近在此对话中讨论过提示

无先前改进

错误：未找到先前的提示改进以迭代。

'iterate'模式要求此会话中有先前的改进。

请先使用这些模式之一：
- `/improve-prompt "您的提示文本"`
- `/improve-prompt ./path/to/prompt.md`
- `/improve-prompt context`

然后您可以使用`/improve-prompt iterate`进行优化。

空或最小提示

警告：提供的提示非常最小（“{提示文本}”）。

推荐：
1. 使用`--generate-examples`首先生成测试用例
2. 在改进前澄清任务定义
3. 考虑使用提示生成器工具进行初始草稿

您想：
- 添加`--generate-examples`标志并继续？
- 提供更多关于任务的上下文？
- 取消并修订提示？

注释

子代理处理改进——此命令是协调器
提示改进技能由子代理自动加载
通过技能链中的docs-management访问官方文档
iterate模式保留跨多次优化传递的上下文
报告权衡帮助用户做出知情决策
质量标准强制执行Anthropic方法论的最佳实践
明确处理边缘情况以避免不良结果
验证协议防止不完整执行（防止上下文崩溃）

名称：improve-prompt 描述：使用Anthropic的四步提示改进工作流改进和优化提示词 参数提示：[提示文本 | 文件路径 | ‘context’ | ‘iterate’] [–feedback “…”] [–generate-examples] [–输出 [路径]] 允许工具：Read, Write, Glob, Task, Skill

改进提示命令

关键：歧义警告

快速参考

命令参数

输入模式（必需——选择一种）

可选标志

工作流程

步骤1：解析输入模式

步骤2：调用提示改进器代理

步骤3：展示结果

步骤3.5：保存到文件（自动检测或–output标志）

改进的提示

权衡

后续步骤

示例2：文件输入

示例3：带反馈的迭代

示例4：生成示例

示例5：描述工具操作的提示（歧义消除）

权衡说明

示例6：保存到文件（–output标志）

示例7：长输出的自动保存（无标志）

错误处理

文件未找到

无上下文可用

无先前改进

空或最小提示

注释

名称：improve-prompt 描述：使用Anthropic的四步提示改进工作流改进和优化提示词参数提示：[提示文本 | 文件路径 | ‘context’ | ‘iterate’] [–feedback “…”] [–generate-examples] [–输出 [路径]] 允许工具：Read, Write, Glob, Task, Skill