feat(skills): 新增科研进度跟踪与预警的skill : gitlink-research-progress #256

luwanzhou · 2026-06-15T12:51:43+08:00

luwanzhou commented

2026-06-15 12:51:43 +08:00

问题描述

课题组负责人（PI）、导师常常难以实时掌握多个科研仓库的真实进度与风险。

现象：想知道「这个科研项目现在进展如何、哪里有延期或停滞风险」时，缺少一个能把提交/Issue/里程碑/PR/贡献数据汇总成「进度 + 预警」的工具，只能手动逐项翻看。
影响：gitlink-cli 现有的 gitlink-health / gitlink-insight 偏「健康度快照」，缺少面向科研项目管理的「进度趋势 + 风险预警」，子赛题四「科研进度智能跟踪与预警」处于空白，组会汇报 / 风险识别缺少自动化支撑。

问题复现步骤（现状空白复现）

在 AI Agent 中提出：「帮我看某科研仓库这周进展怎么样，有没有要预警的」。
现有 Skill 无一专门回答「进度趋势 + 风险预警」（health/insight 给的是综合健康度快照，不分提交节奏骤降、里程碑临期、Bus Factor 等风险信号）。
在主仓库执行 grep -rli "进度预警" skills/ examples/，零命中。
结论：科研进度跟踪与预警能力缺失。

根本原因

现有 gitlink-health / gitlink-insight 的定位是「项目健康度综合快照」，输出聚合指标，但：

不刻画提交节奏的时间趋势与「骤降 = 停滞」信号；
不计算里程碑临期完成度、PR 停留时长、Bus Factor（单点依赖）等管理向风险；
不产出红/黄/绿灯式、可直接用于组会汇报的「周报 + 预警」。

因此科研进度跟踪与预警是一块独立的、未被覆盖的能力。

修复方案（新增能力）

新增只读分析型 Skill gitlink-research-progress：监控科研仓库的协作数据，自动生成可直接用于组会/阶段汇报的**《科研进度周报 + 风险预警》**，用红/黄/绿灯标记停滞与风险。

五维进度信号：提交节奏（Velocity）、Issue 进度（Burndown）、里程碑完成度、PR 吞吐（Throughput）、团队活跃与 Bus Factor；每个信号给出明确风险规则，并汇总为「项目总灯」；附提交节奏 ASCII 趋势图与周报模板。
依赖命令：repo +info、issue +list --state、milestone +list、pr +list --state、api GET /:owner/:repo/commits、repo +contributors（其 contribution_perc 即 Bus Factor 主数据源）。repo +contributor-stats 在部分仓库后端会返回 [-1]，已在 Skill 中标注为可选容错、失败可忽略。
安全：纯只读；如需把预警落成 Issue/评论，会先征得用户同意。

合并请求描述

本 PR 为子赛题四（科研辅助）新增 gitlink-research-progress Skill，填补 gitlink-cli 在「科研进度跟踪与预警」上的能力空白，把科研仓库的协作数据转化为可量化的进度信号与风险灯，自动产出可用于组会的周报。

变更内容

1. 新增 Skill 主文件 `skills/gitlink-research-progress/SKILL.md`

五维进度信号与风险规则、综合灯算法、提交节奏 ASCII 趋势图、《科研进度周报 + 风险预警》模板、执行步骤；frontmatter 与 gitlink-shared 引用对齐已合并的 gitlink-scholar-profile。

2. 新增工作流示例 `examples/progress-workflow.md`

真实命令驱动的周报生成示例（含信号归集与红灯判定）。

3. 健壮性（基于真实仓库实测）

Bus Factor 以 repo +contributors 的 contribution_perc 为主数据源；repo +contributor-stats 标注为可选、失败可忽略。

4. 规范与安全

纯 Markdown、不含 Go 改动、CI 无影响；所引用 CLI 命令均经源码核对真实存在（pr +list 用 --state）；只读分析型。

