Python Logging 技能:为批处理输出可核对的 JSONL
EnglishClaude Code 安装步骤
- 从 GitHub 固定提交获取完整的 `plugins/devops-tools/skills/python-logging-best-practices` 目录。
- 复制到目标项目的 `.claude/skills/`,确认 `.claude/skills/python-logging-best-practices/SKILL.md`,再从项目根目录启动 Claude Code,输入 `/python-logging-best-practices`。
中文摘要
用 Claude Code 设计 Python 运行日志字段,让一次作业的开始、进度和结束可按 run_id 查询。
SKILL.md 中文导读
可复现示例
运行 4 行的本地商品导入,预设一行无效。按相同 run_id 写 started、skipped、completed,结束事件记录 imported=3、skipped=1。工作步骤
- 定义 run_id、event、level 与必要计数。每个事件写一行 JSON,实际输入内容单独保留在本地文件。
- 用测试解析各行,确认作业结束记录能对照输入、成功和跳过数量。
验收方法
日志可以逐行解析并按 run_id 聚合。汇总能复核 3 条导入和 1 条跳过。
GitHub 原文 · 更新日期
适用环境
准备自己的 Python 批处理脚本和合成 CSV。可以用标准库 logging 与 json 格式化日志。
常见问题
如何同时满足命令行阅读和程序查询?
保留稳定 JSON 字段供程序读取,并在终端或查看工具按需格式化。