1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | prompt-optimizer | 合集仓库子目录名（见下方说明） |
| 所属合集仓库 | getsentry/skills（Sentry 官方 Agent Skills 公开仓库） | GitHub |
| 作者/维护者 | Sentry（getsentry 组织账号）；该技能主体由联合创始人兼 CTO David Cramer 本人提交与维护 | GitHub API |
| 来源链接 | https://github.com/getsentry/skills/tree/main/skills/prompt-optimizer | — |
| 许可证 | Apache-2.0（开源可审计） | GitHub API |
| 所属仓库整体 Stars/Forks | 885 / 45（注：该数字属整个合集，不代表本技能自身热度） | GitHub API |
| 该技能自身活跃度 | 该子目录有 4 次专门提交/PR（含 3 次由真实 Issue 驱动的文档改进），最近一次约 2026-05-04；仓库整体最近一次 push 为 2026-07-24 | GitHub Commits/PRs/Issues API |
| 最新版本 | 无显式版本号（仓库未使用 Release/Tag 机制） | GitHub Releases/Tags API |
| 安装方式 | Claude Code 插件市场两条命令，或 skills.sh 通用安装（见第 10 章） | 官方 README |
2. 功能介绍与亮点
prompt-optimizer 是一套“契约先行、评测驱动”的提示词优化工作流：面对新建或已有的 agent 系统提示词、开发者提示词、可复用提示模板，它要求先把目标模型、提示词所在层（system/developer/user/工具描述/示例）、目标与非目标、成功标准和硬约束等“契约”记录清楚，再决定是否需要先补一套小型评测样例，之后按分层原则重塑提示词结构，最后用“基线打分 → 按根因聚类失败 → 生成 2–4 个候选方案 → 对照评测 → 保留优胜者”的迭代循环收敛。
核心亮点：① 明确区分“新建提示词”“优化已有提示词”“跨模型家族移植”（OpenAI / Claude / Gemini）三类任务，并各自给出针对性参考文档；② SOURCES.md 逐条记录每一段方法论的来源与可信等级，SPEC.md 单列意图、适用范围、不适用范围与运行契约，工程严谨度在同类提示词技能中少见；③ 明列“失败模式”清单（如编辑前未定义评测目标、把持久策略塞进用户负载、用角色设定替代行为规则等），帮助使用者规避常见提示词工程误区；④ 全程只输出结构化文本，不涉及任何代码执行或外部调用。
3. 适用场景
所属分类：元技能与 Agent 增强
面向需要为编码 agent、产品 agent 或评测工具维护和迭代提示词的工程师：包括要把某个系统提示词从“能跑”打磨到“可靠”的团队、需要把提示词从一个模型家族移植到另一个（如从 GPT 迁移到 Claude 或 Gemini）而不想推倒重写的开发者，以及正在为提示词搭建小型评测集、需要按根因聚类失败案例再逐轮改进的场景。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方 README 给出明确安装命令（claude plugin marketplace add getsentry/skills + claude plugin install sentry-skills@sentry-skills） |
| Codex | 未验证 | 仓库同时支持 skills.sh 通用生态（npx skills add getsentry/skills），官方文档点名兼容 Claude Code、Cursor、Cline、GitHub Copilot「及其他兼容 Agent」，但未逐一列出 Codex |
| OpenClaw | 未验证 | 公开材料未点名，未见相关说明 |
| Hermes Agent | 未验证 | 公开材料未点名，未见相关说明 |
补充：技能本身遵循开放的 Agent Skills 规范（SKILL.md + 纯文本正文），子目录自包含、不依赖仓库其他部分，理论上可手动复制到任何支持该规范的 agent 技能目录，但以上未点名的三个生态均缺乏官方材料直接证实。
5. 推荐理由
Sentry 官方出品、由公司联合创始人兼 CTO 本人主理并持续迭代，把提示词优化从“凭手感反复调”变成“契约捕获 + 评测回归”的工程化流程，且专门覆盖跨模型家族移植这一容易被忽视的场景。相比同类“从零生成一份提示词”或“套用预设框架打分”的技能，它更贴近团队维护一份长期在用、需要对着真实失败案例持续迭代的生产级提示词的真实工作方式。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 官方仓库整体星数不计入该子技能个体热度；但该子技能自身有 4 次专门提交/PR、其中 3 次由真实 Issue（#120/#121/#122）驱动改进，且由公司联合创始人兼 CTO 本人亲自维护，工程投入的真实性与持续性明显强于同仓库内仅有初始提交的子技能 |
| 可用性 | 9 | 无需任何环境配置或 API Key，纯文本复制即用；SKILL.md + SPEC.md + SOURCES.md + 4 份 reference 文档结构完整；最近一次专门维护约 2.5 个月前，仓库整体 1 天前仍有提交，非弃置项目 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合 | 8.7 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 无——已逐字抓取 SKILL.md 全文及 4 份 reference 文档，全篇为纯文本方法论指导，不含任何 shell 命令、工具调用或脚本 |
| ② 运行时联网外发 | 无——技能不发起任何网络请求，纯本地文本生成与建议 |
| ③ API Key/凭据要求 | 不需要 |
| ④ 可疑指令排查 | 未发现——已核对全部正文与参考文件，无 prompt injection 或隐藏指令迹象 |
| ⑤ 作者/组织信誉 | Sentry 官方仓库，Apache-2.0 开源可审计；技能主体由联合创始人兼 CTO David Cramer 本人具名提交维护，无刷星或自我营销措辞 |
| ⑥ License | Apache-2.0，明确 |
| ⑦ 最近维护 | 该子目录约 2.5 个月前有专门改动，仓库整体 1 天前仍在维护 |
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本 skill 的差异 |
|---|---|---|
| prompt-master（nidhinjs，10,539★） | 输入自然语言需求，自动生成给 30 余种终端 AI 工具（Claude、GPT、Midjourney 等）使用的最终提示词 | 定位是“从零生成一次性提示词”；prompt-optimizer 定位是“对已有提示词做契约捕获 + 评测驱动的多轮迭代”，且专设跨模型家族移植的分步指引，两者触发场景不同 |
| prompt-architect（ckelsoe，254★） | 用 31 种命名提示框架（CO-STAR、RISEN、Tree of Thought 等）给提示词打分并改写，提供改写前后量化对比 | 依赖预设框架目录做匹配式改写；prompt-optimizer 不套用框架清单，而是走“契约捕获 → 失败聚类 → 多候选对比 → 评测收敛”的工程化闭环，更贴近团队维护生产提示词的真实流程 |
| promptfoo-evals（promptfoo/OpenAI，23,388★） | 为 LLM 应用生成完整的 promptfooconfig.yaml 评测套件与断言，产出可独立运行的测试配置 |
是独立的评测工具链产出物；prompt-optimizer 的评测环节只是优化流程内部用于比较候选提示词表现的中间步骤，不产出独立评测配置文件，二者可配合使用而非互相替代 |
8. 用户评价
该技能目前在第三方平台（Reddit、Hacker News）尚无具名用户评价；与之相关的公开讨论集中在 GitHub 仓库自身的 Pull Request 与 Issue 中，参与者均为 Sentry 内部工程团队成员，尚无外部独立用户的具名试用反馈。
9. 其他补充
仓库整体自述为“面向 Sentry 员工”的内部工具集，其中部分子技能（如博客写作指南、Sentry 专属 API 文档技能）确实与 Sentry 内部流程强绑定；但 prompt-optimizer 经内容核实不含任何 Sentry 专属耦合——SKILL.md、SPEC.md 与全部 4 份 reference 文档均为通用提示词工程方法论，不依赖 Sentry 内部系统或数据，可直接用于任意项目。
10. 安装使用方式
方式一：Claude Code 插件市场（官方推荐）
claude plugin marketplace add getsentry/skills
claude plugin install sentry-skills@sentry-skills安装后重启 Claude Code，技能会在相关任务中自动激活。更新方式：
claude plugin marketplace update
claude plugin update sentry-skills@sentry-skills方式二：skills.sh 通用生态（官方文档点名兼容 Claude Code、Cursor、Cline、GitHub Copilot 等）
npx skills add getsentry/skills方式三：手动复制单个技能目录
git clone https://github.com/getsentry/skills.git
cp -r skills/skills/prompt-optimizer ~/.claude/skills/prompt-optimizer该子目录自包含 SKILL.md、SPEC.md、SOURCES.md 与 references/，不依赖仓库其他部分，适合只想用这一项技能、不想连带装入整个 Sentry 技能合集的用户。
注意事项：方式一与方式二安装的是整个 sentry-skills 插件包（含仓库内全部子技能），非单独安装 prompt-optimizer；如需避免其他子技能一并激活，建议采用方式三。
11. 注意事项
- 仓库未设置正式版本号 Release/Tag，更新历史需通过 commit 记录追溯。
- 跨 Agent 兼容性中 Codex、OpenClaw、Hermes Agent 三项均未获得官方材料证实，如需在这些环境使用请自行验证；技能本身是通用 SKILL.md 格式文本，理论上可手动适配。
- 该技能只产出结构化的提示词优化建议与候选方案，不代替用户执行评测或部署，最终效果仍需用户自行在目标模型上验证。
- 所属仓库整体自述面向 Sentry 内部员工，部分姊妹子技能与 Sentry 内部流程强绑定，但本技能内容通用、不受此影响。