Skip to content

KunanonJ/superstacks / plugins/superstacks/skills/pr

Use when writing a PR body.

FileKindSize
CREDITS.mdmarkdown604 B
SKILL.mdskill md5.9 KB
scripts/check_pr_body.pyscript3.5 KB

scripts/check_pr_body.py

View on GitHub
#!/usr/bin/env python3
"""Check a PR body for ticket refs, plan, evidence, and risk/door sections. Stdlib only.

A body with its own line `Class: finder` (a scanner, guard or other change whose job is to
find or refuse things) also needs a ## Review section naming the independent check and probes.
"""

from __future__ import annotations

import argparse
import re
import sys
from pathlib import Path

HEADING_PLAN = re.compile(r"(?im)^#{1,3}\s+Plan\b")
HEADING_EVIDENCE = re.compile(r"(?im)^#{1,3}\s+Evidence\b")
HEADING_RISK = re.compile(r"(?im)^#{1,3}\s+(Merge Danger|Risk)\b")
HEADING_REVIEW = re.compile(r"(?im)^#{1,3}\s+Review\b")
CLASS_FINDER = re.compile(r"(?im)^\s*(?:\*\*)?Class:(?:\*\*)?\s*finder\b")
REFS = re.compile(r"(?i)\bRefs\s+#\d+")
FORBIDDEN_CLOSE = re.compile(r"(?i)\b(Closes|Fixes|Resolves)\s+#\d+")
DOOR = re.compile(r"(?im)(?:\*\*)?Door:(?:\*\*)?\s*(one-way|two-way)\b")
NEXT_HEADING = re.compile(r"(?m)^#{1,3}\s+\S")


def _section_body(text: str, heading: re.Pattern[str]) -> str | None:
    match = heading.search(text)
    if not match:
        return None
    rest = text[match.end() :]
    nxt = NEXT_HEADING.search(rest)
    body = rest[: nxt.start()] if nxt else rest
    return body.strip()


def check(text: str) -> list[str]:
    errors: list[str] = []
    if FORBIDDEN_CLOSE.search(text):
        errors.append("ticket links must be Refs #N; Closes/Fixes/Resolves are not allowed")
    if not REFS.search(text):
        errors.append("missing ticket ref (expected Refs #N)")
    plan = _section_body(text, HEADING_PLAN)
    if plan is None:
        errors.append("missing ## Plan section")
    elif not plan:
        errors.append("## Plan section is empty")
    evidence = _section_body(text, HEADING_EVIDENCE)
    if evidence is None:
        errors.append("missing ## Evidence section")
    elif not evidence:
        errors.append("## Evidence section is empty")
    elif "VERIFY_PASS" not in evidence and "VERIFY_FAIL" not in evidence:
        errors.append("## Evidence must include VERIFY_PASS or VERIFY_FAIL from the verify-loop runner")
    risk = _section_body(text, HEADING_RISK)
    if risk is None:
        errors.append("missing ## Merge Danger or ## Risk section")
    elif not risk:
        errors.append("risk/door section is empty")
    if not DOOR.search(text):
        errors.append("missing Door: one-way or Door: two-way")
    if CLASS_FINDER.search(text):
        review = _section_body(text, HEADING_REVIEW)
        if review is None:
            errors.append("Class: finder needs a ## Review section")
        elif not review:
            errors.append("## Review section is empty")
        else:
            if not re.search(r"(?i)\bindependent\b", review):
                errors.append("## Review must name the independent check (the word 'independent')")
            if not re.search(r"(?i)\bprobes?\b", review):
                errors.append("## Review must list the probes run (the word 'probe')")
    return errors


def main(argv: list[str] | None = None) -> int:
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument(
        "path",
        nargs="?",
        help="PR body file. Reads stdin when omitted.",
    )
    args = parser.parse_args(argv)
    if args.path:
        text = Path(args.path).read_text(encoding="utf-8")
    else:
        text = sys.stdin.read()
    errors = check(text)
    if errors:
        print("PR body check FAIL")
        for item in errors:
            print(f"- {item}")
        return 1
    print("PR body check PASS")
    return 0


if __name__ == "__main__":
    sys.exit(main())
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall