AGENT SKILL

speclite-code-review-contract

解析并验证 SpecLite CR v2 共享契约与审查产物。用于用户要求 CR contract、validate CR artifact、检查代码审查契约、验证 review/evaluation/fix/finalizer 绑定或手动编排 CR01–06。核心能力:统一身份与路径、校验 schema/verdict、验证 scope/round/hash/freshness,并提供独立于 runner 的只读契约入口。

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

01 前言 Front Matter

name
speclite-code-review-contract
metadata
{ "author": "fancyliu", "catalog": "speclite", "version": "1.0.0" }
description
解析并验证 SpecLite CR v2 共享契约与审查产物。用于用户要求 CR contract、validate CR artifact、检查代码审查契约、验证 review/evaluation/fix/finalizer 绑定或手动编排 CR01–06。核心能力:统一身份与路径、校验 schema/verdict、验证 scope/round/hash/freshness,并提供独立于 runner 的只读契约入口。
allowed-tools
Read, Bash, Grep, Glob

02 资源文件 3

03 SKILL.md 正文

Speclite Code Review Contract(代码审查共享契约)

Overview(概述)

本 Skill 是 SpecLite CR01–06 与相关 runner 的共享契约 owner。它可在 fresh session 中独立解析并验证 CR v2 identity、路径、artifact schema、verdict、fingerprint、quorum、round binding、freshness 和 closeout 条件,不依赖任何 runner。

本 Skill 只读,不创建 review、evaluation、fix、TODO 或 finalizer artifact,也不修改源码、Story 或 tracker。

Core Capabilities(核心能力)

  • 契约唯一来源:以 references/cr-contract.md 作为 CR v2 唯一规范性定义。
  • 独立运行:支持人工按顺序单独调用 CR01–06,不要求先调用 Epic runner。
  • 结构校验:验证 schema、exact verdict、Story identity、series、round、scope 和 source hash。
  • 时效校验:检查 review、evaluation、fixRecord 与 Flow Gate 的 freshness 关系。
  • Closeout 校验:验证 rules extraction、TODO result 与 finalizer durable report 的 canonical path、schema 和 binding。
  • 只读诊断:输出具体不一致项和下一步,不替代 reviewer、evaluator、fixer 或 finalizer。

Workflow(工作流)

  1. 完整读取 references/cr-contract.md;文件不可读时 HALT。
  2. 运行 speclite resolve config --project-root {project-root},解析 merged planning_artifacts 与 implementation_artifacts;失败时 HALT。
  3. 根据输入建立唯一 storyId -> storyKey -> storyFile;CR 目录只通过 speclite resolve cr-directory 解析(见 references/cr-contract.md 的 CR Directory Resolution),再定位指定或 current CR artifact。
  4. 按共享契约检查 artifact schema、identity、path、series、round、hash、scope、verdict、freshness 与 CR04–06 durable closeout binding。
  5. 输出只读验证结论:VALID | INVALID | INCOMPLETE、逐项证据和精确下一步;不得修改被检查文件。

Notes(注意事项)

  • CR01–06 和 runner 都是本契约的 consumer,不得在各自 package 中复制契约定义。
  • runner/manual 只描述 orchestration source;CR Skill 不得把 runner 当成 scope、authorization、convergence 或 freshness 的唯一 authority。
  • 固定 artifact path 来自本 CR workflow contract;目标项目源码路径只有 owning SPEC 明确要求时才是 hard gate,否则接受有测试或 fixture 证据的 equivalent implementation。
  • SKILL.md 与 references/cr-contract.md 是中文 canonical 内容;字段名、enum、schema id、hash 与命令保留英文。
  • Bash 只可用于只读 resolver、hash 与状态检查,不得执行写入、删除、commit 或 push。
  • 本 Skill 不推进 Story/Epic 状态,不执行 commit 或 push。

Generation Metadata(生成信息)

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

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