AGENT SKILL

speclite-code-review-01-reviewer

执行 Story code review,用 Blind Hunter、Edge Case Hunter、Acceptance Auditor 三层审查并生成 CR v2 结果。用于用户要求 CR、code review、代码审查、复审或 Story implementation review。核心能力:精确 scope、稳定 finding fingerprint、layer quorum 和结构化 verdict。

License 许可
MIT
所属仓库
flanliulf/SpecLite
最近更新
2026-11-12
Stars
★ 4
Forks
0

01 前言 Front Matter

name
speclite-code-review-01-reviewer
metadata
{ "author": "fancyliu", "catalog": "speclite", "version": "2.1.0" }
description
执行 Story code review,用 Blind Hunter、Edge Case Hunter、Acceptance Auditor 三层审查并生成 CR v2 结果。用于用户要求 CR、code review、代码审查、复审或 Story implementation review。核心能力:精确 scope、稳定 finding fingerprint、layer quorum 和结构化 verdict。
allowed-tools
Read, Write, Bash, Grep, Glob, Agent

02 资源文件 5

03 SKILL.md 正文

Speclite Code Review 01 Reviewer(代码审查 Reviewer)

Overview(概述)

针对一个指定 Story 执行只读三层代码审查,输出 speclite.cr-review.v2。本 Skill 可由 runner 编排,也可在 fresh session 中独立调用;不修改源码、测试、Story 或 tracker。

Activation Boundary(激活边界)

  • 用于冻结一个 Story 的 current review scope、执行三层审查并生成 reviewer artifact。
  • 不用于评估 finding、执行修复、登记 TODO、同步 Story 状态或编排整个 Epic;这些任务分别交给 CR02–06 或 runner。

Core Capabilities(核心能力)

  • 精确范围:冻结并核对 declared、actual、excluded files 与 scopeHash。
  • 三层 quorum:组合 Blind Hunter、Edge Case Hunter 与 Acceptance Auditor。
  • 稳定 finding:用具体失败场景和 fingerprint 过滤噪声、重复与历史漂移。
  • 结构化交接:输出可被 evaluator 精确绑定的 speclite.cr-review.v2。

Contract(共享契约)

将当前 Skill 目录父目录解析为 {skills-root},完整读取 {skills-root}/speclite-code-review-contract/references/cr-contract.md,再运行 speclite resolve config --project-root {project-root}。CR 目录只消费 runner 或人工 orchestrator 通过 speclite resolve cr-directory 传入的 crDir,不重推导。任一解析失败即 HALT;不得使用 runner、旧 artifact 或历史默认路径作为 fallback。

Inputs(输入)

  • crDir、compatibilityMode 与 legacyArtifactPaths:由 runner 或人工 orchestrator 通过 speclite resolve cr-directory 解析后传入;缺失时自行调用该 CLI 一次,不得以其他方式推导。
  • Story path、storyId 或 storyKey,以及 reviewSeries。
  • review scope manifest,或足够独立生成它的 development record/用户指定 commit range。
  • orchestrationMode 与 handoffTarget;缺失时按人工 standalone 调用处理。

Workflow(工作流)

完整读取并执行 references/reviewer-workflow.md;三层内部算法继续以 references/review-engine.md 为准。入口只保留以下硬门禁:

  1. 解析 identity、current series round 和 runtime paths。
  2. 冻结包含 staged、unstaged、untracked 的完整 scope。
  3. 执行三个 fresh review layer 并规范 finding。
  4. 写入模板、重读验证并交接 CR02。

scopeExceptions 非空时只能输出 REVIEW_DEGRADED;仅 0/3 或 1/3 layer 成功时 HALT,不得生成 current review。完整 PASS 建议必须满足 3/3 quorum。

Outputs and Handoff(输出与交接)

  • 严格使用 assets/output-template.md,写入共享 contract 定义的 review canonical path。
  • 返回 artifact path、hash、scope、round、verdict、layer status 和下一步 speclite-code-review-02-evaluator。
  • 将结果交给 handoffTarget;人工模式直接交给 manual orchestrator 或用户,不要求 runner 存在。

Notes(注意事项)

  • 不设最低 finding 数;零 finding 在 scope complete 且 3/3 quorum 下合法。
  • 不得把旧 completion gate 或历史测试数字表述为本轮实际执行。
  • 不得对同一 storyId + reviewSeries + round 并发执行两次 reviewer。
  • 始终使用中文输出,模型、命令和 evidence 来源必须如实记录。

Generation Metadata(生成信息)

本 Skill 由 speclite-skill-creator 体系维护。如需修改,必须同步更新 SKILL.md、SKILL.en.md、CHANGELOG.md、references/、assets/ 与实际安装副本。

04 同仓库更多 Skills

flanliulf
flanliulf/SpecLite

speclite-dev-story

暂无简介

★ 4
flanliulf
flanliulf/SpecLite

speclite-code-review-01-reviewer

Fixture-owned installed skill entry for the minimal artifact loop.

★ 4
flanliulf
flanliulf/SpecLite

speclite-skill-lint

只读检查 Skill 定义;用于 lint skill、check skill、检查技能或评估 Skill 规范。区分基础格式、Codex 适配和 SpecLite 约定,报告证据及未检查项;Agent 定义包转交 speclite-agent-lint。

★ 4
flanliulf
flanliulf/SpecLite

speclite-skill-creator

创建或迭代 SpecLite workflow Skill;用于 create skill、新建技能、生成技能包或封装工作流。设计入口、辅助资源和验证用例;Agent 定义包转交 speclite-agent-creator。

★ 4
flanliulf
flanliulf/SpecLite

speclite-html-ppt-generator

生成 SpecLite-owned 单文件 HTML PPT。用于用户要求创建 docs presentation、HTML PPT、网页 slides、Swiss Style deck、杂志风 deck,或其他可直接浏览器打开的介绍/分享型 deck。核心能力:使用本 Skill 内置模板、主题、layout 和 validator 生成横向翻页 HTML,并避免依赖外部个人 skill 路径。

★ 4
flanliulf
flanliulf/SpecLite

speclite-docs-intro-ppt-creator

生成 SpecLite docs 下的介绍型 HTML PPT。用于用户要求把某个项目体系、系统设计、治理机制、理念或工作流总结成 docs presentation、HTML PPT、网页 slides、介绍 deck。核心能力:限定输出目录、基于事实材料规划叙事、调用 speclite-html-ppt-generator 生成单 HTML deck,并用确定性检查和浏览器抽样收口。

★ 4