Nexus: Skill for Claude Code

Skill：defect-aggregation（缺陷聚合）

1. 业务用途

将来自多个渠道（Issue 工单、错误日志、用户反馈、监控告警）的缺陷信息聚合为规范缺陷看板：自动相似度去重（重复上报合并，保留来源证据），按严重级别定级，为 RCA 提供干净、无冗余的输入。对应 8 步闭环的"任务输入"环节。

2. 输入输出 Schema

输入：

{ title: string, description?: string, source: "issue"|"log"|"user_feedback"|"alert"|"manual",
  severity?: "critical"|"high"|"medium"|"low", dedup_threshold?: number (0-1，默认 0.6) }

输出（ingest_defect）：

{ defect_id: string, merged: boolean,
  merged_into?: string,   // merged=true 时：被合并到的规范缺陷 ID
  similarity?: number }   // 与规范缺陷的相似度

输出（分诊结论消息）：

{ 缺陷清单: Array<{ defect_id, title, severity, merged }>,
  建议: { 待处理缺陷数, 优先级排序 } }

3. 调用触发条件

• manager 创建"缺陷聚合"任务（分配给我）
• 新增 issue/日志/告警需要入库（可直接调用）

4. 依赖工具

工具	用途
ingest_defect	多源录入 + 相似度去重（Jaccard 归一化相似度 ≥ 阈值自动合并）
list_defects	缺陷看板查询（含按 status/severity/source 过滤）
update_defect	定级分诊（status=triaged）、后续环节回写（rca_task_id/fix_task_id）
claim_task / update_task / wait_for_work	任务生命周期（基础设施）

5. 失败重试 / 降级机制

• 录入字段缺失（无 title）→ 拒绝并报告来源，跳过该条
• 去重误判（merged 但实为不同缺陷）→ 用 ingest_defect(dedup_threshold=0) 强制新建，并报告 manager
• 去重算法为确定性 Jaccard 相似度，无外部依赖；生产可升级 embedding 向量去重（接口不变）
• 降级：聚合服务不可用时直接以任务 description 作为缺陷录入依据

6. 安全权限边界

• ✅ 允许：ingest_defect / list_defects / update_defect（仅限定级与关联回写）
• ❌ 禁止：创建/认领非聚合类任务、审批操作、发布操作、直接修改他人缺陷的 severity 之外字段
• ⚠️ 缺陷内容可能含用户敏感信息（日志摘录），消息中只传摘要与 ID，不传全文

7. 多场景复用价值

• 缺陷聚合（本场景：研发缺陷）
• 告警降噪（监控告警去重合并 — 零人工运维方向）
• 客服工单聚合（多渠道工单去重分级 — 智能客服方向）
• 金融风控信号聚合（风险信号去重降噪）

8. 与多 Agent 协作链路

devflow-manager ──聚合任务──▶ triage-agent ──分诊结论──▶ devflow-manager ──RCA 任务──▶ rca-agent

只与 manager 通信；产出（缺陷看板 + 分诊结论）是后续所有环节的输入真相源。