Sentry Skills（Sentry 工程技能包）

# Sentry Skills：安装说明

这个工具包里是 Mindket 写的安装说明，不包含技能本身、它们的脚本或两个子智能体。这些要从 Sentry 的仓库安装：https://github.com/getsentry/skills

许可证：Apache-2.0。全文见 https://github.com/getsentry/skills/blob/main/LICENSE。security-review 和 django-access-review 两个技能带有基于 OWASP Cheat Sheet Series 的参考资料（CC BY-SA 4.0），在它们的 SKILL.md 文件里注明。

Sentry Skills 由 Sentry 制作。Mindket 只是收录它，并不是 Sentry。

这些说明的来源：README（https://github.com/getsentry/skills/blob/main/README.md），https://github.com/getsentry/skills/tree/main/skills 下每个技能的 SKILL.md，AGENTS.md，以及 https://github.com/getsentry/skills/tree/main/.claude-plugin 里的插件文件。关于 Claude Code 插件的说法出自 Claude Code 自己的文档，用到的地方都注明了。所有命令都由 Mindket 照抄，一条也没有运行过。

## 它是什么

31 个技能和两个子智能体，是 Sentry 工程师配合编程智能体使用的。README 称它们为“Agent skills for Sentry employees”（给 Sentry 员工用的智能体技能）。它们遵循开放的 Agent Skills 格式。技能就是一个带 SKILL.md 指令文件的文件夹，你的请求和它对得上时，智能体就会读取它。

另一类 Sentry 帮助，README 指向了别处：要在你的项目里接入 Sentry 或排查线上问题的技能，见 https://github.com/getsentry/sentry-for-ai

## 这些技能

| 技能 | 作用（README 的原话，有删减，commit 一行取自它的 SKILL.md） |
|---|---|
| agents-md | 创建并维护简洁、有依据的 AGENTS.md 和 CLAUDE.md 文件 |
| blog-writing-guide | 为 Sentry 工程博客撰写和审阅文章 |
| brand-guidelines | 按 Sentry 品牌规范写文案 |
| browse-local-sentry | 把智能体的浏览器连到本地 Sentry 开发服务器，对真实产品做 QA 和截图 |
| claude-settings-audit | 分析一个仓库，生成推荐的 Claude Code settings.json 权限 |
| code-review | 按 Sentry 工程实践审查代码 |
| code-simplifier | 在保留全部功能的前提下，把代码简化、改得更清楚 |
| commit | 生成 Sentry 风格的约定式提交 |
| create-branch | 按 Sentry 命名规范创建 git 分支 |
| django-access-review | Django 访问控制和 IDOR 安全审查 |
| django-perf-review | Django 性能代码审查 |
| doc-coauthoring | 引导一套结构化流程，一起写文档 |
| document-api-endpoint | 用 drf-spectacular schema 为 Sentry API 端点写文档、加类型 |
| find-bugs | 在本地分支的改动里找 bug、安全漏洞和代码质量问题 |
| gh-review-requests | 取出某个团队被请求审查的开放 PR 的未读 GitHub 通知 |
| gha-security-review | 针对工作流利用漏洞的 GitHub Actions 安全审查 |
| iterate-pr | 反复处理一个 PR，直到 CI 通过、可操作的审查意见都处理完 |
| presentation-creator | 用 React、Vite 和 Recharts 做数据驱动的幻灯片，带 Sentry 品牌风格 |
| pr-link-issue | 把一个 GitHub issue 链接和它对应的 Linear 工单追加到当前 PR 的描述里 |
| pr-screenshots | 截取真实产品的界面截图，用于 PR 描述里的前后对比表 |
| pr-writer | 创建、刷新和重写拉取请求的标题和描述 |
| prompt-optimizer | 用评测、按模型家族的适配和精确的外部上下文引用来优化提示词 |
| secret-serialization | 找出通过自动生成的序列化、日志和追踪 span 泄露的密钥和令牌 |
| security-model | 定义并维护供安全审查工具使用的 SECURITY_MODEL.md 文件 |
| security-review | 针对漏洞的安全代码审查 |
| skill-scanner | 扫描智能体技能的安全问题 |
| skill-writer | 为这个仓库创建并改进智能体技能 |
| sred-project-organizer | 把一份项目清单整理成 SRED 格式，用于申报 |
| sred-work-summary | 把上一年的工作按项目归组，写成一份 Notion 文档 |
| triage-frontend-issues | 经批准后归档无需处理的噪声，分拣 Sentry javascript 项目的问题队列 |
| typing-exclusion-worker | 小批量地移除分配给它的 mypy 排除模块 |

