蚂蚁社保日志结构化输出改造
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 安装 @mayishebao/mayishebao-1211-0211 技能,以获得规范的结构化日志输出改造链路。
技能介绍
要解决的具体问题
日志结构化输出改造常见的问题是:输出能“跑通”,但无法被稳定检索、回归验证和复盘追溯。字段名口径不一、时间戳格式混乱、错误上下文缺失、日志与代码路径对不上,会让排障、监控告警和交接文档质量下降;如果直接在改造时补全未知语义,还可能写出看起来合理、实际不成立的结构化日志契约。
另一个问题是交付边界模糊。团队经常同时关心代码改动、测试补齐、发布回滚、监控接入和合规约束,但默认把建议当作已验证,把临时方案当作长期结论。这类任务需要先约束输入、证据和验收标准,再进入实施。
技能如何工作
该技能把“日志结构化输出改造”组织成一个材料驱动、可验证的执行闭环。
- 必要输入:业务目标、代码仓库或最小复现、技术栈与版本、运行环境、日志与报错、性能/安全/发布约束、验收标准。
- 信息处理原则:只追问会改变结论或交付物的关键信息;用户提供文件、代码、表格、会话或制度时,先读原始材料再判断。
- 执行流程:
1. 复述可验证目标和验收条件;
2. 复现问题并缩小影响范围;
3. 提出最小可逆变更和备选方案;
4. 补齐单元、集成、性能或安全测试;
5. 说明发布、监控、回滚和交接要求。
- 输出内容:问题定位、证据、方案比较、变更清单、测试用例、发布与回滚步骤、遗留风险;优先使用短段落和表格。
- 方法沉淀:需要更细方法时读取
references/method.md,交付前读取references/quality.md。
适用边界与注意点
适合程序员、测试、运维、数据工程师、技术负责人和产品研发团队在改造日志采集、输出格式、排障记录或发布交接时使用。它不会替用户补造未提供的事实:无法确认的字段语义、测试结果、运行日志或官方结论应保留占位。
事实源优先级为:项目代码、测试和运行日志;语言、框架、数据库、云平台官方文档;适用的国家标准、行业标准、公开漏洞公告。涉及法律、税务、社保、财务、隐私、安全或重大用工决定时,应明确适用地区、主体、日期和待专业复核项。默认示例数据脱敏,不索取或展示密码、令牌、完整身份证号、银行卡号等不必要的敏感信息。
使用场景
- 服务排障需读取日志与报错,按证据定位原因并给出最小可逆变更。
- 团队改造日志字段与时间格式,要补齐回归测试、发布回滚与监控交接。
- 数据管道出现丢字段或重复写入,需保留复现日志并输出变更清单与验证说明。
- 跨环境部署一致性存疑,要对照运行环境与版本信息,输出证据与风险并完成复核。
适合人员
- 后端开发工程师,需要把日志改造成可检索、可回归的结构化输出并补充测试。
- 测试工程师,希望基于运行日志与报错设计可验证用例并推动发布回滚流程。
- 运维工程师,要完善告警规则、发布交接与监控接入方案。
- 数据工程师,需要对账日志和数据管道问题,输出口径统一且可追溯的证据。