用途：维护 crawlkit 这一共享 Go 库，用于爬取类应用的归档基础设施，使共享机制保持可复用、可打标签，并对下游应用分支安全。适用于编辑或审查 crawlkit、将通用爬取应用行为下沉到库、检查 gitcrawl、slacrawl、discrawl、notcrawl 能否合并到已发布的 crawlkit 标签、准备或验证 crawlkit Go 模块发布，以及排查共享的 TUI、快照、配置、SQLite、镜像、进度或控制元数据行为。
工作方式：从当前仓库、用户指定路径或配置的工作区根目录定位 crawlkit 检出；在发布或兼容性工作前阅读仓库内的 AGENTS.md、README.md、CONTRIBUTING.md 和 docs/publishing.md；将提供方特定逻辑排除在 crawlkit 之外，共享机制归入 config、store、snapshot、mirror、state、output、progress、tui、cache、control 等包。
库门禁命令（禁用工作区屏蔽）：GOWORK=off go mod tidy；git diff --exit-code -- go.mod go.sum；GOWORK=off go vet ./...；GOWORK=off go test -count=1 ./...。发布检查需验证签名标签与公共 Go 代理：git tag -v <version>；GOPROXY=https://proxy.golang.org GONOSUMDB= go list -m github.com/vincentkoc/crawlkit@<version>。下游就绪检查以只读方式查看应用分支，确认干净、已变基、依赖已发布的 crawlkit 版本，并通过 GOWORK=off go test ./...、<app> --help、<app> --version、<app> metadata --json、<app> status --json、<app> tui --json。CLI 冒烟测试使用临时 HOME、XDG_CONFIG_HOME、XDG_CACHE_HOME，切勿改动线上应用归档。
输入：目标任务（库编辑、发布验证、下游就绪或 TUI 回移）、可选版本标签（如 v0.4.0）、可选下游应用分支路径。输出：干净的 crawlkit 变更或就绪报告、验证命令与结果、下游应用分支的明确兼容性风险；仅在用户要求应用二进制时提供本地二进制重建说明。