两个子智能体是 code-simplifier 和 senpai，后者是给 Sentry 新员工的资深工程师兼导师。

来源：README 里的“Available Skills”和“Available Subagents”两张表。

## 哪些技能在 Sentry 之外也适用

这是 Mindket 读 SKILL.md 文件后的判断，不是 README 的说法。

- 写给所有人的：security-review、find-bugs、django-perf-review、django-access-review、gha-security-review、secret-serialization、skill-scanner、iterate-pr、agents-md、claude-settings-audit、code-simplifier、doc-coauthoring、prompt-optimizer、typing-exclusion-worker（它负责别人交给它的一批类型清理工作）。
- 套用 Sentry 自己的规范，可以当参照，或在你遵循同样规则时使用：commit、create-branch、pr-writer、pr-screenshots（它的描述写的是 Sentry 界面）、code-review、skill-writer（README 称它是这个仓库的技能编写流程）。
- 绑定 Sentry 的员工、系统或代码，在别处用处不大：blog-writing-guide、brand-guidelines、browse-local-sentry、document-api-endpoint、gh-review-requests、presentation-creator、pr-link-issue、sred-project-organizer、sred-work-summary、triage-frontend-issues。

## 工具包里的文件

- setup/claude-code.md：插件路线、更新命令和贡献者路线
- setup/other-agents.md：适用于 Cursor、Cline、GitHub Copilot 和其他智能体的 npx skills 命令
- setup/first-run.md：这些技能需要什么（gh、uv、MCP 服务器），以及每个技能会改动什么

## 先准备好这些

- 一个编程智能体。README 点名了 Claude Code，并说 npx 路线适用于 Claude Code、Cursor、Cline、GitHub Copilot 和其他兼容的智能体。
- Node.js，用于 npx 路线，以及 presentation-creator，它的 SKILL.md 会运行 npm。
- GitHub 命令行工具 gh，并且已登录，供 pr-writer、iterate-pr、gh-review-requests、pr-link-issue 和 pr-screenshots 使用，find-bugs 读取默认分支时也要用。
- uv，一个 Python 包管理器，供运行 Python 脚本的技能使用：iterate-pr、skill-scanner、gh-review-requests 和 security-model。
- Notion、Linear 和 Sentry 的 MCP 服务器，只有点名用到它们的 Sentry 员工技能才需要（setup/first-run.md）。
- 这套技能本身不需要账号、注册或 API 密钥。

## 装到哪里

- 插件路线：插件的文件由 Claude Code 自己保管。一个名为 sentry-skills 的插件装着所有技能和两个子智能体，所以它们会一起装上。
- npx skills 路线：技能文件夹放进你的智能体的技能文件夹。

## 你的数据

技能只是文本，自己不会发送任何东西。智能体会运行技能里写的命令，所以离开你电脑的，就是这些命令发出的内容：gh 和 GitHub 通信，用 MCP 的技能和 Sentry、Notion 或 Linear 通信。有些技能会写入：commit 和 iterate-pr（它会提交、推送，还能回复审查讨论）会改动你的仓库。pr-writer 会在 GitHub 上开草稿拉取请求，也会更新已有 PR 的标题和正文，pr-link-issue 会修改 PR 的正文。sred-work-summary 会写一份私有的 Notion 文档。

## 更新和卸载

setup/claude-code.md 给出了 README 的更新命令。README 没有给出卸载步骤。Claude Code 的文档说明了插件该怎么卸载，setup/claude-code.md 里有注明。

README.md  7 KB
setup/claude-code.md  3 KB
setup/first-run.md  4 KB
setup/other-agents.md  2 KB