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
- 最近更新
- 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
- 参考文档CHANGELOG.md2.3 KB
- 参考文档references/fixer-workflow.md3.4 KB
- 参考文档SKILL.en.md3.8 KB
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:
- 绑定 current evaluation/hash/scope/round 与 exact mode。
- 生成 included/excluded 修复计划并验证授权来源。
- 执行 churn guard、最小修改和 focused verification。
- 更新单一 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
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,并用确定性检查和浏览器抽样收口。