SuperAPI AI 工具集

nestjs-feature-audit

编程与开发

查看项目

更新于 10-15 16:48

技能介绍

用途:针对某个 NestJS 功能,在明确识别的版本上,把文档化目标与当前实现做对比,返回可追溯的状态报告,仅审计不修复。

主要能力:

  • 安全准备目标分支:先读仓库指令,记录 git status --short --branch、当前分支、remote、目标分支本地/远端存在性;工作区脏、有 Git 操作进行中或处于 detached 状态时停止切换;仅允许正常切换与 git merge --ff-only,不做 merge/rebase/stash/丢弃/强切。
  • 路线图门槛:在 docs/ 中搜索功能名、别名、roadmap、plan、milestone、phase、acceptance、migration 等,只有能定义明确功能范围与具体目标项、阶段、验收条件或迁移结果才算路线图;标题、TODO、changelog 或泛化描述不算。无清晰路线图则在实现对比前停止,报告已搜索路径与词条。
  • 建立可追溯矩阵:逐条路线图项归一化,追踪到源码、测试、配置、schema/迁移、生成契约、部署/运行证据与相关标准;记录 verified、partial、absent、superseded、broken、blocked、not verifiable;每条正反结论附路径行号或精确命令结果,缺失结论须列出检索与预期集成点。
  • 领域标准交叉引用:架构边界、对象职责与不变量、运行时生命周期与安全控制、测试与构建产物等;未运行项标为 not verified,不转成成功或失败;区分路线图完成与生产验证。
  • 输出固定四段报告:标题为 ✅ Implemented、❌ Missing/Not Implemented、⚠️ Legacy Code、🛑 Bugs & Blockers,每项含需求、观察状态、证据、影响与下一步验证;空类别写 None found。

使用方式:优先调用 $nestjs-feature-audit "payments",可加 --branch "release/2026-q3";若宿主路由 /audit_feature payments 或 /audit_feature payments on branch release/2026-q3 则等价解析。Codex 上可选 /prompts:audit_feature,但已装技能仍是首选接口。必要 Git 命令保持原样,如 git fetch --prune origin、git switch -- "$audit_branch"、git rev-parse HEAD。

限制:审计本身不授权修复;只有显式审计并修复请求才可在门槛与审计后进入独立实现阶段。不计算完成百分比(除非路线图定义权重),不实现、提交、推送、部署或编辑路线图。非空功能名与分支解析为前置条件;无路线图需用户提供或指定。部分依赖技能未提供时仅作决策边界,不强制依赖。官方收费、平台支持等细节暂未提供。