gitlink-cli/examples/workflows/community-ops-automation/docs/architecture.md

1.7 KiB
Raw Permalink Blame History

架构说明

本项目采用“Issue 分拣 -> 派单 -> 采集 -> 归一化 -> 分析 -> 生成 -> 发布”的七段式流程。

GitLink 社区运营端到端自动化工作流架构

flowchart LR
    A["issue +list 拉取新 Issue"] --> B["读取自定义 Skill: SKILL.md JSON 规则"]
    B --> C["本地规则匹配: 类型、优先级、标签候选"]
    C --> D["label +list / issue +assigners 解析 ID"]
    D --> E["dry-run 分类与派单计划"]
    E --> F["issue +view 合并人工信息"]
    F --> G["issue +update / issue +comment 写回"]
    G --> H["周报 / Release Notes / 摘要发布"]

设计目标

  • 低门槛:只依赖 gitlink-cli 和 Python 标准库
  • 可复现:同一配置可重复跑出同类报告
  • 可维护:采集、归一化、分析、生成和发布步骤保持清晰边界
  • 可控写回Issue 分类与派单默认 dry-run显式确认后才更新真实 Issue
  • 可验证:报告文件、结构化摘要和 Issue 评论均可作为运行结果核验依据

为什么选这个链路

子赛题三要求使用现有命令或 Skill 组合形成完整解决方案。本方案覆盖:

  1. 新 Issue 自动分类(读取自定义 gitlink-issue-triage-rules Skill 中的 JSON 规则)
  2. 责任人分配计划生成Skill 与配置优先)
  3. 标签、负责人和优先级写回(label +listissue +assignersissue +viewissue +update
  4. 仓库信息采集
  5. Issue 列表采集
  6. PR 列表采集
  7. Release 列表采集
  8. 报告生成
  9. Issue 摘要发布

该链路满足不少于 3 个 CLI 调用的要求,并形成从数据获取到结果发布的端到端闭环。