jiazhizhong/higress

Fork 0

mirror of https://github.com/alibaba/higress.git synced 2026-02-06 15:10:54 +08:00

Files

澄潭 da3848c5de feat: add Higress community governance daily report skill for Claude (#3404 )

2026-01-29 10:45:12 +08:00

5.5 KiB

Raw Blame History

Higress 社区治理日报 - Claude Skill

这个 skill 让 AI 助手（如 Claude）能够自动追踪 Higress 项目的 GitHub 活动，并生成结构化的每日社区治理报告。

架构概览

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│    Clawdbot     │────▶│  Claude + Skill │────▶│   GitHub API    │
│   (Gateway)     │     │                 │     │   (gh CLI)      │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                       │
        │                       ▼
        │               ┌─────────────────┐
        │               │  数据文件        │
        │               │  - tracking.json│
        │               │  - knowledge.md │
        │               └─────────────────┘
        │                       │
        ▼                       ▼
┌─────────────────┐     ┌─────────────────┐
│  Discord/Slack  │◀────│    日报输出      │
│   Channel       │     │                 │
└─────────────────┘     └─────────────────┘

什么是 Clawdbot？

Clawdbot 是一个 AI Agent 网关，可以将 Claude 等 AI 模型连接到各种消息平台（Discord、Slack、Telegram 等）和工具（GitHub CLI、浏览器、文件系统等）。

通过 Clawdbot，Claude 可以：

接收来自 Discord 等平台的消息
执行 shell 命令（如 gh CLI）
读写文件
定时执行任务（cron）
将生成的内容发送回消息平台

工作流程

1. 定时触发

通过 Clawdbot 的 cron 功能，每天定时触发日报生成：

# Clawdbot 配置示例
cron:
  - schedule: "0 9 * * *"  # 每天早上 9 点
    task: "生成 Higress 昨日日报并发送到 #issue-pr-notify 频道"

2. Skill 加载

当 Claude 收到生成日报的指令时，会自动加载此 skill（SKILL.md），获取：

数据获取方法（gh CLI 命令）
数据结构定义
日报格式模板
知识库维护规则

3. 数据获取

Claude 使用 GitHub CLI 获取数据：

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

# 获取昨日新建的 PRs  
gh search prs --repo alibaba/higress --created yesterday --json number,title,author,url,body,state

# 获取特定 issue 的评论
gh api repos/alibaba/higress/issues/{number}/comments

4. 状态追踪

Claude 维护一个 JSON 文件追踪每个 issue 的状态：

{
  "issues": [
    {
      "number": 3398,
      "title": "浏览器发起的options请求报401",
      "lastCommentCount": 13,
      "status": "waiting_for_user",
      "waitingFor": "用户验证解决方案"
    }
  ]
}

5. 知识沉淀

当 issue 被解决时，Claude 会将问题模式和解决方案记录到知识库：

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

**问题**: 浏览器 OPTIONS 请求返回 401
**根因**: key-auth 在 AUTHN 阶段执行，先于 CORS
**解决方案**: 为 OPTIONS 请求创建单独路由，不启用认证插件
**关联 Issue**: #3398

6. 日报生成

最终生成结构化日报，包含：

📋 概览统计
📌 新增 Issues
🔀 新增 PRs
🔔 Issue 动态（新评论、已解决）
⏰ 跟进提醒
📚 知识沉淀

7. 消息推送

Claude 通过 Clawdbot 将日报发送到指定的 Discord 频道。

快速开始

前置要求

安装并配置 Clawdbot
配置 GitHub CLI (gh) 并登录
配置消息平台（如 Discord）

配置 Skill

将此 skill 目录复制到 Clawdbot 的 skills 目录：

cp -r .claude/skills/higress-daily-report ~/.clawdbot/skills/

使用方式

手动触发：

@Claude 生成 Higress 昨日日报

定时触发（推荐）： 在 Clawdbot 配置中添加 cron 任务，每天自动生成并推送日报。

文件说明

higress-daily-report/
├── README.md           # 本文件
├── SKILL.md            # Skill 定义（Claude 读取）
└── scripts/
    └── generate-report.sh  # 辅助脚本（可选）

自定义

修改日报格式

编辑 SKILL.md 中的「日报格式」章节。

添加新的追踪维度

在 SKILL.md 的数据结构中添加新字段。

调整知识库规则

修改 SKILL.md 中的「知识沉淀」章节。

示例日报

📊 Higress 项目每日报告 - 2026-01-29

📋 概览
• 新增 Issues: 2 个
• 新增 PRs: 3 个
• 待跟进: 1 个

📌 新增 Issues
• #3399: 网关启动失败问题
  - 作者: user123
  - 标签: bug

🔔 Issue 动态
✅ 已解决
• #3398: OPTIONS 请求 401 问题
  - 知识库: KB-001

⏰ 跟进提醒
🟡 等待反馈
• #3396: 等待用户提供配置信息（2天）

5.5 KiB Raw Blame History Unescape Escape