higress: Skill for Claude Code

Higress Daily Report

驱动 Higress 社区问题处理的智能工作流。

核心目标

1. 每日感知 - 追踪新 issues/PRs 和评论动态
2. 进度跟踪 - 确保每个 issue 被持续跟进直到关闭
3. 知识沉淀 - 积累问题分析和解决方案，提升处理能力
4. 闭环驱动 - 通过日报推动问题解决，避免遗忘

数据文件

文件	用途
/root/clawd/memory/higress-issue-tracking.json	Issue 追踪状态（评论数、跟进状态）
/root/clawd/memory/higress-knowledge-base.md	知识库：问题模式、解决方案、经验教训
/root/clawd/reports/report_YYYY-MM-DD.md	每日报告存档

工作流程

1. 获取每日数据

# 获取昨日 issues
gh search issues --repo alibaba/higress --created yesterday --json number,title,author,url,body,state,labels --limit 50

# 获取昨日 PRs
gh search prs --repo alibaba/higress --created yesterday --json number,title,author,url,body,state,additions,deletions,reviewDecision --limit 50

2. Issue 追踪状态管理

追踪数据结构 (higress-issue-tracking.json)：

{
  "date": "2026-01-28",
  "issues": [
    {
      "number": 3398,
      "title": "Issue 标题",
      "state": "open",
      "author": "username",
      "url": "https://github.com/...",
      "created_at": "2026-01-27",
      "comment_count": 11,
      "last_comment_by": "johnlanni",
      "last_comment_at": "2026-01-28",
      "follow_up_status": "waiting_user",
      "follow_up_note": "等待用户提供请求日志",
      "priority": "high",
      "category": "cors",
      "solution_ref": "KB-001"
    }
  ]
}

跟进状态枚举：

• new - 新 issue，待分析
• analyzing - 正在分析中
• waiting_user - 等待用户反馈
• waiting_review - 等待 PR review
• in_progress - 修复进行中
• resolved - 已解决（待关闭）
• closed - 已关闭
• wontfix - 不予修复
• stale - 超过 7 天无活动

3. 知识库结构

知识库 (higress-knowledge-base.md) 用于沉淀经验：

# Higress 问题知识库

## 问题模式索引

### 认证与跨域类
- KB-001: OPTIONS 预检请求被认证拦截
- KB-002: CORS 配置不生效

### 路由配置类
- KB-010: 路由状态 address 为空
- KB-011: 服务发现失败

### 部署运维类
- KB-020: Helm 安装问题
- KB-021: 升级兼容性问题

---

## KB-001: OPTIONS 预检请求被认证拦截

**问题特征**：
- 浏览器 OPTIONS 请求返回 401
- 已配置 CORS 和认证插件

**根因分析**：
Higress 插件执行阶段优先级：AUTHN (310) > AUTHZ (340) > STATS
- key-auth 在 AUTHN 阶段执行
- CORS 在 AUTHZ 阶段执行
- OPTIONS 请求先被 key-auth 拦截，CORS 无机会处理

**解决方案**：
1. **推荐**：修改 CORS 插件 stage 从 AUTHZ 改为 AUTHN
2. **Workaround**：创建 OPTIONS 专用路由，不启用认证
3. **Workaround**：使用实例级 CORS 配置

**关联 Issue**：#3398

**学到的经验**：
- 排查跨域问题时，首先确认插件执行顺序
- Higress 阶段优先级由 phase 决定，不是 priority 数值