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
- 最近更新
- 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
- 资产文件assets/output-template.md2.7 KB
- 参考文档CHANGELOG.md2.6 KB
- 参考文档references/review-engine.md6.1 KB
- 参考文档references/reviewer-workflow.md4.1 KB
- 参考文档SKILL.en.md3.9 KB
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 为准。入口只保留以下硬门禁:
- 解析 identity、current series round 和 runtime paths。
- 冻结包含 staged、unstaged、untracked 的完整 scope。
- 执行三个 fresh review layer 并规范 finding。
- 写入模板、重读验证并交接 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
speclite-dev-story
暂无简介
speclite-code-review-01-reviewer
Fixture-owned installed skill entry for the minimal artifact loop.
speclite-skill-lint
只读检查 Skill 定义;用于 lint skill、check skill、检查技能或评估 Skill 规范。区分基础格式、Codex 适配和 SpecLite 约定,报告证据及未检查项;Agent 定义包转交 speclite-agent-lint。
speclite-skill-creator
创建或迭代 SpecLite workflow Skill;用于 create skill、新建技能、生成技能包或封装工作流。设计入口、辅助资源和验证用例;Agent 定义包转交 speclite-agent-creator。
speclite-html-ppt-generator
生成 SpecLite-owned 单文件 HTML PPT。用于用户要求创建 docs presentation、HTML PPT、网页 slides、Swiss Style deck、杂志风 deck,或其他可直接浏览器打开的介绍/分享型 deck。核心能力:使用本 Skill 内置模板、主题、layout 和 validator 生成横向翻页 HTML,并避免依赖外部个人 skill 路径。
speclite-docs-intro-ppt-creator
生成 SpecLite docs 下的介绍型 HTML PPT。用于用户要求把某个项目体系、系统设计、治理机制、理念或工作流总结成 docs presentation、HTML PPT、网页 slides、介绍 deck。核心能力:限定输出目录、基于事实材料规划叙事、调用 speclite-html-ppt-generator 生成单 HTML deck,并用确定性检查和浏览器抽样收口。