ShellCheck Passed Every File. The Pipeline Was Still Broken.

说明与用途

Linters 只检查单个文件，无法发现跨文件脚本调用错误。script‑chain‑walk 构建依赖图，标记缺失调用和循环，帮助提前发现流水线问题。

问题

Linters only analyze single files, so they miss cross‑file script call failures such as missing or renamed scripts, leading to pipeline failures.

结果

script‑chain‑walk identifies missing script calls and call cycles that linters miss, enabling early detection of pipeline failures.

工作流

• Install script‑chain‑walk via pip
• Run script-chain-walk walk ./scripts to generate a dependency graph
• Review output for broken chains or cycles
• Use --check in CI to exit with error if any issues are found

证据

ShellCheck is great at what it does. So is Pylint. So is every linter you've ever run in CI. They all share one blind spot: they look at one file at a time.

来源

The linter passes. The pipeline runs. And it fails — because cleanup.sh was renamed two sprints ago and nobody updated the caller.

来源

I built that map.

来源

script-chain-walk — a zero-dependency Python CLI (stdlib only, Python ≥ 3.9) that traces cross-file script call chains.

来源

It exits 1 if anything is broken or cyclic — made for CI pipelines and agent guardrails.

来源