SuperAPI AI 工具集

spec-driven-review

安全与审计

查看项目

更新于 10-16 06:22

技能介绍

用途:在规范驱动变更完成、归档之前,对代码质量进行审查,覆盖可读性、安全、性能、错误处理与项目最佳实践,并检查测试质量与规范映射质量。

主要能力:先确认变更是否就绪(apply 命令的 remaining 必须为 0),再读取 proposal.md、specs/、design.md、tasks.md、questions.md、config.yaml 及映射 frontmatter,识别被创建或修改的文件并完整阅读。按证据分类变更,叠加安全敏感、UI、DX、迁移、API、维护等专项检查清单,同时执行基线检查。审查测试是否覆盖增量规范关键场景、是否独立可重复、是否符合 config.yaml 的 rules.test。审计 mapping.implementation 与 mapping.tests 是否与实现和测试文件一致,过期或误导性映射至少记为 SHOULD FIX,若主要实现或直接验证测试文件缺失于所有主规范映射则记为 MUST FIX。最终输出 MUST FIX、SHOULD FIX、NITS 三级报告并建议下一步。

使用方式:项目根目录需存在 .spec-driven/,否则先运行 /spec-driven-init。用 node {{SKILL_DIR}}/scripts/spec-driven.js modify 列出活动变更,用 apply <name> 确认就绪,用 audit-spec-mapping-coverage 与 audit-unmapped-spec-evidence 辅助映射审计。

限制:只审查本次变更涉及的文件,不重复审查未改动代码;不因代码由 AI 或自己生成而放宽标准;不纠结已由 linter 处理的风格偏好;MUST FIX 指安全漏洞、数据丢失风险、功能损坏。其他细节暂未提供。