Stats
Actions
Tags
BladeX 专业代码审计工具。从资深架构师视角对代码进行全方位审计，涵盖代码质量、架构合规、框架规范、安全漏洞、逻辑健壮性、性能隐患六大维度。支持三种审计输入：Git commit 记录审计、设计文档与实现对比审计、工程目录全量审计。自动生成包含严重级别、定位信息、修复建议的专业审计报告。当用户需要进行代码审查、代码审计、质量检查、安全扫描、架构评审、设计合规检查、或使用 /blade-audit 时触发。即使用户只是说"帮我审查下代码"、"看看这几个提交有没有问题"、"检查下代码质量"、"这个模块写得怎么样"、"有没有安全隐患"、"review 一下"、"帮我把把关"等模糊表述也应触发。
How this skill is triggered — by the user, by Claude, or both
Slash command
/team-ai-coding-plugin:blade-auditThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
以下规则在任何情况下都不可违反：
以下规则在任何情况下都不可违反：
| 级别 | 标记 | 含义 | 判定标准 |
|---|---|---|---|
| 严重 | 🔴 | 必须在上线前修复 | 存在安全漏洞、数据损坏风险、或生产事故隐患 |
| 重要 | 🟠 | 当前迭代应修复 | 影响系统稳定性、可维护性、或违反核心架构原则 |
| 建议 | 🟡 | 建议改进 | 提升代码质量、可读性、或符合最佳实践 |
| 提示 | 🟢 | 参考信息 | 最佳实践建议、风格偏好、优化思路 |
/blade-audit --commit [commit-range]
参数说明：
commit-range：Git commit 范围，支持以下格式：
abc1234abc1234..def5678HEAD~3..HEAD适用场景： Code Review、合并前检查、提交后回顾
/blade-audit --design <design-doc-path> [code-path]
参数说明：
design-doc-path：设计文档路径（Markdown / 文本文件 / blade-spec 输出的规范文档）code-path：对应的实现代码路径（省略时在当前工程中自动定位）适用场景： 设计评审、实现完整性检查、规范驱动开发的验收环节
/blade-audit [path] [options]
参数说明：
path：审计目标路径（省略时为当前工程根目录）--module <module-name>：仅审计指定模块（如 blade-auth、blade-system）--focus <dimension>：聚焦特定审计维度（见下方六大维度）--depth <shallow|standard|deep>：审计深度，默认 standard
shallow：快速扫描，仅检查高优先级项standard：标准审计，覆盖全部维度的核心检查项deep：深度审计，包含交叉分析、依赖链追踪、数据流分析适用场景： 新人接手项目、版本发布前全面检查、技术债务评估
审计从以下六个维度展开，每个维度的详细检查项见 references/audit-checklist.md：
关注代码的可读性、可维护性和工程规范：
从架构师视角审视系统结构的合理性：
检查是否遵循 BladeX 框架的特定约定和最佳实践：
R<T> 返回识别潜在的安全风险和漏洞：
${} 拼接或手动拼接 SQL审查业务逻辑的正确性和边界处理：
发现可能导致性能问题的代码模式：
根据用户输入的模式进行初始化：
1.1 解析输入参数
1.2 识别工程类型
1.3 确定审计范围
--module 或 --focus，收窄审计范围1.4 向用户确认审计范围
输出审计范围摘要，等待用户确认后再继续：
📋 审计范围确认
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
审计模式：目录审计
工程类型：Cloud 微服务
目标模块：blade-auth
审计深度：standard
文件范围：Java 文件 42 个，XML 文件 8 个，配置文件 3 个
审计维度：全部六维度
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
确认开始审计？(Y/n)
2.1 代码采集
根据审计模式采集代码：
commit 模式：
git show / git diff 获取每个 commit 的变更内容design 模式：
directory 模式：
2.2 结构预分析
在正式审计前，先建立对代码的整体认知：
输出预分析摘要供审计阶段参考，不必展示给用户。
这是核心阶段。读取 references/audit-checklist.md 中对应维度的检查清单，逐项进行检查。
执行原则：
维度执行顺序：
按风险影响从高到低排序执行：
这个顺序确保最危险的问题最先被发现。如果用户通过 --focus 指定了维度，则只执行指定维度。
单维度审计完成后，进行跨维度的关联分析：
4.1 关联分析
4.2 模式识别
4.3 风险聚合
4.4 合规评分
按维度计算合规分数：
维度合规分 = (通过检查项数 / 适用检查项总数) × 100
综合评分 = 各维度加权平均
安全审计：权重 25%
逻辑健壮性：权重 20%
架构合规：权重 20%
框架规范：权重 15%
性能隐患：权重 10%
代码质量：权重 10%
评分等级：
读取 references/report-template.md 获取报告模板，生成最终审计报告。
5.1 生成报告
按照报告模板的结构，填充所有审计发现。报告以 Markdown 格式输出，结构如下：
5.2 输出报告
将报告输出到对话中展示给用户。如果用户需要，可以保存为文件。
5.3 后续建议
根据审计结果，给出后续操作建议：
/blade-spec 规划整改方案/blade-compare 对比参考实现/blade-sync 同步变更设计审计模式除了执行上述六维度检查外，还增加以下对比分析：
对照设计文档逐项检查：
对每个偏差点记录：
在标准报告之外，额外输出设计对比矩阵：
| 设计项 | 设计要求 | 实现状态 | 偏差说明 |
|--------|----------|----------|----------|
| 用户列表接口 | GET /user/list, 支持分页 | ✅ 已实现 | — |
| 角色权限校验 | 基于 RBAC | ⚠️ 部分实现 | 缺少数据权限控制 |
| 审计日志 | 所有写操作记录审计日志 | ❌ 未实现 | 关键功能缺失 |
对每个 commit 进行变更影响评估：
除代码审计外，额外评估提交本身的质量：
| 场景 | 推荐组合 |
|---|---|
| 先设计后审计 | /blade-spec → 开发 → /blade-audit --design |
| 审计后修复同步 | /blade-audit → 修复 → /blade-sync 同步到镜像工程 |
| 审计前先对比 | /blade-compare 发现差异 → /blade-audit 深入审计差异代码 |
| 审计后提交 | /blade-audit --commit HEAD~1..HEAD → 修复 → /blade-commit |
| 方案讨论 | /blade-storm 讨论架构 → 落地 → /blade-audit 验证实现 |
npx claudepluginhub tiantien/team-ai-coding-plugin --plugin team-ai-coding-pluginCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.