forked from ylly/gitlink-cli
Compare commits
No commits in common. "master" and "v0.2.0-beta.1" have entirely different histories.
master
...
v0.2.0-bet
12
README.md
12
README.md
|
|
@ -617,12 +617,8 @@ See [skills/gitlink-shared/REFERENCE.md](skills/gitlink-shared/REFERENCE.md).
|
|||
## License
|
||||
|
||||
[MulanPSL-2.0](https://license.coscl.org.cn/MulanPSL2)
|
||||
# p i p e l i n e t e s t
|
||||
|
||||
## ZxR 测试PR
|
||||
|
||||
> GitLink智能运营平台——代码质量看门人工作流演示。
|
||||
|
||||
<!-- 代码质量看门人自动化工作流：添加此注释用于测试 PR 审查流程 -->
|
||||
# p i p e l i n e t e s t
|
||||
|
||||
## ZxR 测试PR
|
||||
|
||||
<!-- 代码质量看门人测试注释 -->
|
||||
> GitLink智能运营平台——代码质量看门人工作流演示。
|
||||
|
|
|
|||
|
|
@ -1,108 +0,0 @@
|
|||
# 工作流 ① 社区运营自动化 — 执行报告
|
||||
|
||||
> 任务三 zhangqing 分担工作流 · 端到端串联 issue-triage + insight + release-auto
|
||||
> 执行时间：2026-06-29 · 目标仓库：ylly/gitlink-cli
|
||||
|
||||
---
|
||||
|
||||
## 工作流目标
|
||||
|
||||
新 Issue 进入仓库后，自动完成：**分类 → 分配 → 周报 → 发版**，形成社区运营闭环。
|
||||
|
||||
## 四步执行记录
|
||||
|
||||
### 步骤 1：Issue 智能分类 ✅
|
||||
|
||||
调用 `gitlink-issue-triage` Skill 扫描 16 个开放 Issue，识别 11 个未分类，按仓库现有中文标签全部分类：
|
||||
|
||||
| Issue | 标题 | 标签 |
|
||||
|-------|------|------|
|
||||
| #1-#6 | 测试类 | 测试 |
|
||||
| #10 | bug | 缺陷 |
|
||||
| #11 | 功能完善 | 功能 |
|
||||
| #12 | 疑问 | 疑问 |
|
||||
| #15 | issue+list 响应慢 | 性能 |
|
||||
| #16 | 希望搜索按 star 排序 | 功能 |
|
||||
|
||||
验证：重新 `issue +list`，未分类 = 0。
|
||||
|
||||
### 步骤 2：责任人分配 ⏭ 跳过（平台限制）
|
||||
|
||||
`issue +assigners` 返回空数组（total_count: 0），即便 `zhangqing23` 已是 Manager 也不在候选列表内。Raw API PATCH `/v1/.../issues/16` 带 `assigned_to_id` 返回 ok 但 assigners 仍为 `[]`。
|
||||
|
||||
**结论**：GitLink 个人仓库的 assigners 机制对 Manager 角色不开放，跳过此步并在报告中标注。
|
||||
|
||||
### 步骤 3：社区周报生成 ✅
|
||||
|
||||
`gitlink-insight` Skill 综合采集：open/closed issue / pr / release / repo info。
|
||||
|
||||
关键数据：
|
||||
- 开放 Issue 16 / 已关闭 6 / 合并 PR 2 / 开放 PR 0 / Release **0**（本工作流前）
|
||||
- 标签分布：测试 6 / 缺陷 3 / 文档 3 / good first 3 / 功能 2 / 性能 1 / 疑问 1
|
||||
- Issue 作者：@ylly 14, @ZxR123-Z 2
|
||||
- 风险观察：仓库尚未发布任何 Release；测试类 Issue 6 个可清理
|
||||
|
||||
### 步骤 4：自动发版 ✅
|
||||
|
||||
调用 `gitlink-release-auto` Skill：
|
||||
|
||||
1. 版本号推荐：v0.1.18 之后提交分类为 feat 26 / fix 17 / docs 7 / test 4 / refactor 3 → 按 Semver 推荐升 MINOR
|
||||
2. Release Notes 自动生成（按 Conventional Commits 分类组织，贡献者去重）
|
||||
3. 用 `release +create` 的底层 endpoint（POST /releases）+ `--body-file` 绕开 Windows 中文编码坑
|
||||
4. 发布 **v0.2.0-beta.1**（预发布版本，等任务三全部完工后由整合者发正式 v0.2.0）
|
||||
|
||||
**产出**：
|
||||
- version_id: 2218
|
||||
- tag: v0.2.0-beta.1
|
||||
- URL: https://gitlink.org.cn/ylly/gitlink-cli/releases
|
||||
- name: `v0.2.0 Beta 1 — 任务三阶段版（预发布）`
|
||||
|
||||
## 任务二 Skill 蓝图对照（按 SKILL.md 行号）
|
||||
|
||||
本工作流每一步都严格按任务二 Skill 蓝图执行，Skill 是**设计蓝图**，本报告是蓝图的**落地执行**。
|
||||
|
||||
### 步骤 1 ← `gitlink-issue-triage/SKILL.md` 工作流 1（自动分类打标签）
|
||||
|
||||
| 执行动作 | SKILL.md 蓝图位置 | 蓝图要求 | 实际执行 |
|
||||
|---------|------------------|---------|---------|
|
||||
| 拉开放 Issue | 第 58-62 行 Step 1 | `issue +list --state open` | ✅ 拉到 16 个 |
|
||||
| 筛未分类 | 第 64-68 行 Step 2 | 过滤 `tags=[]` | ✅ 11 个未分类 |
|
||||
| 读详情分类 | 第 70-78 行 Step 3-4 | 标题+描述语义分类 | ✅ 按中文标签语义归类 |
|
||||
| 复用现有标签 | 第 80-91 行 Step 5 | **优先复用仓库已有中文标签** | ✅ 直接复用「测试/缺陷/功能/性能/疑问」未新建 |
|
||||
| 打标签 | 第 93-99 行 Step 6 | `issue +update --label`（覆盖语义） | ✅ 11 个全部分类完成 |
|
||||
| 输出报告 | 第 101-117 行 Step 7 | 表格汇总 | ✅ 见本报告步骤 1 表格 |
|
||||
|
||||
**关键决策对照**：SKILL.md 第 91 行明确说"优先复用现有标签（含中文同义词），先匹配再考虑新建英文标签"。本仓库已有「缺陷/功能/文档」等中文标签，**未新建任何英文标签**，完全符合蓝图。
|
||||
|
||||
### 步骤 2 ← `gitlink-issue-triage/SKILL.md` 工作流 2（自动分配 + 通知）
|
||||
|
||||
SKILL.md 第 125-146 行 Step 1-2 已**预判**此场景：个人仓库 `assigners` 返回空数组（第 133 行红框警告），按第 146 行"列表为空则跳过分配并在报告中标注"处理。✅ 实际执行与蓝图预判一致，跳过并在报告标注。
|
||||
|
||||
### 步骤 3 ← `gitlink-insight/SKILL.md` 工作流 2（Sprint 周报）
|
||||
|
||||
| 执行动作 | SKILL.md 蓝图位置 | 蓝图要求 | 实际执行 |
|
||||
|---------|------------------|---------|---------|
|
||||
| 采集 Issue 数据 | 第 120-122 行 | closed + open issue | ✅ 16 open / 6 closed |
|
||||
| 采集 PR 数据 | 第 123-125 行 | merged PR | ✅ 2 merged |
|
||||
| 采集 Release | 第 126-128 行 | `release +list` | ✅ Release=0（发版前） |
|
||||
| 风险标注 | 第 164-165 行 | 列风险与阻塞 | ✅ 标注"未发布 Release""测试类 Issue 可清理" |
|
||||
|
||||
### 步骤 4 ← `gitlink-release-auto/SKILL.md`
|
||||
|
||||
| 执行动作 | SKILL.md 蓝图位置 | 蓝图要求 | 实际执行 |
|
||||
|---------|------------------|---------|---------|
|
||||
| 版本号推荐 | 第 32-90 行 一、版本号推荐 | 按 Conventional Commits 分类推 Semver | ✅ feat 26/fix 17 → MINOR 升 → v0.2.0 |
|
||||
| Release Notes 生成 | 第 94-145 行 二、自动生成 | 按类型分组 + 贡献者去重 | ✅ 按 Conventional Commits 分组，贡献者去重 |
|
||||
| 预发布版本 | 第 179-189 行 三、预发布版本 | `--prerelease true` | ✅ 选 beta.1 预发布（等整合者发正式 v0.2.0） |
|
||||
| 贡献者去重 | 第 145 行红框警告 | **必须去重** | ✅ 跨提交去重为 14 人 |
|
||||
|
||||
**3 个 Skill 串联，满足 PDF「≥3 命令/Skill 串联」要求。**
|
||||
|
||||
## 关键避坑（本工作流踩到的）
|
||||
|
||||
| 坑 | 解决 |
|
||||
|----|------|
|
||||
| `release +create` 无 `--body-file` 参数，`--body` 传多行中文必乱码 | 改用 `api POST /owner/repo/releases --body-file payload.json` |
|
||||
| GitLink API 路径双轨制 | release 用 `/owner/repo/...` 即可 |
|
||||
| `assigners` 在个人仓库对 Manager 不开放 | 平台限制，报告中标注跳过 |
|
||||
| Windows Git Bash 拼 JSON 中文乱码 | 全部用 `--body-file <UTF-8文件>` + `MSYS_NO_PATHCONV=1` |
|
||||
|
|
@ -1,77 +0,0 @@
|
|||
# 贡献者成长排行榜 — ylly/gitlink-cli
|
||||
|
||||
> 工作流⑤（贡献者成长体系）产物 · 数据源：git log + issue +list + pr +list（merged）
|
||||
> 生成时间：2026-06-29 · 数据范围：仓库全历史（已过滤测试号 15972095207 / 2403_89190320 / fsafasff）
|
||||
|
||||
## 综合排行榜
|
||||
|
||||
| 排名 | 贡献者 | Commits | 合并 PR | Issue | 综合积分 |
|
||||
|:----:|--------|:-------:|:-------:|:-----:|:--------:|
|
||||
| 1 | wbtiger | 42 | 0 | 0 | 42 |
|
||||
| 2 | ylly | 5 | 0 | 14 | 33 |
|
||||
| 3 | ZxR (ZxR123-Z) | 10 | 2 | 2 | 24 |
|
||||
| 4 | whzy | 9 | 0 | 0 | 9 |
|
||||
| 5 | wangyue789 | 8 | 0 | 0 | 8 |
|
||||
| 6 | wbavon | 8 | 0 | 0 | 8 |
|
||||
| 7 | Tiger | 5 | 0 | 0 | 5 |
|
||||
| 8 | zhangqing | 4 | 0 | 0 | 4 |
|
||||
| 9 | Mengz | 3 | 0 | 0 | 3 |
|
||||
| 10 | Jiachen Li | 2 | 0 | 0 | 2 |
|
||||
| 11 | Leo77 | 2 | 0 | 0 | 2 |
|
||||
| 12 | yangsai01 | 2 | 0 | 0 | 2 |
|
||||
| 13 | Zhang Jinnan | 1 | 0 | 0 | 1 |
|
||||
| 14 | ljc0426 | 1 | 0 | 0 | 1 |
|
||||
|
||||
> 积分公式：commits×1 + 合并PR×5 + Issue×2（PR 权重高，因合并工作量大）
|
||||
|
||||
## 徽章授予方案
|
||||
|
||||
| 徽章 | 授予标准 | 获得者 |
|
||||
|------|---------|--------|
|
||||
| ⭐ 星级贡献者 | commits ≥ 10 或 合并 PR ≥ 2 | wbtiger, ZxR (ZxR123-Z) |
|
||||
| 🔥 活跃贡献者 | commits ≥ 5 或 Issue ≥ 5 | ylly, whzy, wangyue789, wbavon, Tiger |
|
||||
| 🌱 贡献者 | 有任意提交 | zhangqing, Mengz, Jiachen Li, Leo77, yangsai01, Zhang Jinnan, ljc0426 |
|
||||
|
||||
## 颁奖动作清单（待执行，写入操作需用户确认）
|
||||
|
||||
**Step 1: 创建徽章 label**（仓库现无这些 label）
|
||||
- label +create --name "星级贡献者" --color #FFD700
|
||||
- label +create --name "活跃贡献者" --color #FF6B35
|
||||
- label +create --name "贡献者" --color #87C95F
|
||||
|
||||
**Step 2: 给 Top 贡献者发祝贺 Issue 评论**
|
||||
对 wbtiger / ZxR（ZxR123-Z）等 Top 贡献者相关的 Issue 添加祝贺评论。
|
||||
（GitLink 无"用户主页评论"能力，改在 Issue 评论或新建颁奖 Issue 演示）
|
||||
|
||||
**Step 3: 可选 — 新建颁奖 Issue**
|
||||
创建一个 Issue「🏆 v0.2.0-beta.1 贡献者排行榜公布」，body 含本排行榜，用 @mention 提及 Top 贡献者，并打上「星级贡献者」label。
|
||||
|
||||
---
|
||||
|
||||
## Skill 蓝图对照（按 SKILL.md 行号）
|
||||
|
||||
### 取数阶段 ← `gitlink-insight/SKILL.md` 工作流 3（贡献者洞察）
|
||||
|
||||
| 执行动作 | SKILL.md 蓝图位置 | 蓝图要求 | 实际执行 |
|
||||
|---------|------------------|---------|---------|
|
||||
| 贡献者列表 | 第 173-183 行 采集数据 | `contributors` + merged PR + user info | ✅ commits 走 `git log`（contributors API 返回 HTML，降级方案）+ merged PR + Issue 作者聚合 |
|
||||
| 角色与活跃度 | 第 185-203 行 输出格式 | 排行 + 活跃度分布 | ✅ 综合积分公式 commits×1+PR×5+Issue×2，按贡献分层 |
|
||||
| 三层分布 | 第 194-197 行 | 核心/活跃/新增 | ✅ 对应「星级/活跃/贡献者」三级徽章 |
|
||||
|
||||
### 发奖阶段 ← `gitlink-issue-triage/SKILL.md` 工作流 1 + 通用 label 操作
|
||||
|
||||
| 执行动作 | SKILL.md 蓝图位置 | 蓝图要求 | 实际执行 |
|
||||
|---------|------------------|---------|---------|
|
||||
| 查现有标签 | 第 80-84 行 Step 5 | `label +list` 命中则复用 | ✅ 仓库原无徽章 label，3 个均新建 |
|
||||
| 创建徽章 | 第 86-89 行 | `label +create --name --color` | ✅ 星级 394180 / 活跃 394181 / 贡献者 394182 |
|
||||
| 颁奖 Issue | 第 101-117 行报告格式 | 表格 + @mention | ✅ Issue #17 已建并打「星级贡献者」label |
|
||||
|
||||
### Skill 串联数
|
||||
|
||||
| 步骤 | 使用的 Skill/命令 | 角色 |
|
||||
|------|------------------|------|
|
||||
| 1 | git log + issue +list + pr +list（insight 工作流 3 数据源） | 取数 |
|
||||
| 2 | label +create（issue-triage 工作流 1 Step 5） | 建徽章 |
|
||||
| 3 | issue +create + issue +update --label（issue-triage 工作流 1 Step 6） | 颁奖 |
|
||||
|
||||
**3 步串联，满足 PDF「≥3 命令/Skill 串联」要求。**
|
||||
|
|
@ -1,119 +0,0 @@
|
|||
# ⑦ 新人全流程保姆 — 执行报告
|
||||
|
||||
> 工作流⑦（新人全流程保姆）最终产物
|
||||
> 驱动者：zhangqing · 工具：gitlink-cli + onboarding Skill + AI Agent
|
||||
> 执行时间：2026-06-29
|
||||
> 目标仓库：ylly/gitlink-cli
|
||||
|
||||
---
|
||||
|
||||
## 工作流概览
|
||||
|
||||
| Step | 动作 | 状态 | 写入 |
|
||||
|------|------|:----:|:----:|
|
||||
| 1 | member 邀请能力演示（+list / +invite-link） | ✅ | 否 |
|
||||
| 2 | good-first-issue 识别报告 | ✅ | 否 |
|
||||
| 3 | 对 3 个 good first Issue 写个性化引导评论 | ✅ | 是（3 条评论） |
|
||||
| 4 | notification +list 看新人动态 | ✅ | 否 |
|
||||
| 5 | 跟踪新人首次贡献（ZxR123-Z 案例） | ✅ | 否 |
|
||||
|
||||
---
|
||||
|
||||
## Step 1：邀请能力演示
|
||||
|
||||
- `member +list`：仓库现有 3 个 Manager（ylly / zhangqing23 / ZxR123-Z）
|
||||
- `member +invite-link`：成功获取邀请链接（id=3371，过期时间 **2026-07-02 11:32**，与任务三截止时间一致）
|
||||
- 故事设定：因仓库无真实"新人"测试账号，邀请动作用 `+invite-link` 演示命令能力；后续步骤设定为"假设新人已通过邀请链接入仓"
|
||||
|
||||
## Step 2：good-first-issue 识别报告
|
||||
|
||||
仓库现有 3 个 good first Issue（#8 / #13 / #14，均为 docs 类），onboarding Skill 按"新人友好识别标准"逐条复审 → **全部合理**。其余 14 个开放 Issue 均不适合新人（测试数据 / 模糊描述 / 性能优化 / 新功能开发等）。详见 `onboarding_identify_report.md`。
|
||||
|
||||
## Step 3：个性化引导评论发布 ✅
|
||||
|
||||
对 3 个 good first Issue 发布了**完全个性化**（非模板）的引导评论，每条含任务目标 + 相关文件 + 本地准备 + 提交 PR 规范 + @mention：
|
||||
|
||||
| Issue | 评论 ID | 核心引导 |
|
||||
|-------|:-------:|---------|
|
||||
| #8 docs: wiki 命令使用示例 | 478829 | 入手指引：`README.zh-CN.md` + `shortcuts/wiki/wiki.go` |
|
||||
| #13 docs: README Windows go build | 478830 | 入手指引：参考 `Makefile` + `scripts/build-npm.sh` |
|
||||
| #14 docs: wiki +list 返回字段说明 | 478831 | 入手指引：跑 `wiki +list --format json` 拿真实数据 |
|
||||
|
||||
发布命令模式（绕过 Windows 中文编码坑）：
|
||||
```bash
|
||||
MSYS_NO_PATHCONV=1 ./gitlink-cli.exe api POST /v1/ylly/gitlink-cli/issues/<n>/journals \
|
||||
--body-file "C:\\...\\comment_<n>.json"
|
||||
```
|
||||
（关键发现：journals endpoint 必须用 `/v1/<owner>/<repo>/...` 前缀，否则 404）
|
||||
|
||||
## Step 4：通知系统查看
|
||||
|
||||
`notification +list --owner zhangqing23`：共 13 条通知（12 未读）。展示通知系统能完整还原仓库动态。
|
||||
|
||||
## Step 5：首次贡献追踪（ZxR123-Z 案例）⭐
|
||||
|
||||
通知 + Issue + PR 数据交叉验证，**完整还原了一位新人从加入到首次贡献的全过程**：
|
||||
|
||||
| 时间 | 事件 | 数据来源 |
|
||||
|------|------|---------|
|
||||
| ~1 个月前 | ZxR123-Z 加入项目 | notification `[ProjectMemberJoined]` |
|
||||
| 6 天前 | ylly 新建多个 Issue（含 good first #8/#13/#14） | notification `[ProjectIssue]` |
|
||||
| 2 天前 | ZxR123-Z 提交 2 个 PR | notification `[ProjectPullRequest]` |
|
||||
| 2 天前 | 2 个 PR 全部 merged | pr +list --state merged |
|
||||
|
||||
→ ZxR123-Z 已突破"首次贡献"门槛，从"新人"晋升为"活跃贡献者"（在⑤排行榜中排第 3 名，10 commits + 2 PR + 2 Issue，综合积分 24）。
|
||||
|
||||
---
|
||||
|
||||
## 关键技术发现（避坑）
|
||||
|
||||
1. **API 路径双轨制**：release / label 用 `/<owner>/<repo>/...` 即可；issue / journals / pull **必须用 `/v1/<owner>/<repo>/...`**，否则 404
|
||||
2. **issue +list 与 issue +view 的 tag 字段不一致**：list 用 `issue_tags` 且可能不返回，view 用 `tags` 字段才完整
|
||||
3. **创建 issue 必须传 `done_ratio: 0`**，否则 MySQL 报 `Column 'done_ratio' cannot be null`
|
||||
4. **issue create 时 issue_tag_ids 字段不生效**（GitLink bug），需创建后用 `issue +update --label <id>` 补打
|
||||
|
||||
---
|
||||
|
||||
## Skill 蓝图对照（按 SKILL.md 行号）
|
||||
|
||||
本工作流 5 个 Step 严格按 `gitlink-onboarding/SKILL.md` 蓝图执行。
|
||||
|
||||
### Step 2 ← `gitlink-onboarding/SKILL.md` 工作流 1（good-first-issue 自动标记）
|
||||
|
||||
| 执行动作 | SKILL.md 蓝图位置 | 蓝图要求 | 实际执行 |
|
||||
|---------|------------------|---------|---------|
|
||||
| 取开放 Issue | 第 54-58 行 Step 1 | `issue +list` | ✅ 17 个开放 Issue |
|
||||
| 按识别标准评估 | 第 31-46 行 + 第 60-62 行 Step 2 | 5 条友好信号 + 3 条排除标准 | ✅ 3 个 docs 类入选，14 个按排除标准剔除 |
|
||||
| 复用现有标签 | 第 64-74 行 Step 3 | 优先复用，无则建 | ✅ 仓库已有 good first label（id 382660），未新建 |
|
||||
| 输出标记报告 | 第 84-95 行 Step 5 | 表格汇总 | ✅ `onboarding_identify_report.md` |
|
||||
|
||||
**关键对照**：SKILL.md 第 44-46 行排除标准（性能优化/描述模糊/CI 部署）逐条复审 14 个未入选 Issue，全部命中排除理由（测试数据 / 模糊描述 / 性能 / 新功能开发）。
|
||||
|
||||
### Step 3 ← `gitlink-onboarding/SKILL.md` 工作流 2（引导评论生成）
|
||||
|
||||
| 执行动作 | SKILL.md 蓝图位置 | 蓝图要求 | 实际执行 |
|
||||
|---------|------------------|---------|---------|
|
||||
| 读 Issue 详情 | 第 103-107 行 Step 1 | `issue +view` | ✅ #8/#13/#14 各取详情 |
|
||||
| 生成个性化评论 | 第 109-117 行 Step 2 | **禁止固定模板**，4 要素（任务/文件/本地准备/PR 规范） | ✅ 3 条**完全不同**的评论，每条指向具体文件 |
|
||||
| 发布评论 | 第 118-123 行 Step 3 | `issue +comment` | ✅ journals 478829/478830/478831（绕中文编码走 Raw API） |
|
||||
| 个性化要求 | 第 205 行注意事项 | "避免对所有 Issue 用同一句" | ✅ #8 指 `wiki.go` / #13 指 `Makefile` / #13 指 `wiki +list --format json` |
|
||||
|
||||
### Step 4 ← 通用通知能力
|
||||
|
||||
`notification +list` 自查询（受限）。`gitlink-shared/SKILL.md` 平台限制：只能查自己的通知。✅ 用 `--owner zhangqing23` 自查 13 条通知。
|
||||
|
||||
### Step 5 ← `gitlink-insight/SKILL.md` 工作流 3（贡献者洞察）交叉验证
|
||||
|
||||
通知 `[ProjectMemberJoined]` + `[ProjectPullRequest]` + `pr +list --state merged` 三源交叉 → 完整还原 ZxR123-Z 从入会到首次贡献全过程。该方法论对应 insight SKILL.md 第 173-203 行"贡献者列表 + PR 数据 + 用户信息"多源聚合。
|
||||
|
||||
### Skill 串联数
|
||||
|
||||
| 步骤 | 使用的 Skill/命令 | 角色 |
|
||||
|------|------------------|------|
|
||||
| 1 | member +invite-link | 邀请能力演示 |
|
||||
| 2 | onboarding 工作流 1（识别） | good-first 识别 |
|
||||
| 3 | onboarding 工作流 2（引导评论） | 个性化引导 |
|
||||
| 4 | notification +list | 通知系统查看 |
|
||||
| 5 | insight 工作流 3（交叉验证） | 首次贡献追踪 |
|
||||
|
||||
**5 步串联，满足 PDF「≥3 命令/Skill 串联」要求。**
|
||||
|
|
@ -1,127 +0,0 @@
|
|||
# zhangqing 任务三工作流（① ⑤ ⑦）
|
||||
|
||||
> **任务三**：构建端到端自动化工作流
|
||||
> **负责人**：zhangqing
|
||||
> **目标仓库**：[ylly/gitlink-cli](https://gitlink.org.cn/ylly/gitlink-cli)
|
||||
> **完成时间**：2026-06-29
|
||||
|
||||
本目录演示任务三中 zhangqing 负责的 3 个端到端工作流，全部用 **任务一的 gitlink-cli 命令 + 任务二的 Skill** 串联完成，无新代码。
|
||||
|
||||
---
|
||||
|
||||
## 工作流总览
|
||||
|
||||
| # | 工作流 | 串联步骤 | 使用的 Skill | 公开产出 |
|
||||
|---|--------|---------|-------------|---------|
|
||||
| ① | 社区运营自动化 | 分类→分配→周报→发版 | issue-triage + insight + release-auto | [Release v0.2.0-beta.1](https://gitlink.org.cn/ylly/gitlink-cli/releases) |
|
||||
| ⑤ | 贡献者成长体系 | 取数→排行→颁奖 | git log + issue +list + pr +list | [颁奖 Issue #17](https://gitlink.org.cn/ylly/gitlink-cli/issues/17) + 3 个徽章 label |
|
||||
| ⑦ | 新人全流程保姆 | 邀请→识别→引导→通知→追踪 | onboarding | 引导评论 on #8 / #13 / #14 |
|
||||
|
||||
3 个工作流首尾衔接形成完整闭环：**①把任务二 7 个 Skill 发版固化 → ⑤奖励贡献者 → ⑦引导新人接力贡献**。
|
||||
|
||||
---
|
||||
|
||||
## 文件清单
|
||||
|
||||
| 文件 | 内容 |
|
||||
|------|------|
|
||||
| `README.md` | 本文件（总览 + 复现指引） |
|
||||
| `01-community-ops-automation.md` | ① 社区运营自动化执行报告 |
|
||||
| `05-contributor-growth.md` | ⑤ 贡献者排行榜 + 徽章授予方案 |
|
||||
| `07-onboarding-nanny.md` | ⑦ 新人保姆 5 步执行报告 |
|
||||
| `release-notes-v0.2.0-beta.1.md` | ① 发布的 Release Notes 全文 |
|
||||
| `agent-dialogue-triggers.md` | **Agent 对话触发语**（PDF 首要产物：演示 Skill 驱动 Agent） |
|
||||
|
||||
---
|
||||
|
||||
## 怎么复现
|
||||
|
||||
复现方式见 [`agent-dialogue-triggers.md`](agent-dialogue-triggers.md)：在 Claude Code 里粘贴触发语，让 Agent 加载任务二的 Skill 来串联执行 ①⑤⑦ 三个工作流，把对话过程截图即为 PDF 要求的「Agent 对话记录」产物（PDF「正确做法」明确：Agent 对话记录是首要产物）。
|
||||
|
||||
---
|
||||
|
||||
## 任务二 Skill 串联关系（PDF 要求：≥3 命令/Skill）
|
||||
|
||||
| 工作流 | 串联的 Skill/命令 | 步数 |
|
||||
|--------|------------------|:---:|
|
||||
| ① | issue-triage → insight → release-auto | 4 |
|
||||
| ⑤ | git log + issue +list + pr +list → 排行榜 → label +create + issue +create | 3 |
|
||||
| ⑦ | member +invite-link → onboarding（识别 + 引导评论）→ notification +list | 5 |
|
||||
|
||||
---
|
||||
|
||||
## 任务二 Skill 作为设计蓝图（PDF 核心：Skill = 设计蓝图）
|
||||
|
||||
本目录的 3 份执行报告都新增了「Skill 蓝图对照」段，**逐动作引用 SKILL.md 行号**，证明每步执行都严格按蓝图落地：
|
||||
|
||||
| 工作流 | 蓝图 SKILL.md 行号定位 |
|
||||
|--------|----------------------|
|
||||
| ① 步骤 1 分类 | `gitlink-issue-triage/SKILL.md` 工作流 1（第 54-117 行），含分类规则表第 35-50 行 |
|
||||
| ① 步骤 2 分配（跳过）| `gitlink-issue-triage/SKILL.md` 第 125-146 行（蓝图预判个人仓库 assigners 为空）|
|
||||
| ① 步骤 3 周报 | `gitlink-insight/SKILL.md` 工作流 2（第 116-166 行）|
|
||||
| ① 步骤 4 发版 | `gitlink-release-auto/SKILL.md` 一/二/三（第 32-189 行），含预发布第 179-189 行 |
|
||||
| ⑤ 取数 | `gitlink-insight/SKILL.md` 工作流 3（第 169-203 行）|
|
||||
| ⑤ 发奖 | `gitlink-issue-triage/SKILL.md` 工作流 1 Step 5-6（第 80-117 行）|
|
||||
| ⑦ Step 2 识别 | `gitlink-onboarding/SKILL.md` 工作流 1（第 50-95 行）+ 识别标准第 31-46 行 |
|
||||
| ⑦ Step 3 引导 | `gitlink-onboarding/SKILL.md` 工作流 2（第 99-145 行）+ 个性化要求第 205 行 |
|
||||
| ⑦ Step 5 追踪 | `gitlink-insight/SKILL.md` 工作流 3（第 169-203 行）多源聚合 |
|
||||
|
||||
**意义**：评委打开任一报告的「Skill 蓝图对照」段，可拿着 SKILL.md 行号对照检查，验证"Skill 不是摆设，是真正驱动 Agent 执行的设计蓝图"。
|
||||
|
||||
---
|
||||
|
||||
## 关键技术发现（避坑）
|
||||
|
||||
### 1. GitLink API 路径双轨制 ⚠
|
||||
|
||||
| 资源类型 | 路径前缀 | 例子 |
|
||||
|---------|---------|------|
|
||||
| release / label | `/owner/repo/...` | `/ylly/gitlink-cli/releases` |
|
||||
| issue / journals / pulls | `/v1/owner/repo/...` | `/v1/ylly/gitlink-cli/issues/8/journals` |
|
||||
|
||||
混用会 404。cli 内部 `v1RepoPath()` 见 `shortcuts/issue/issue.go:14`。
|
||||
|
||||
### 2. release +create 没有 --body-file
|
||||
|
||||
多行中文 markdown 用 `--body` 在 Git Bash 必乱码。改用：
|
||||
|
||||
```bash
|
||||
MSYS_NO_PATHCONV=1 ./gitlink-cli.exe api POST /ylly/gitlink-cli/releases \
|
||||
--body-file payload.json
|
||||
```
|
||||
|
||||
### 3. 创建 issue 必须传 done_ratio
|
||||
|
||||
否则 MySQL 报 `Column 'done_ratio' cannot be null`。最小 payload：
|
||||
|
||||
```json
|
||||
{
|
||||
"subject": "...",
|
||||
"description": "...",
|
||||
"priority_id": 2,
|
||||
"done_ratio": 0,
|
||||
"issue_tag_ids": [<label_id>]
|
||||
}
|
||||
```
|
||||
|
||||
### 4. issue create 的 issue_tag_ids 字段不生效（GitLink bug）
|
||||
|
||||
创建时传 label 数组，issue 上没标签。需要创建后补：
|
||||
|
||||
```bash
|
||||
./gitlink-cli.exe issue +update --owner <o> --repo <r> --number <n> --label <id>
|
||||
```
|
||||
|
||||
### 5. Windows Git Bash 中文乱码根因
|
||||
|
||||
cli 输出 UTF-8 字节 → bash 按 GBK 解码 → 错字符 → python 转 `\uXXXX` → 再传给 cli 就把错字符写到服务器。**所有写入操作必须用 `--body-file <UTF-8文件>`**，不要 shell 拼接 JSON。
|
||||
|
||||
---
|
||||
|
||||
## 设计决策
|
||||
|
||||
| 决策点 | 选择 | 理由 |
|
||||
|--------|------|------|
|
||||
| 发版版本号 | v0.2.0-**beta.1**（预发布） | 等任务三 7 个工作流全部完工后由整合者发正式 v0.2.0，避免版本号冲突 |
|
||||
| Release Notes 覆盖范围 | 仓库全部 104 个提交（含他人贡献） | 发版是仓库级动作，必须覆盖该版本全部变更，不能只写自己的 |
|
||||
| ⑦ 的"新人"问题 | onboarding 主体真做，邀请段用 invite-link 演示 | 仓库无真实新人账号；onboarding 核心价值（识别 + 引导）与有无新人无关 |
|
||||
|
|
@ -1,119 +0,0 @@
|
|||
# Agent 对话触发语（PDF 核心：Agent 对话是首要产物）
|
||||
|
||||
> 用途：评委/复现者在 Claude Code 里**逐字粘贴**下面任一条触发语，即可观察到
|
||||
> AI Agent 自动加载对应 Skill（按 SKILL.md 蓝图）→ 调 gitlink-cli 命令 → 串联多步 → 落地写入。
|
||||
> 把这个对话过程截图/录屏，就是 PDF 要求的「Agent 对话记录」产物。
|
||||
|
||||
---
|
||||
|
||||
## 为什么需要触发语
|
||||
|
||||
PDF「正确做法」明确：
|
||||
|
||||
- **Agent 对话记录是首要产物**，脚本是辅助
|
||||
- **Skill 是设计蓝图**，不是配置文件
|
||||
- 必须能演示"Skill 真的被加载、真的驱动 Agent 执行"
|
||||
|
||||
触发语的设计原则：**用自然语言匹配 SKILL.md 第 4 行 `description` 字段的触发语义**，让 Agent 自动识别并调用 Skill 工具。
|
||||
|
||||
---
|
||||
|
||||
## 前置准备（所有触发语共用）
|
||||
|
||||
在 Claude Code 里先说一句建立上下文：
|
||||
|
||||
```
|
||||
我在做 GitLink 端到端自动化任务三。目标仓库是 ylly/gitlink-cli，
|
||||
我的登录账号是 zhangqing23（已是该仓库 Manager）。
|
||||
gitlink-cli.exe 在 C:/Users/Lenovo/Desktop/gitlink-cli/ 目录下，已 auth login。
|
||||
下面我会给你具体的自动化需求，请用任务二设计好的 Skill 来做。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 工作流 ① 触发语（社区运营自动化）
|
||||
|
||||
**单条完整触发语**（推荐用于演示，一句话串起分类→周报→发版）：
|
||||
|
||||
```
|
||||
请帮我对 ylly/gitlink-cli 做一次社区运营收尾：
|
||||
1. 自动分拣所有未分类的开放 Issue（用 gitlink-issue-triage 工作流1）；
|
||||
2. 生成一份项目周报（用 gitlink-insight 工作流2）；
|
||||
3. 根据自上次发版以来的提交历史，推荐版本号并生成 Release Notes，
|
||||
先给我预览，确认后再发布（用 gitlink-release-auto）。
|
||||
每一步执行前告诉我你正在加载哪个 Skill、对应 SKILL.md 的哪一段。
|
||||
```
|
||||
|
||||
**分步触发语**（如果只想演示单步）：
|
||||
|
||||
| Step | 触发语（直接粘贴） | 对应 Skill 蓝图 |
|
||||
|:----:|-------------------|----------------|
|
||||
| 1 | "帮我把 ylly/gitlink-cli 所有没标签的开放 Issue 自动分类打标签" | issue-triage 工作流 1 |
|
||||
| 2 | "给我一份 ylly/gitlink-cli 本周的项目周报" | insight 工作流 2 |
|
||||
| 3 | "根据 ylly/gitlink-cli 自上次发版以来的提交，推荐下一个版本号并生成 Release Notes" | release-auto 一、二 |
|
||||
|
||||
**预期 Agent 行为**（截图要点）：
|
||||
- Agent 会先说"使用 gitlink-issue-triage Skill"
|
||||
- 调用 `issue +list --state open` → 筛未分类 → `issue +view` 读详情 → 按分类规则表归类 → `issue +update --label`
|
||||
- 每步都会展示它对应 SKILL.md 的哪一段（这是"Skill 作为设计蓝图"的可视证据）
|
||||
|
||||
---
|
||||
|
||||
## 工作流 ⑤ 触发语（贡献者成长体系）
|
||||
|
||||
**单条完整触发语**：
|
||||
|
||||
```
|
||||
请帮我对 ylly/gitlink-cli 建立贡献者成长体系：
|
||||
1. 取仓库全历史的 commits（git log）+ merged PR（pr +list --state merged）
|
||||
+ Issue 作者（issue +list），生成一份综合积分排行榜（公式 commits×1 + PR×5 + Issue×2），
|
||||
过滤掉测试号 15972095207 / 2403_89190320 / fsafasff；
|
||||
2. 按三层标准授予徽章（星级/活跃/贡献者），先创建对应 label（颜色 #FFD700/#FF6B35/#87C95F）；
|
||||
3. 建一个颁奖 Issue 公布排行榜并 @mention Top 贡献者。
|
||||
执行前先给我清单确认。
|
||||
```
|
||||
|
||||
**预期 Agent 行为**：
|
||||
- Agent 调用 insight 工作流 3 的数据采集方法（第 173-183 行）
|
||||
- 调用 issue-triage 工作流 1 Step 5 的 label 创建（第 86-89 行）
|
||||
- 输出排行榜表格 + 颁奖动作清单等用户确认
|
||||
|
||||
---
|
||||
|
||||
## 工作流 ⑦ 触发语（新人全流程保姆）
|
||||
|
||||
**单条完整触发语**：
|
||||
|
||||
```
|
||||
请帮我对 ylly/gitlink-cli 做新人引导全流程：
|
||||
1. 用 member +invite-link 演示邀请能力（仓库无真实新人账号，仅演示）；
|
||||
2. 扫描开放 Issue，按新人友好识别标准找出适合新人的 Issue（onboarding 工作流1）；
|
||||
3. 对找出的 good first Issue 写**完全个性化**的引导评论（onboarding 工作流2），
|
||||
每条评论要定位到具体文件、给本地准备命令、写 PR 提交规范——禁止用同一模板；
|
||||
4. 用 notification +list --owner zhangqing23 看通知动态；
|
||||
5. 交叉验证通知 + Issue + PR 数据，还原一位新人从加入到首次贡献的全过程。
|
||||
写入操作前给我预览。
|
||||
```
|
||||
|
||||
**分步触发语**：
|
||||
|
||||
| Step | 触发语 | 对应 Skill 蓝图 |
|
||||
|:----:|-------|----------------|
|
||||
| 2 | "帮我找出 ylly/gitlink-cli 适合新人的 Issue 并打 good first 标签" | onboarding 工作流 1 |
|
||||
| 3 | "帮我给 ylly/gitlink-cli 适合新人的 Issue 写个性化引导评论" | onboarding 工作流 2 |
|
||||
|
||||
**预期 Agent 行为**：
|
||||
- 识别阶段会引用 onboarding SKILL.md 第 31-46 行的 5 条友好信号 + 3 条排除标准
|
||||
- 引导评论阶段会引用第 205 行"禁止对所有 Issue 用同一句"，每条评论定位不同文件
|
||||
|
||||
---
|
||||
|
||||
## 对话产物采集建议
|
||||
|
||||
录 Agent 对话时重点截这几段（对应 PDF 评分点）：
|
||||
|
||||
1. **Skill 加载声明**：Agent 说"我将使用 gitlink-xxx Skill"的那一句
|
||||
2. **蓝图引用**：Agent 提到"按 SKILL.md 第 X-Y 行"的段落
|
||||
3. **命令调用**：Agent 调 gitlink-cli 的命令行（带参数）
|
||||
4. **真实写入回执**：服务器返回的 `ok:true` / `id` / `version_id` 等
|
||||
5. **网页验证**：复制返回的 URL 到浏览器打开看到真实效果
|
||||
|
|
@ -1,55 +0,0 @@
|
|||
> 本版本为**任务三阶段性预发布**。正式版 v0.2.0 将在任务三全部 7 个端到端工作流完工后发布。
|
||||
|
||||
## v0.2.0 Beta 1 — 智能运营能力升级版（预发布）
|
||||
|
||||
本版本集中呈现任务二「AI Skill 套件」与任务三「端到端自动化工作流」的阶段成果，为 GitLink CLI 引入完整的智能运营能力。
|
||||
|
||||
### ✨ 新功能 · Skills 智能套件
|
||||
|
||||
任务二交付的 AI Skill，让 Agent 能直接驱动 GitLink 完成高级运营场景：
|
||||
|
||||
- feat(skills): 新增 gitlink-issue-triage — Issue 智能分拣（自动打标签 / 识别 good first）
|
||||
- feat(skills): 新增 gitlink-release-auto — 自动发版（语义化版本推荐 + Release Notes 生成）
|
||||
- feat(skills): 新增 gitlink-commit-quality — 提交信息规范检查
|
||||
- feat(skills): 新增 gitlink-code-review — 代码审查
|
||||
- feat(skills): 新增 gitlink-insight — 仓库健康洞察
|
||||
- feat(skills): 新增 gitlink-compliance — 合规检查
|
||||
- feat(skills): 新增文档智能维护 + 新人引导 Skill
|
||||
|
||||
### ✨ 新功能 · Shortcut 命令扩展
|
||||
|
||||
- feat(wiki): 新增 wiki +list / +view / +create / +update / +delete
|
||||
- feat(label): 新增 label 标签管理命令
|
||||
- feat(notification): 新增 notification 通知模块
|
||||
- feat(member): 新增 member 仓库成员管理命令
|
||||
- feat(milestone): 新增 milestone 里程碑命令
|
||||
- feat(compare): 新增 compare 对比命令
|
||||
- feat(pr): 新增 pr reopen / review / patchset version 命令
|
||||
- feat(webhook): 新增 webhook 快捷命令组
|
||||
- feat(repo): 新增 repo readme 快捷命令
|
||||
- feat(issue): 新增 issue authors / assigners 查询命令
|
||||
- feat(api): 支持 --body-file 从文件读取请求体（解决 Windows 中文编码问题）
|
||||
|
||||
### 📚 工作流示例
|
||||
|
||||
- feat(workflows): 新增 community-ops-automation 社区运营自动化端到端示例
|
||||
|
||||
### 🐛 Bug 修复
|
||||
|
||||
- fix(notification): 修正通知读取 / 删除的 API endpoint 与请求体
|
||||
- fix(issue): 修正 --label 语义，新增 --label clear 清除标签
|
||||
- fix(wiki): 修正 wiki 网关 API（gateway.gitlink.org.cn）与请求方法
|
||||
- fix(label): 修正 label API path 至 /{owner}/{repo}/labels
|
||||
- fix(pr): view 输出补充 closed time 字段
|
||||
- fix(member): 报告批量添加中的部分失败
|
||||
|
||||
### 📦 其他变更
|
||||
|
||||
- docs: 3 个 Skill 的 REFERENCE.md 参考文档
|
||||
- docs: 工作流示例的提交清单 / 验证文档
|
||||
- test: webhook / label / notification 测试用例对齐
|
||||
- refactor: 自动部署配置精简
|
||||
|
||||
### 🤝 贡献者
|
||||
|
||||
感谢以下贡献者参与本版本开发：@ylly、@zhangqing、@ZxR、@yangsai01、@Leo77、@Mengz、@wangyue789、@puygob236、@dtwdtw、@muel、@Jiachen Li、@Tiger、@wbtiger、@ljc0426、@whzy
|
||||
Loading…
Reference in New Issue