日志错误处理

📌 Skill基础信息

Skill名称：logging-error-handling（结构化错误处理与日志记录）

简称：日志错误处理

来源：社区第三方（machenjie/rd-skills）

运行宿主：task-agent/review-agent（基于 MCP 协议的 Agent 工具）

核心定位：为分布式系统提供结构化错误处理框架，解决日志关联性、敏感信息脱敏、错误传播和诊断安全问题，适合需要严格审计追踪和错误管理的企业级应用场景。

🧩 内部核心组成

本 Skill 采用规则驱动架构，不包含传统子Agent或斜杠命令，而是通过以下核心组件提供能力：

核心规则体系：

• 错误所有权与外部语义定义规则
• 诊断事件记录规范
• 跨层关联性保持机制
• 终端结果分类标准
• 敏感信息最小化处理策略
• 日志量级与基数控制规则
• 诊断记录与审计记录分离原则

参考资源类型：

资源类型	功能简述
benchmark-pattern	提供日志方案和错误映射的基准对比
decision-checklist	错误分类和审计变更的决策检查清单
evidence-pattern	验证脱敏和关联声明的证据模式

目录结构：

references/
  ├── benchmarks-and-patterns.md    # 基准模式参考
  ├── checklist.md                  # 决策检查清单
  └── evidence-patterns.md          # 证据模式规范

🛠 安装与启用方式

安装命令：

skills install --user machenjie/rd-skills

前置依赖：

• 支持 MCP 协议的 Agent 运行环境（task-agent/review-agent）
• 已配置的日志收集基础设施

启用方式：

在 task-agent 或 review-agent 中通过技能注册机制加载，当检测到结构化错误处理需求时自动触发。

📋 标准工作流

1. 需求触发：当系统涉及错误处理、日志结构、关联性或诊断安全变更时，Agent 自动加载本 Skill
2. 规则评估：依次应用7条高价值规则进行现状评估
3. 参考资源调用：根据具体需求加载对应的参考模式文件
4. 决策输出：生成包含所有权定义、外部语义、诊断事件等要素的决策方案
5. 风险标识：输出未验证路径、证明限制和残余风险说明
6. 审计交接：对安全相关结果进行专门交接，不声称完整的审计记录闭包

⚠️ 关键限制、缺陷、注意事项

平台限制：

• 仅适用于支持 MCP 协议的 task-agent/review-agent 环境
• 需要现有的日志基础设施支持

适用性限制：

• 不适合简单的应用场景或无分布式追踪需求的单体应用
• 不处理受保护审计记录的完整性、保留期、访问控制等底层安全问题
• 当错误所有权模糊或关联性无法建立时应升级处理

生产环境适用性：

• 可用于生产环境，但需要配合完整的安全审计体系
• 需要预先定义清晰的敏感字段处理策略
• 热路径日志量级需要有明确的边界控制

✅ 适用场景 & ❌ 不适合场景

✅ 适用场景：

• 企业级分布式系统需要结构化错误处理
• 涉及多租户数据隔离和敏感信息处理的场景
• 需要跨层保持因果上下文和关联性的微服务架构
• 有严格合规要求的金融、医疗等行业应用
• 需要准确分类终端结果和重构失败场景的关键业务

❌ 不适合场景：

• 简单的单体应用或无日志策略变更需求的项目
• 无安全审计要求的个人或小规模项目
• 现有的日志策略已能满足字段选择和客户端契约的情况
• 不需要任务本地日志错误处理决策的场景

skills install --user machenjie/rd-skills