[!NOTE]
如需获取帮助你在项目中设置 Sentry 或调试生产问题的技能，请参阅 https://github.com/getsentry/sentry-for-ai
面向 Sentry 员工的智能体技能，遵循 Agent Skills 开放格式。
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
或者运行 /plugin 打开插件管理器。
对于支持 skills.sh 生态系统的智能体：
npx skills add getsentry/skills
适用于 Claude Code、Cursor、Cline、GitHub Copilot 及其他兼容的智能体。
| 技能 | 描述 |
|---|---|
| agents-md | 当用户要求“创建 AGENTS.md”、“更新 AGENTS.md”、“维护智能体文档”、“设置 CLAUDE.md”或需要保持智能体指令简洁时，应使用此技能。 |
| blog-writing-guide | 遵循 Sentry 特定的写作标准、语调和质量要求，为 Sentry 工程博客撰写、审阅和改进博文。 |
| brand-guidelines | 遵循 Sentry 品牌指南撰写文案。 |
| claude-settings-audit | 分析代码仓库以生成推荐的 Claude Code settings.json 权限配置。 |
| code-review | 遵循 Sentry 工程实践进行代码审查。 |
| code-simplifier | 简化和优化代码以提高清晰度、一致性和可维护性，同时保留所有功能。 |
| commit | 始终 在提交代码更改时使用此技能——切勿在没有它的情况下直接提交。 |
| create-branch | 遵循 Sentry 命名规范创建 git 分支。 |
| django-access-review | Django 访问控制和 IDOR 安全审查。 |
| django-perf-review | Django 性能代码审查。 |
| doc-coauthoring | 引导用户完成结构化的文档协作工作流。 |
| find-bugs | 在本地分支的更改中查找错误、安全漏洞和代码质量问题。 |
| gh-review-requests | 获取指定团队被请求评审或由团队成员打开的 PR 的未读 GitHub 通知。 |
| gha-security-review | 针对工作流利用漏洞的 GitHub Actions 安全审查。 |
| iterate-pr | 持续迭代 PR 直到 CI 通过。 |
| pr-writer | 遵循 Sentry 约定创建和更新拉取请求的规范工作流。 |
| security-review | 针对漏洞的安全代码审查。 |
| skill-scanner | 扫描智能体技能以发现安全问题。 |
| skill-writer | 为本仓库合成、创建和迭代改进智能体技能的规范工作流。 |
| sred-project-organizer | 获取项目及其相关文档列表，并将其组织成 SRED 格式以提交。 |
| sred-work-summary | 回顾过去一年的工作，创建一个 Notion 文档，将相关链接分组到项目中，以便后续记录为 SRED 项目。 |
| 子智能体 | 描述 |
|---|---|
| code-simplifier | 简化和优化代码以提高清晰度、一致性和可维护性，同时保留所有功能。 |
| senpai | 面向 Sentry 新员工的高级工程师和技术导师。分步解释基础设施、架构和工程概念，并提供参考。 |
git clone git@github.com:getsentry/skills.git ~/sentry-skills
claude plugin marketplace add ~/sentry-skills
claude plugin install sentry-skills
sentry-skills/
├── .claude-plugin/
│ └── marketplace.json # 市场清单
├── plugins/
│ └── sentry-skills/
│ ├── .claude-plugin/
│ │ └── plugin.json # 插件清单
│ ├── agents/
│ │ └── code-simplifier.md
│ └── skills/
│ ├── code-review/
│ │ └── SKILL.md
│ └── commit/
│ └── SKILL.md
├── AGENTS.md # 面向智能体的文档
├── CLAUDE.md # 指向 AGENTS.md 的符号链接
└── README.md # 本文件
技能遵循 Agent Skills 规范。每个技能都需要一个包含 YAML 前置元数据的 SKILL.md 文件。
关于可重复的 skill-writer 评估提示，请参阅 plugins/sentry-skills/skills/skill-writer/EVAL.md。
在 plugins/sentry-skills/skills/ 下创建一个新目录：
plugins/sentry-skills/skills/my-skill/
└── SKILL.md
SKILL.md 格式：
---
name: my-skill
description: 清晰描述此技能的作用以及何时使用它。包含帮助智能体识别此技能何时相关的关键词。
---
# 我的技能名称
## 指令
为智能体提供的分步指导。
## 示例
展示预期输入/输出的具体示例。
## 指南
- 需要遵循的具体规则
- 需要处理的边界情况
| 字段 | 描述 |
|---|---|
license |
许可证名称或许可证文件路径 |
compatibility |
环境要求（最多 500 字符） |
allowed-tools |
技能可以使用的工具列表（逗号分隔） |
metadata |
用于附加属性的任意键值对 |
---
name: my-skill
description: 此技能的作用
license: Apache-2.0
allowed-tools: Read, Grep, Glob
---
技能应根据其适用范围放置在适当的位置：
| 范围 | 位置 | 示例 |
|---|---|---|
| 全局 - 在整个 Sentry 中使用 | sentry-skills 插件 |
commit, code-review, pr-writer |
| 领域特定 - 由某个团队或领域使用 | 本仓库中的专用插件（例如 infra-skills） |
gcp-logs, terraform-review |
| 仓库特定 - 仅与一个仓库相关 | 仓库本身（.claude/skills/） |
项目特定的工作流 |
决定技能放置位置时：
- 如果大多数 Sentry 工程师都会受益，则将其添加到 sentry-skills
- 如果只有特定团队需要，则创建或使用领域特定的插件
- 如果它只在一个仓库中有意义，则将其保留在该仓库中
此仓库是一个 Claude Code 市场——一个可以独立安装的插件集合。市场清单（.claude-plugin/marketplace.json）列出了所有可用的插件：
{
"plugins": [
{ "name": "sentry-skills", "source": "./plugins/sentry-skills" },
{ "name": "infra-skills", "source": "./plugins/infra-skills" }
]
}
每个插件都位于 plugins/ 下自己的目录中，并拥有自己的 plugin.json 清单。用户可以安装单个插件：
# 仅安装全局技能
claude plugin install sentry-skills@sentry-skills
# 安装领域特定技能
claude plugin install infra-skills@sentry-skills
要添加一个新的领域特定插件：
plugins/<plugin-name>/.claude-plugin/plugin.jsonplugins/<plugin-name>/skills/ 下添加技能.claude-plugin/marketplace.json 中注册该插件我们将经常使用的技能和智能体引入（复制）到此仓库中，而不是在运行时依赖外部源。这种方法：
当从外部源引入技能或智能体时，请保留适当的归属：
在文件顶部添加注释，引用原始来源：
markdown
<!--
基于 [原始名称] 由 [作者/组织] 创建：
https://github.com/example/original-source
-->
如果原始来源有特定的许可要求，请在技能目录中包含 LICENSE 文件：
plugins/sentry-skills/skills/vendored-skill/
├── SKILL.md
└── LICENSE # 原始许可证文本
code-simplifier 智能体是从 Anthropic 的官方插件 引入的。请参阅智能体文件顶部的归属注释。
Apache-2.0