用途:axum-agents-api-review 是一个编排型技能,用于审计现有 Axum 代码、一个 diff 或单个文件。包内其他 28 个技能教如何编写正确的 Axum 代码,本技能教如何依据这些知识审计已有代码。
主要能力:代理读取代码库、diff 或单文件,运行 10 类检查清单,为每条发现分配严重级别,并输出结构化发现;每条发现都指明负责纠正指导的具体技能。两条规则:本技能只检测与委派,绝不在行内教修复方法;不引入任何新的 Axum API 主张,每项检查都追溯到其他技能已拥有的已验证反模式。
严重级别:blocker(无法编译、启动或运行时 panic、已确认安全漏洞)、warning(可编译运行但存在潜在正确性、可靠性或运维缺陷)、suggestion(工作正常但偏离最佳实践)。不确定时向上取整。
审查流程:从 Cargo.toml 确定目标 Axum 版本(0.7 或 0.8),未知则报告 unknown 并标记版本敏感检查;对代码运行全部 10 类检查;每条发现分配恰好一个严重级别;尽可能映射到 16 个反模式之一;先输出摘要头,再输出有序结构化发现。
输出格式:先摘要头(发现数、blockers/warnings/suggestions 计数、目标 Axum 版本),然后每条发现一个块,含严重级别、标题、位置、症状、反模式编号(如适用)、修复技能、一行纠正方向。发现必须按 blocker、warning、suggestion 排序,同级内按文件与行号排序。零发现时仍须输出计数为 0 的摘要头和明确的“No issues found”行。
10 类检查:路由、提取器、处理器、中间件、状态、错误、认证、数据库、性能、部署。
限制:只报告锚定到检查清单或反模式编号的发现;无对应检查的发现不报告;不在行内粘贴修复代码或完整解释;不发明严重级别。完整检查表、反模式表与示例见 references/methods.md、references/examples.md、references/anti-patterns.md。