feat(skills): add gitlink-community-ops（社区运营自动化：新Issue自动分类→分配责任人→定期社区周报→自动发布Release Notes）
新增端到端编排型 Agent Skill，串联多个 gitlink-cli 命令完成完整自动化场景（≥3 命令/Skill 调用）。 遵循 skills 规范（SKILL.md + frontmatter），兼容 Claude Code 等 Agent 平台。 来源：GitLink 大赛 2026 子任务三（端到端自动化工作流）。
This commit is contained in:
wyxfzgg
parent
9749a4c832
commit
e3b349464c
|
|
@ -0,0 +1,148 @@
|
|||
---
|
||||
name: gitlink-community-ops
|
||||
version: 1.0.0
|
||||
description: "社区运营端到端自动化编排：当用户需要批量处理新 Issue 分类分配、定期生成社区周报、或发布 Release Notes 时，编排多个子 Skill 完成 Issue 分诊 → 通知汇总 → 周报撰写 → Release 发布的全流程。"
|
||||
metadata:
|
||||
requires:
|
||||
bins: ["gitlink-cli"]
|
||||
orchestrates:
|
||||
- gitlink-issue-triage
|
||||
- gitlink-notification-digest
|
||||
- gitlink-contributor-insight
|
||||
- gitlink-release-auto
|
||||
- gitlink-release-notes
|
||||
cliHelp: "gitlink-cli --help"
|
||||
---
|
||||
|
||||
# gitlink-community-ops（社区运营自动化编排）
|
||||
|
||||
**CRITICAL — 开始前必须先阅读 [`../gitlink-shared/SKILL.md`](../gitlink-shared/SKILL.md)，认证/权限/API 注意事项。**
|
||||
**CRITICAL — 所有写入/删除操作（series-update、release create、issue comment）前，务必先确认用户意图。**
|
||||
**CRITICAL — GitLink 操作只能用 gitlink-cli。禁止用 gh（GitHub CLI）操作 GitLink 资源。**
|
||||
**CRITICAL — 本编排型 Skill 只做"导演"，指挥子 Skill 与 CLI 命令的执行顺序，不重写子 Skill 的内部逻辑。**
|
||||
|
||||
---
|
||||
|
||||
## 工作流总览
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A[用户触发] --> M{意图判断}
|
||||
M -->|全流程| S1
|
||||
M -->|仅分类| S2
|
||||
M -->|仅周报| S1b
|
||||
M -->|仅Release| S5
|
||||
S1[Step1 数据采集<br/>issue+list / export+contributors] --> S2
|
||||
S1b[Step1 数据采集<br/>export+issues / +contributors] --> S3
|
||||
S2[Step2 🤖AI分类+分配<br/>issue-triage + workflow+triage<br/>issue+series-update] --> S3
|
||||
S3[Step3 🤖AI通知汇总<br/>notification-digest<br/>contributor-insight] --> S4
|
||||
S4[Step4 🤖AI写周报<br/>WEEKLY-REPORT.md] --> S5{有可发版本?}
|
||||
S5 -->|是| S6[Step5 🤖AI生成Notes<br/>release-notes + release+create]
|
||||
S5 -->|否| END
|
||||
S6 --> END[输出执行清单]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 编排的子 Skill
|
||||
|
||||
| 子 Skill | 职责 | 调用时机 |
|
||||
|---|---|---|
|
||||
| gitlink-issue-triage | Issue 自动分类、打标签、判断优先级与责任人 | Step2：新 Issue 分诊 |
|
||||
| gitlink-notification-digest | 聚合近期通知、未读消息、待办提醒 | Step3：周报素材 |
|
||||
| gitlink-contributor-insight | 贡献者活跃度、新贡献者识别 | Step3：周报人物板块 |
|
||||
| gitlink-release-auto | 拉取合并 PR、组装 Release 候选 | Step5：发版前置 |
|
||||
| gitlink-release-notes | 生成 Release Notes 文案 | Step5：release+create 内容 |
|
||||
|
||||
---
|
||||
|
||||
## 详细步骤
|
||||
|
||||
### Step 1: 数据采集（纯命令）
|
||||
|
||||
- 命令：
|
||||
- `gitlink-cli issue +list --owner <owner> --repo <repo> --state open --limit 50 --format json` — 拉取开放 Issue
|
||||
- `gitlink-cli export +contributors --owner <owner> --repo <repo> --format json --output contributors.json` — 导出贡献者
|
||||
- `gitlink-cli export +issues --owner <owner> --repo <repo> --state all --format json --output issues.json` — 导出全部 Issue 供分析
|
||||
- 🤖AI 判断点：解析 Issue 列表，识别「无标签 / 无 assignee / 长期未更新」三类待处理 Issue，作为 Step2 输入；仓库为空或解析失败时告知用户并停止。
|
||||
- 本步全部只读，无需确认。
|
||||
|
||||
### Step 2: Issue 自动分类与分配（🤖AI 判断点 + 写入命令）
|
||||
|
||||
- 调子 Skill：`gitlink-issue-triage`
|
||||
- 纯命令前置（拉取可用元数据）：
|
||||
- `gitlink-cli workflow +triage --owner <owner> --repo <repo> --state open --limit 50 --lang zh-CN --format json` — 内置分诊规则给初步分类
|
||||
- `gitlink-cli issue +priorities --owner <owner> --repo <repo>` — 仓库可用优先级
|
||||
- `gitlink-cli issue +tags --owner <owner> --repo <repo>` — 仓库可用标签
|
||||
- `gitlink-cli issue +assigners --owner <owner> --repo <repo>` — 可分配人员
|
||||
- 🤖AI 判断点：对每个待处理 Issue，结合 title/body 与贡献者擅长领域，决定优先级、标签、责任人，组装批量参数。
|
||||
- ⚠️写入命令（执行前必须回显方案给用户确认）：
|
||||
- `gitlink-cli issue +series-update --owner <owner> --repo <repo> --ids <id1,id2,id3> --status open` — 批量更新状态
|
||||
- 确认话术："共 N 条 Issue，预计修改状态/责任人，是否执行？"
|
||||
|
||||
### Step 3: 社区动态汇总（🤖AI 判断点）
|
||||
|
||||
- 调子 Skill：`gitlink-notification-digest`、`gitlink-contributor-insight`
|
||||
- 纯命令：
|
||||
- `gitlink-cli notification +list --limit 50 --format json` — 拉取通知（默认未读）
|
||||
- `gitlink-cli repo +activity --owner <owner> --repo <repo>` — 仓库活跃曲线
|
||||
- `gitlink-cli user +heatmap --login <owner>` — 贡献热力图
|
||||
- `gitlink-cli user +stats --login <owner>` — 统计数据
|
||||
- 🤖AI 判断点：
|
||||
- 通知去重归类（PR / Issue / Release / CI），提炼本周待办。
|
||||
- 识别「本周新晋贡献者」「Top 活跃」「需感谢的人」。
|
||||
- 输出结构化中间结果供 Step4 引用。
|
||||
|
||||
### Step 4: 撰写社区周报（🤖AI 判断点）
|
||||
|
||||
- 🤖AI 判断点：汇总 Step1-3 结构化结果，按以下板块撰写 `WEEKLY-REPORT.md`：
|
||||
1. 本周数据概览（新增 Issue N / 合并 PR M / 新贡献者 K）
|
||||
2. 重点 Issue 进展
|
||||
3. 贡献者榜单
|
||||
4. 待跟进事项
|
||||
5. 下周计划
|
||||
- 落地：工作目录生成 `WEEKLY-REPORT.md`（落盘前向用户展示大纲）。
|
||||
- 可选纯命令：`gitlink-cli pm +weekly --project <project_id>` — 补充官方周报数据（需项目 ID）。
|
||||
|
||||
### Step 5: Release 候选与发布（🤖AI 判断点 + 写入命令）
|
||||
|
||||
- 调子 Skill：`gitlink-release-auto`、`gitlink-release-notes`
|
||||
- 纯命令（采集发版素材）：
|
||||
- `gitlink-cli repo +tags --owner <owner> --repo <repo>` — 最近 tag，确定发版起点
|
||||
- `gitlink-cli repo +commits --owner <owner> --repo <repo>` — 自上 tag 以来提交
|
||||
- `gitlink-cli pr +list --owner <owner> --repo <repo> --state closed --limit 50` — 近期 PR（从中筛选已合并）
|
||||
- `gitlink-cli repo +compare --owner <owner> --repo <repo> --base <last_tag> --head master` — 完整 diff 摘要
|
||||
- 🤖AI 判断点：
|
||||
- 判断变更是否值得发版（仅文档微调则建议跳过）。
|
||||
- 按 conventional commits（feat/fix/perf/docs）分组，识别 BREAKING CHANGE。
|
||||
- 生成 Release Notes 正文，让用户确认版本号（major/minor/patch）。
|
||||
- ⚠️写入命令（发布前回显 tag、标题、正文预览）：
|
||||
- `gitlink-cli release +list --owner <owner> --repo <repo>` — 确认 tag 未被占用
|
||||
- `gitlink-cli release +create --owner <owner> --repo <repo> --tag <version> --name "<version>" --body "<Release Notes>" --target master`
|
||||
|
||||
---
|
||||
|
||||
## 触发模式（可裁剪）
|
||||
|
||||
本 Skill 支持全流程与单点触发：
|
||||
- **全流程**："跑一遍社区运营" → Step1→5
|
||||
- **仅 Issue 分类**："把今天的新 Issue 分一下" → Step1→2
|
||||
- **仅周报**："出本周社区周报" → Step1→3→4
|
||||
- **仅 Release**："发个 v1.2.0" → Step5
|
||||
|
||||
Agent 第一步先与用户确认走哪种模式，避免多余写入。
|
||||
|
||||
---
|
||||
|
||||
## Agent 触发示例
|
||||
|
||||
**用户**："把 gitlink-cli-demo 这周的社区运营跑一遍，顺便发个新版本。"
|
||||
|
||||
**Agent**：
|
||||
1. 确认 owner=jiangtx、repo=gitlink-cli-demo，版本号意向 → 全流程模式。
|
||||
2. Step1（纯命令）：`issue +list --state open`、`export +contributors`、`export +issues`，解析出 12 条待分类 Issue。
|
||||
3. Step2（AI + 命令）：`workflow +triage` + `issue +priorities/tags/assigners`，给出分类与责任人方案 → 回显 → 用户确认 → `issue +series-update` 落地。
|
||||
4. Step3（AI + 命令）：`notification +list`、`repo +activity`、`user +heatmap` + contributor-insight，产出中间结果。
|
||||
5. Step4（AI）：撰写 `WEEKLY-REPORT.md`，展示大纲 → 确认 → 落盘。
|
||||
6. Step5（AI + 命令）：`repo +tags`、`pr +list --state closed`、`repo +compare`，识别 8 个合并 PR，判定值得发版 → 调 release-notes 生成正文 → 用户确认 v1.4.0 → `release +create` 发布。
|
||||
7. 输出执行清单：分诊 12 条、周报路径、Release URL。
|
||||
Loading…
Reference in New Issue