工具链
cli-tools-logging
更新于 2026-09-10
CLI Tooling · 日志规则
Logging rules for CLI Tooling: structured fields, correlation ids and single-boundary failure logging.
- 技术栈
- CLI Tooling
- 主题
- 日志
- 条目
- 9 条
- 版本
- v0.2.0
✓ 应当这么做
- ✓ Log structured key/value pairs, not interpolated prose
- ✓ Attach a correlation id shared by every hop of one request
- ✓ Log once at the failure boundary, not at every layer it passed through
✕ 常见反模式
- ✕ Logging full payloads that may contain personal data
- ✕ Debug-level spam left enabled in production configuration
- ✕ Log statements as the only signal for a metric-worthy event
◎ 交付前验证
- ◎ Dry-run output reviewed before a real execution
- ◎ Tool version pinned and behaviour re-validated after upgrades
- ◎ Failure path returns a clear diagnostic