技能 allra-error-handling
📦

allra-error-handling

内容修订 r2 中风险 ⚙️ 外部命令

实现 Allra 错误处理

团队需要一致的 Spring 后端错误、日志记录和响应格式。此技能指导 Claude、Codex 和 Claude Code 使用 Allra 风格的异常模式。

支持: Claude Codex Code(CC)
📊 70 合格

使用我的智能体安装

将此请求复制给你的智能体，其中包含权威 Skill 页面和清单。

智能体请求
Review the Skillstore skill "allra-error-handling" from https://skillstore.io/skills/allra-fintech-allra-error-handling.md and its manifest at https://skillstore.io/api/skills/allra-fintech-allra-error-handling/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

你的智能体仍应展示其计划，并按安全策略请求必要确认。

Agent 可读资源

当 AI Agent、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。

Markdown 详情 GET /skills/allra-fintech-allra-error-handling.md 已签名 manifest GET /api/skills/allra-fintech-allra-error-handling/manifest 已签名 lockfile GET /api/skills/allra-fintech-allra-error-handling/lockfile

测试它

正在使用“allra-error-handling”。 当找不到用户时，服务返回 null。

预期结果:

  • 建议使用领域特定的未找到异常。
  • 将该异常映射到标准的未找到错误代码。
  • 返回一致的 API 错误响应，并包含清晰的消息。

正在使用“allra-error-handling”。 global handler 对验证错误和业务错误返回不同的响应结构。

预期结果:

  • 识别不一致的响应字段。
  • 将两条路径对齐到共享的错误响应结构。
  • 指出任何应被脱敏的敏感被拒绝值。

正在使用“allra-error-handling”。 团队希望获得针对预期失败和意外失败的日志记录指导。

预期结果:

  • 对预期的业务异常使用 warning 日志。
  • 对意外的系统故障使用 error 日志。
  • 在写入结构化日志字段之前屏蔽个人数据。

安全审计

中风险
v10 • 2026/7/23 打开版本化报告

All 21 static findings are false positives caused by Markdown code fences or ordinary Java identifiers; the skill executes no external commands. One medium-severity design concern remains because examples may expose personal or sensitive values through logs and validation responses.

1
已扫描文件
366
分析行数
0
复核项
0
已忽略误报

已确认安全问题 (1)

中
SKILL.md:144-156SKILL.md:217-220SKILL.md:333-338
Potential Sensitive Data Exposure in Logs and Errors
Examples log exception details and email addresses, then return rejected values without redaction. Reuse could expose passwords, tokens, or personal data.
The examples explicitly log email and exception content and expose rejected input values. Secret exposure depends on which request fields reach these paths.

风险因素

⚙️ 外部命令 (19)
SKILL.md:14-73 SKILL.md:73-79 SKILL.md:79-116 SKILL.md:116-122 SKILL.md:122-176 SKILL.md:176-182 SKILL.md:182-223 SKILL.md:223-230 SKILL.md:230-237 SKILL.md:237-240 SKILL.md:240-253 SKILL.md:253-259 SKILL.md:259-271 SKILL.md:271-275 SKILL.md:275-303 SKILL.md:303-309 SKILL.md:309-326 SKILL.md:326-332 SKILL.md:332-342
审计者: codex 查看审计历史 →
分享与引用此报告

分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。

打开版本化报告
安全评估

复制报告链接

https://skillstore.io/skills/allra-fintech-allra-error-handling/audits/10?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/allra-fintech-allra-error-handling/security.svg)](https://skillstore.io/skills/allra-fintech-allra-error-handling?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/allra-fintech-allra-error-handling?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/allra-fintech-allra-error-handling/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/allra-fintech-allra-error-handling.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
学术引用 (APA · BibTeX · CFF)

APA 引用

Allra-Fintech. (2026). allra-error-handling security audit report (audit version 10) [Author version unspecified]. Skillstore. https://skillstore.io/skills/allra-fintech-allra-error-handling/audits/10

BibTeX 引用

@techreport{allra-fintech-allra-fintech-allra-error-handling-2026, author = {Allra-Fintech}, title = {allra-error-handling security audit report (audit version 10)}, institution = {Skillstore}, year = {2026}, number = {10}, url = {https://skillstore.io/skills/allra-fintech-allra-error-handling/audits/10}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "allra-error-handling security audit report (audit version 10)" version: "unspecified" type: report authors: - name: "Allra-Fintech" date-released: "2026-07-23" url: "https://skillstore.io/skills/allra-fintech-allra-error-handling/audits/10" identifiers: - type: other value: "skillstore:allra-fintech-allra-error-handling:audit:10" description: "Skillstore immutable audit report identifier"

Skillstore 评分

评分依据 证据置信度: 高
55
架构
85
可维护性
87
内容
69
社区
83
规范符合性

你能构建什么

创建服务异常

为新的后端领域添加一致的业务异常和错误代码。

标准化 API 错误

在暴露新的 API endpoint 之前审查 controller advice 和响应 DTO。

审查日志行为

检查业务异常和系统异常是否使用了合适的日志级别和格式。

试试这些提示

创建基础异常 
使用 allra-error-handling skill 为缺失的发票创建自定义业务异常。包括 ErrorCode 条目和预期响应行为。
添加验证处理 
使用 allra-error-handling skill 为此 Spring controller advice 添加验证错误处理。保持响应格式与 Allra 标准一致。
重构服务错误 
使用 allra-error-handling skill 重构此服务方法。将 null 检查和通用异常替换为标准业务异常和日志级别。
审计错误策略 
使用 allra-error-handling skill 审计此后端模块的异常层级、HTTP 状态映射、响应一致性和安全日志记录实践。

最佳实践

  • 将错误代码、HTTP 状态值和消息保存在一个经过审查的 enum 或 registry 中。
  • 使用领域特定异常，让服务代码清晰表达业务意图。
  • 在返回验证错误或写入日志之前，对敏感请求值进行脱敏。

避免

  • 对预期的业务失败抛出通用 runtime exceptions。
  • 对验证错误、业务错误和系统错误返回不同的响应结构。
  • 记录原始密码、token、账号或个人标识符。

常见问题

哪些项目适合使用此技能？
它适用于使用 Spring 风格异常处理和结构化 API 响应的 Java 后端服务。
我可以更改错误代码吗？
可以。此技能展示了示例代码方案，但每个项目都应定义自己已获批准的 registry。
此技能会生成可运行的应用程序代码吗？
它提供模式和示例。开发者仍需要调整 imports、packages、tests 和框架配置。
应如何处理验证错误？
返回一致的字段级消息，但要对密码、token、账号和其他敏感字段的被拒绝值进行脱敏。
业务异常应使用哪个日志级别？
预期的业务异常通常应使用 warning 级别。意外的系统故障通常应使用 error 级别。
此技能对受监管数据安全吗？
将其与本地隐私规则结合使用。在生产使用前更新示例，以屏蔽个人数据。

开发者详情

许可证

MIT

Skillstore 修订

r2

版本提示

作者未声明版本。

仓库

https://github.com/Allra-Fintech/allra-ai-skills/tree/main/backend-plugin/skills/error-handling

引用

31bc7611b504c197d3e993aef7943461c871616f

维护新鲜度

2026/7/26

使用量

10 次下载 · 153 次浏览

文件结构

📄 SKILL.md

Allra-Fintech 的更多技能

查看全部

相关技能

查看全部