AGENT SKILL

speclite-code-review-03-fixer

根据 current CR v2 evaluation 执行有界修复或 verify-only 义务。用于用户要求 CR fix、apply review fixes、代码审查修复、verify obligation 或 test-only closure。核心能力:evaluation hash/scope 绑定、patch 与 verify-only 分流、反 churn 和 fresh review 交接。

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

01 前言 Front Matter

name
speclite-code-review-03-fixer
metadata
{ "author": "fancyliu", "catalog": "speclite", "version": "2.1.0" }
description
根据 current CR v2 evaluation 执行有界修复或 verify-only 义务。用于用户要求 CR fix、apply review fixes、代码审查修复、verify obligation 或 test-only closure。核心能力:evaluation hash/scope 绑定、patch 与 verify-only 分流、反 churn 和 fresh review 交接。
allowed-tools
Read, Write, Edit, Bash, Grep, Glob

02 资源文件 3

03 SKILL.md 正文

Speclite Code Review 03 Fixer(代码审查 Fixer)

Overview(概述)

CR01–06 中唯一允许修改源码或测试的环节。它可由 runner 或人工 fresh session 调用,只消费 current speclite.cr-evaluation.v2 明确授权的 patch 或 verify-only obligations。

Activation Boundary(激活边界)

  • 用于执行 evaluator 已接受且已限定范围的修复或验证义务。
  • 不用于自行评估 finding、吸收 deferred/TODO 项、改变需求边界、更新 Story/tracker 或授权 finalizer。

Core Capabilities(核心能力)

  • 授权范围:只消费 current evaluation 明确批准的 obligations。
  • 模式分离:严格分离 production patch 与 verify-only 证据补强。
  • 反复修改防护:识别重复修复、位置迁移与 architecture category。
  • 新鲜度交接:记录 fixRecord,并强制回到 fresh review/evaluation。

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。

Inputs(输入)

  • crDir、compatibilityMode 与 legacyArtifactPaths:由 runner 或人工 orchestrator 通过 speclite resolve cr-directory 解析后传入;缺失时自行调用该 CLI 一次,不得以其他方式推导。
  • Story identity、reviewSeries、current evaluation 和 mode=patch | verify-only。
  • confirmationPolicy、authorizationSource、orchestrationMode 与 handoffTarget;缺失 confirmation policy 时固定为 explicit。

Workflow(工作流)

完整读取并执行 references/fixer-workflow.md:

  1. 绑定 current evaluation/hash/scope/round 与 exact mode。
  2. 生成 included/excluded 修复计划并验证授权来源。
  3. 执行 churn guard、最小修改和 focused verification。
  4. 更新单一 leading frontmatter fixRecord,重读后交接 fresh CR01/CR02。

hash/scope/round 不匹配、授权不完整、已有 completed fixRecord 或 verification 失败时 HALT。Fixer 完成绝不直接授权 finalizer。

Outputs and Handoff(输出与交接)

  • durable output 是 evaluation artifact 中的结构化 fixRecord 及正文 Fix Record。
  • 正常完成时返回 changed files、fingerprints、commands/results、caveats 和下一步 fresh reviewer/evaluator。
  • churn/architecture 命中时返回结构化 route recommendation 给 handoffTarget;人工模式直接交给 manual orchestrator 或用户,不要求 runner 生成裁决。

Notes(注意事项)

  • 禁止修改 Story、tracker、需求边界和未授权文件。
  • verify-only 不得修改 production semantics,也不能降级成 TODO。
  • 无法完成时写 fixRecord.status: blocked,不得声称 completed。
  • 始终使用中文记录,模型、命令和验证结果必须真实。

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