关于 warden
warden 是用于提交代码前分析变更的命令行技能,支持按触发器运行,也可指定文件或技能,并可选择自动修复。它按严重程度报告发现。
主要功能
- 01分析未提交的变更
- 02分析指定文件
- 03运行指定技能
- 04使用 --fix 自动应用修复
- 05初始化和管理技能触发器
适用场景
- 01提交前检查代码变更
- 02检查指定源文件
- 03自动应用报告的问题修复
- 04设置 Warden 配置和工作流
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ getsentry/ warden --skill warden安装后在 Claude Code 中输入/warden确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
SOURCES.mdSPEC.mdreferences/cli-reference.mdconfig-schema.mdconfiguration.mdcreating-skills.md详细介绍
在提交前运行 Warden 分析代码更改。
参考文档
当任务需要更深入的细节时,请阅读相关参考文档:
| 文档 | 阅读时机 |
|---|---|
<skill-root>/references/cli-reference.md | 查看完整选项详情、各命令的标志和示例 |
<skill-root>/references/configuration.md | 编辑 warden.toml、触发条件、模式和故障排除 |
<skill-root>/references/config-schema.md | 查看准确的字段名称、类型和默认值 |
<skill-root>/references/creating-skills.md | 编写自定义技能、远程技能和技能发现 |
运行 Warden
# Analyze uncommitted changes (uses warden.toml triggers)
warden
# Run a specific skill
warden --skill <skill-name>
# Analyze specific files
warden src/auth.ts src/database.ts
# Analyze changes from a git ref
warden main..HEAD
warden HEAD~3
# Auto-apply suggested fixes
warden --fix
# Fail on high-severity findings
warden --fail-on high
运行前,先为所用模型设置 WARDEN_MODEL 和以 WARDEN 为前缀的提供商 API 密钥。
提交前工作流
完成代码更改后、提交前:
- 运行
warden分析未提交的更改 - 检查分析结果
- 修复 Warden 报告的问题(或使用
warden --fix自动应用修复) - 提交更改
运行一次 Warden 以验证工作结果。不要针对相同的更改反复运行 Warden。
阅读输出
严重级别:
high- 合并前必须修复medium- 值得检查low- 轻微改进
退出代码: 0 = 没有达到或超过失败阈值的问题。1 = 存在达到或超过失败阈值的问题。
详细程度: -v 显示实时问题。-vv 显示调试信息(令牌、延迟)。-q 仅显示错误和摘要。
命令
| 命令 | 说明 |
|---|---|
warden | 运行分析(默认) |
warden init | 初始化 warden.toml 和 GitHub 工作流 |
warden add [skill] | 将技能触发条件添加到 warden.toml |
warden sync [remote] | 更新缓存的远程技能 |
warden setup-app | 通过清单流程创建 GitHub App |
如需查看完整选项和标志,请阅读 <skill-root>/references/cli-reference.md。
评论
支持 Markdown