How does incremental mode work?

It maintains a YAML state file to track file SHAs and review dates, allowing it to detect which files are new or have changed since the last audit for efficient processing.

Does this skill modify code behavior?

No, Code Spec Backfill has a strict boundary to never modify functional behavior; it only adds or improves documentation, docstrings, and type annotations.

How does it decide which functions need documentation?

It uses a 'misuse scenario' gate, meaning it only acts if it can identify a plausible way a developer might incorrectly use the function based on its current signature.

Is this skill limited to specific programming languages?

No, the skill is language-agnostic and can be applied to any codebase that follows standard documentation and type hint conventions.

What is the No-Tautology Rule?

This rule prevents the AI from writing docstrings that merely restate the function name or parameters as prose, ensuring every added comment provides new, useful information.

Code Spec Backfill

Name: Code Spec Backfill
Author: liza-mas

byliza-mas

•

110

•

学习与文档

Automatically backfills missing function-level docstrings and type annotations using a risk-based misuse heuristic.

Code Spec Backfill is a disciplined documentation agent designed to eliminate contract debt in your codebase. It identifies missing or vague function signatures and intelligently injects docstrings and type hints only when they provide meaningful clarity, strictly avoiding redundant tautologies. By prioritizing files based on a state-driven incremental workflow, it ensures that your API contracts remain fresh as the code evolves. The skill uses a unique 'misuse scenario' gate, ensuring that documentation is only added if it prevents real-world developer errors, while providing detailed reports on ambiguous logic that requires human review.

主要功能

01Detailed reporting of unresolvable logic gaps with plausible failure scenarios.

02Strict no-tautology rule to prevent redundant or low-value documentation.

03Misuse-scenario heuristic ensures documentation adds high-signal value.

04Automatic injection of type annotations and behavioral docstrings.

05110 GitHub stars

06State-driven incremental audits that track file freshness and code changes.

使用场景

01Reducing technical debt in legacy codebases by backfilling missing type hints.

02Maintaining documentation hygiene after large refactors or during PR reviews.

03Onboarding new developers by ensuring public API contracts are clear and behavioral.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add liza-mas/liza code-spec-backfill

For use in Claude.ai and ChatGPT