用途:对 HEAD 与用户指定固定点之间的 diff 做双轴审查。Standards 轴检查代码是否符合仓库文档化的编码规范;Specification 轴检查代码是否忠实实现原始 issue/规格。两轴由并行子代理执行,避免上下文互相污染,再由本技能汇总结果。
主要能力:
- 固定基准点:接受 commit SHA、分支名、标签、main、HEAD~5 等;未指定时需向用户询问。使用 git diff <fixed-point>...HEAD(三点,与 merge-base 比较),并用 git log <fixed-point>..HEAD --oneline 记录提交列表。继续前用 git rev-parse <fixed-point> 确认引用可解析且 diff 非空。
- 定位规格来源:依次查找 documentation/agents/issue-tracker.md 中记录的 issue 引用(如 #123、Closes #45、GitLab !67)、用户传入的路径、documentation/、specifications/、backlog/、.refinement/ 下与分支或功能匹配的规格文件。找不到时让用户三选一:运行 /setup-custom-skills 配置追踪、提供规格或其路径、或仅做 Standards 轴。
- 定位规范来源:仓库中记录编码方式的文件(如 CODING_STANDARDS.md、CONTRIBUTING.md),并始终附带 Fowler 代码坏味道基线(Mysterious Name、Duplicated Code、Feature Envy、Data Clumps、Primitive Obsession、Repeated Switches、Shotgun Surgery、Divergent Change、Speculative Generality、Message Chains、Middle Man、Refused Bequest)。仓库文档优先于基线;基线项均为判断性提示而非硬性违规;工具已强制的内容跳过。
- 并行子代理:Standards 子代理报告违反文档规范之处(引用文件与规则)及基线坏味道(命名并引用 hunk),区分硬性违规与判断项,400 词以内;Specification 子代理报告缺失或部分实现的需求、未被要求的行为(范围蔓延)、实现有误的需求,并引用规格原文,400 词以内。
- 汇总:以 ## Standards 和 ## Spec 两个标题分别呈现两份报告,不合并、不重排;末尾给出一行总结(各轴发现数量及最严重问题),不跨轴选唯一赢家。
- 发布:询问是否发布及发布位置(GitHub/GitLab PR/MR 或 Jira issue)。若同意,调用 publish-review 技能;该技能为实验性且默认未安装,不可用时提示安装命令 npx skills@latest add Dyrits/SKILLS --skill=publish-review,不自行复刻其发布逻辑。
适用场景:需要同时评估代码规范符合度与需求实现正确性的代码审查,尤其适合有明确 issue/规格来源和仓库编码规范的团队。
限制:固定点必须由用户提供或确认;规格缺失时只能做 Standards 轴并注明“no specification available”;基线坏味道始终是判断性提示;发布功能依赖未默认安装的实验性技能。具体收费、平台支持等资料暂未提供。