relis-extraction-form-versioning

为ReLiS构建带版本控制与录入流程的类型化提取/分类表单架构。当Claude Code实施管理者表单设计、发布/锁定语义、审核人提交、修订与验证规则时，使用此方法。

SKILL.md

--- frontmatter

name: relis-extraction-form-versioning
description: Build typed extraction/classification form schemas with versioning and entry workflows for ReLiS. Use when Claude Code implements manager form design, publish/lock semantics, reviewer submissions, revisions, and validation rules.

ReLiS Extraction Form Versioning

Objective

Support controlled evolution of extraction schemas while preserving historical entry integrity.

Canonical Inputs

•docs/domain-map.md
•docs/product-scope.md
•extraction parity spec in docs/parity/extraction.md if available

Workflow

•Schema model

•support MVP field types: text/select/multi-select/number/boolean/date
•include required/optional, defaults, and validation constraints

•Version lifecycle

•draft -> published -> locked
•allow new version creation without mutating locked versions

•Entry workflow

•only included papers can receive extraction entries
•draft save, submit, validate states
•revision metadata for post-validation edits

•Validation

•type-safe payload validation
•field-level error reporting

•Traceability

•record who changed schema and when
•record who submitted/validated entry and when

Required Outputs

•schema and entry domain models
•form publish/lock APIs
•entry submit/revise APIs
•UI forms bound to typed schema
•tests for version integrity and validation

Guardrails

•Never mutate previously published schema versions in place.
•Never drop historical entry records on schema upgrades.
•Never allow extraction on excluded papers.

Done Criteria

•Manager can publish a form version.
•Reviewer can complete entry for included paper.
•Historical entries remain readable after new schema version release.