## 问题描述课题组负责人（PI）、导师常常难以实时掌握多个科研仓库的真实进度与风险。 - **现象**：想知道「这个科研项目现在进展如何、哪里有延期或停滞风险」时，缺少一个能把提交/Issue/里程碑/PR/贡献数据汇总成「进度 + 预警」的工具，只能手动逐项翻看。 - **影响**：gitlink-cli 现有的 `gitlink-health` / `gitlink-insight` 偏「健康度快照」，**缺少面向科研项目管理的「进度趋势 + 风险预警」**，子赛题四「科研进度智能跟踪与预警」处于空白，组会汇报 / 风险识别缺少自动化支撑。 ## 问题复现步骤（现状空白复现） 1. 在 AI Agent 中提出：「帮我看某科研仓库这周进展怎么样，有没有要预警的」。 2. 现有 Skill 无一专门回答「进度趋势 + 风险预警」（health/insight 给的是综合健康度快照，不分提交节奏骤降、里程碑临期、Bus Factor 等风险信号）。 3. 在主仓库执行 `grep -rli "进度预警" skills/ examples/`，零命中。 4. 结论：科研进度跟踪与预警能力缺失。 ## 根本原因现有 `gitlink-health` / `gitlink-insight` 的定位是「项目健康度综合快照」，输出聚合指标，但： - 不刻画**提交节奏的时间趋势**与「骤降 = 停滞」信号； - 不计算**里程碑临期完成度**、**PR 停留时长**、**Bus Factor**（单点依赖）等管理向风险； - 不产出红/黄/绿灯式、可直接用于组会汇报的「周报 + 预警」。因此科研进度跟踪与预警是一块独立的、未被覆盖的能力。 ## 修复方案（新增能力）新增只读分析型 Skill `gitlink-research-progress`：监控科研仓库的协作数据，自动生成可直接用于组会/阶段汇报的**《科研进度周报 + 风险预警》**，用红/黄/绿灯标记停滞与风险。 - **五维进度信号**：提交节奏（Velocity）、Issue 进度（Burndown）、里程碑完成度、PR 吞吐（Throughput）、团队活跃与 **Bus Factor**；每个信号给出明确风险规则，并汇总为「项目总灯」；附提交节奏 ASCII 趋势图与周报模板。 - **依赖命令**：`repo +info`、`issue +list --state`、`milestone +list`、`pr +list --state`、`api GET /:owner/:repo/commits`、`repo +contributors`（其 `contribution_perc` 即 Bus Factor 主数据源）。`repo +contributor-stats` 在部分仓库后端会返回 `[-1]`，已在 Skill 中标注为可选容错、失败可忽略。 - **安全**：纯只读；如需把预警落成 Issue/评论，会先征得用户同意。 ## 合并请求描述本 PR 为子赛题四（科研辅助）新增 `gitlink-research-progress` Skill，填补 gitlink-cli 在「科研进度跟踪与预警」上的能力空白，把科研仓库的协作数据转化为可量化的进度信号与风险灯，自动产出可用于组会的周报。 ## 相关Issue 无直接关联 Issue（本 PR 为子赛题四新增科研辅助能力）。场景对应赛题说明「科研进度智能跟踪与预警」。 ## 变更内容 ### 1. 新增 Skill 主文件 `skills/gitlink-research-progress/SKILL.md` 五维进度信号与风险规则、综合灯算法、提交节奏 ASCII 趋势图、《科研进度周报 + 风险预警》模板、执行步骤；frontmatter 与 `gitlink-shared` 引用对齐已合并的 `gitlink-scholar-profile`。 ### 2. 新增工作流示例 `examples/progress-workflow.md` 真实命令驱动的周报生成示例（含信号归集与红灯判定）。 ### 3. 健壮性（基于真实仓库实测） Bus Factor 以 `repo +contributors` 的 `contribution_perc` 为主数据源；`repo +contributor-stats` 标注为可选、失败可忽略。 ### 4. 规范与安全纯 Markdown、不含 Go 改动、CI 无影响；所引用 CLI 命令均经源码核对真实存在（`pr +list` 用 `--state`）；只读分析型。

luwanzhou added 1 commit 2026-06-15 12:51:44 +08:00

6565c7bc61 feat(skills): add gitlink-research-progress — 科研进度跟踪与预警

新增科研进度智能跟踪与预警 Skill：监控科研仓库的提交节奏、Issue 解决进度、
里程碑完成度、PR 吞吐与贡献者活跃度（Bus Factor），用红/黄/绿灯标记停滞与
风险，自动生成《科研进度周报 + 风险预警》。

- SKILL.md：五维进度信号、风险规则、综合灯与提交趋势图、周报模板、执行步骤
- examples/progress-workflow.md：真实命令驱动的周报生成示例

子赛题四（科研辅助）。纯 Markdown，只读分析型。

wbtiger merged commit 8a8b760f2c into master

2026-07-14 22:26:51 +08:00

wbtiger referenced this issue from a commit

2026-07-14 22:26:52 +08:00

Merge pull request 'feat(skills): 新增科研进度跟踪与预警的skill : gitlink-research-progress' (#256) from luwanzhou/gitlink-cli:feat/skill-research-progress into master

Sign in to join this conversation.

No reviewers

No Label

No Milestone

No project

No Assignees

1 Participants

Notifications

Due Date

The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Gitlink/gitlink-cli#256

feat(skills): 新增 科研进度跟踪与预警的skill : gitlink-research-progress #256