mechanical-refactor-verify

Verifies that a scripted transform reproduces a mechanical refactor with an empty diff.

Updated May 30, 2026
One-click install
npx skills add https://github.com/QingHuan-6/SglangGen --skill mechanical-refactor-verify-qinghuan-6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mechanical-refactor-verify
Source: https://github.com/QingHuan-6/SglangGen/tree/main/.claude/skills/mechanical-refactor-verify
Command: npx skills add https://github.com/QingHuan-6/SglangGen --skill mechanical-refactor-verify-qinghuan-6

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reproducibly verifies that mechanical refactor changes can be produced by a scripted transform, ensuring auditable diffs between base and target commits.

Core Features & Use Cases

  • Automates creation of a reproducible transform workflow for file moves, splits, and module extractions.
  • Integrates with git worktrees, pre-commit checks, and diff validation to guarantee reproducibility across contributors.
  • Use case: code review of a PR containing mechanical refactors where deterministic outcomes are required for audit trails.

Quick Start

Run the verification workflow to reproduce the target commit for a mechanical refactor.

Frequently Asked Questions about mechanical-refactor-verify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify a mechanical refactor is reproducible across contributors?

To verify a mechanical refactor is reproducible, you can use a transform-driven workflow that applies a user-provided transform script between a base commit and a target commit. The verification reports PASS only when the resulting diff is empty.

What is a transform-driven workflow for code review?

A transform-driven workflow for code review validates mechanical refactors by ensuring changes like file moves or module extractions can be regenerated by a script. This guarantees deterministic outcomes and auditable diffs for maintenance.

Does pre-commit check verification work with git worktree workflows?

Yes, pre-commit check verification integrates with git worktree workflows to validate mechanical refactors. This setup isolates the reproducible transform execution and diff validation to guarantee auditable outcomes across contributors.

How do I validate file moves and module extractions for auditability?

You validate file moves and module extractions for auditability by running a scripted transform against a base commit. The verification process enforces a transform-driven workflow to ensure the target commit matches the script output.

When do I need to use a scripted transform for mechanical refactoring?

You need to use a scripted transform for mechanical refactoring when a PR review requires deterministic outcomes and strict audit trails. It ensures the diff between the base and target commits can be fully reproduced by the script.