Keitark/pcba-design-skills / .agents/skills/release-pcba-fabrication
release-pcba-fabrication
VerifiedBuild and verify a vendor-neutral PCB/PCBA manufacturing release from one frozen design revision. Use when generating or auditing Gerber, drill, IPC-2581/ODB++, BOM, CPL/pick-and-place, assembly drawings, constraints, renders, DFM evidence, hashes, or release manifests, and when preventing mixed-revision fabrication or assembly uploads.
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 1.0 KB |
| SKILL.md | skill md | 3.2 KB |
| agents/openai.yaml | config | 246 B |
| assets/release-manifest.example.json | config | 342 B |
| references/eda-release-adapters.md | markdown | 1.1 KB |
| references/release-checklist.md | markdown | 2.9 KB |
| scripts/build_release_manifest.py | script | 4.7 KB |
| scripts/validate_release_manifest.py | script | 7.2 KB |
scripts/build_release_manifest.py
View on GitHub#!/usr/bin/env python3
"""Build a revision-consistent pcba-release-manifest-v1 file."""
from __future__ import annotations
import argparse
import datetime as dt
import hashlib
import json
import os
from pathlib import Path
from validate_release_manifest import APPROVALS, contract_errors
def pairs(values: list[str], label: str) -> dict[str, str]:
result: dict[str, str] = {}
for value in values:
if "=" not in value:
raise SystemExit(f"{label} must use KEY=VALUE: {value}")
key, item = value.split("=", 1)
if not key or key in result:
raise SystemExit(f"invalid or duplicate {label} key: {key}")
result[key] = item
return result
def scalar(value: str):
lowered = value.lower()
if lowered in {"true", "false"}:
return lowered == "true"
if lowered in {"null", "none"}:
return None
try:
return int(value)
except ValueError:
try:
return float(value)
except ValueError:
return value
def sha256(path: Path) -> str:
digest = hashlib.sha256()
with path.open("rb") as handle:
for block in iter(lambda: handle.read(1024 * 1024), b""):
digest.update(block)
return digest.hexdigest().upper()
def main() -> int:
parser = argparse.ArgumentParser()
parser.add_argument("--output", type=Path, default=Path(".pcba-workflow/release-manifest.json"))
parser.add_argument("--release", required=True)
parser.add_argument("--revision", required=True)
parser.add_argument("--status", choices=("PASS", "BLOCKED", "USER_REVIEW"), default="BLOCKED")
parser.add_argument("--artifact", action="append", default=[], metavar="ROLE=PATH")
parser.add_argument("--artifact-revision", action="append", default=[], metavar="ROLE=REVISION")
parser.add_argument("--constraint", action="append", default=[], metavar="KEY=VALUE")
parser.add_argument("--verification", action="append", default=[], metavar="KEY=VALUE")
parser.add_argument("--approval", action="append", default=[], metavar="NAME=STATUS")
parser.add_argument("--approval-evidence", action="append", default=[], metavar="NAME=EVIDENCE")
args = parser.parse_args()
artifact_paths = pairs(args.artifact, "artifact")
artifact_revisions = pairs(args.artifact_revision, "artifact revision")
if not artifact_paths:
raise SystemExit("at least one --artifact is required")
if set(artifact_paths) != set(artifact_revisions):
raise SystemExit("every artifact needs exactly one --artifact-revision")
mismatched = {role: rev for role, rev in artifact_revisions.items() if rev != args.revision}
if mismatched:
raise SystemExit(f"mixed artifact revisions: {mismatched}")
base = args.output.parent.resolve()
artifacts: dict[str, dict] = {}
for role, raw_path in artifact_paths.items():
path = Path(raw_path).resolve()
if not path.is_file():
raise SystemExit(f"artifact not found: {role}={path}")
stored = Path(os.path.relpath(path, base)).as_posix()
artifacts[role] = {
"path": stored, "revision": artifact_revisions[role],
"size_bytes": path.stat().st_size, "sha256": sha256(path),
}
approval_values = pairs(args.approval, "approval")
approval_evidence = pairs(args.approval_evidence, "approval evidence")
unknown_approvals = (set(approval_values) | set(approval_evidence)) - set(APPROVALS)
if unknown_approvals:
raise SystemExit(f"unknown approvals: {sorted(unknown_approvals)}")
approvals = {name: approval_values.get(name, "PENDING") for name in APPROVALS}
evidence = {name: [approval_evidence[name]] if name in approval_evidence else [] for name in APPROVALS}
manifest = {
"schema": "pcba-release-manifest-v1",
"release": args.release,
"revision": args.revision,
"generated_at": dt.datetime.now(dt.timezone.utc).isoformat(),
"status": args.status,
"artifacts": artifacts,
"constraints": {key: scalar(value) for key, value in pairs(args.constraint, "constraint").items()},
"verification": {key: scalar(value) for key, value in pairs(args.verification, "verification").items()},
"approvals": approvals,
"approval_evidence": evidence,
}
errors = contract_errors(manifest)
if errors:
raise SystemExit("release manifest contract failed: " + "; ".join(errors))
args.output.parent.mkdir(parents=True, exist_ok=True)
args.output.write_text(json.dumps(manifest, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
print(json.dumps({"status": "PASS", "manifest": str(args.output), "artifacts": len(artifacts)}, indent=2))
return 0
if __name__ == "__main__":
raise SystemExit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |