feat(skills): 新增 gitlink-research-{insight,repro,idea} 科研辅助 skills #335

Merged
wbtiger merged 1 commits from Kexing/gitlink-cli:feat/research-skills into master 2026-07-14 22:31:19 +08:00
Contributor

TL;DR

新增 3 个面向单仓科研代码仓库的研究辅助 skill,覆盖子赛题四「应用 GitLink 辅助科研」三大场景:内涵解读 / 复现性体检 / 研究 Idea 生成。给一个(或一组)GitLink 科研仓库,30 分钟内产出中文研究报告,全程数据由 gitlink-cli 实时采集、每条结论可溯源、每份报告可复现。

  • 改动:仅新增 8 个文件、+928 行,纯 Markdown(SKILL.md + 真实范例),不涉及 Go 代码。
  • 依赖:仅 gitlink-cli(仓库已有)。

背景

GitLink 上的科研/论文代码仓库,对科研工作者存在「读懂难 / 复现难 / 创新难」三难。而仓库内现有 3 个科研 skill(gitlink-scholar-profile / gitlink-research-tracker / gitlink-research-fork-impact全部在「跨仓」粒度做指标计数 / 评分,无一在「单仓」粒度做内容级研究内涵理解——这恰是科研工作者最日常、最痛的需求。本 PR 填补这一空白。

现实约束(据证设计):GitLink 科研仓库绝大多数是「成品上传」——commit 少(实测靶子仓仅 3 个 commit 且全部同日)、不含真实探索过程。因此本组 skill 基于内容(README + 代码结构 + 实验配置 + 依赖)解读,而非基于 commit / 分支演进。

新增内容

Skill 触发场景 输入 → 输出 真实范例(diff 内)
gitlink-research-insight 读懂陌生科研仓 一仓 → 中文「内涵解读报告」(仓库画像 / 研究问题 / 方法创新 / 基线矩阵 / 数据集 / 复现性速览 6 维);模式二:方法—代码实现剖析 + 架构 Mermaid + 「想改 X 看哪里」定位表 examples/*-insight.md*-anatomy.md
gitlink-research-repro 实验复现性体检 一仓 → 8 维度 /⚠️/ 体检 + 卡点修复建议 + 复现路径 examples/*-repro.md
gitlink-research-idea 研究 Idea 生成 单仓 → 方法局限 + ≥3 条带代码证据 Idea;多仓 → 创新对比矩阵 + 共性缺口 + 跨仓 Idea + 差异化自证 examples/*-ideas.mdcil-multi-repo-ideas.md

5 份真实范例全部基于 GitLink 真实科研仓验证:靶子仓 gaozijian19/Maintaining-Fairness-in-LKD-for-CIL(AAAI'25 CIL 论文代码),多仓另含 PatZQ/AudioCILKexing/class-incremental-learning。每份报告末尾均附「采集命令(可一键复现)」区块。

与现有 skill 的边界(互补不撞车)

本组 skill 区别于 一句话
单仓内容级科研内涵解读 gitlink-research-tracker 它跨仓计数/评分;本组在单仓做方法语义理解
多仓创新点对比 + Idea 生成 scholar-profile / tracker / fork-impact 它们做画像/热点/传播;本组做语义级 Idea 合成
实验复现性体检 gitlink-compliance / license-compliance 它们查许可证/依赖合规;本组查实验能否跑通、结果能否重现

边界严守:许可证 / 依赖合规仍归 gitlink-compliance;本组仅在发现无 LICENSE 时提示转交,不计入复现性评分。

数据采集约定(对后续 skill 作者可直接复用)

  • 只用 gitlink-cli(赛题强制 + 可溯源):repo +info/+readme/+tree/+languages/+contributors/+code-stats
  • 读任意文件正文用 GitLink 的 sub_entries 端点(不是 /contents/——在 GitLink 不存在会 404;/raw/ 对 API token 常返回 403)。正文落在返回的 data.entries.content
  • Git Bash 路径坑:raw api 带前导 / 的路径会被 MSYS 转成 Windows 路径(A:/...)导致 404,须加 MSYS_NO_PATHCONV=1
    MSYS_NO_PATHCONV=1 gitlink-cli api GET "/<owner>/<repo>/sub_entries" --query "filepath=<path>&ref=master" --format json
    

如何验证(三步)

gitlink-cli auth status                       # 前置:已登录
# 告诉 Claude Code(或读对应 SKILL.md 手动执行):
#   "解读仓库 gaozijian19/Maintaining-Fairness-in-LKD-for-CIL"  → insight
#   "体检它的复现性"                                            → repro
#   "给我研究 Idea / 对比这几个 CIL 仓"                         → idea

skill 自动用上述 gitlink-cli 命令采集(无人工搬运),产出与 examples/ 一致的中文 Markdown 报告。

效果演示(截图)

以Claude Code这个Agent为例,以gaozijian19/Stabilizing-Zero-Shot-Prediction-ZAF为靶子仓库,截图展示内涵解读、复现性体检、单仓 Idea 挖掘、多仓 Idea 挖掘的效果。

1. 内涵解读

截图展示(点击展开)

复现性体检

截图展示(点击展开)

单仓 Idea

截图展示(点击展开)

多仓 Idea 对比

截图展示(点击展开)
## TL;DR 新增 3 个面向**单仓科研代码仓库**的研究辅助 skill,覆盖子赛题四「应用 GitLink 辅助科研」三大场景:**内涵解读 / 复现性体检 / 研究 Idea 生成**。给一个(或一组)GitLink 科研仓库,30 分钟内产出中文研究报告,全程数据由 `gitlink-cli` 实时采集、每条结论可溯源、每份报告可复现。 - **改动**:仅新增 8 个文件、+928 行,纯 Markdown(SKILL.md + 真实范例),不涉及 Go 代码。 - **依赖**:仅 `gitlink-cli`(仓库已有)。 ## 背景 GitLink 上的科研/论文代码仓库,对科研工作者存在「读懂难 / 复现难 / 创新难」三难。而仓库内现有 3 个科研 skill(`gitlink-scholar-profile` / `gitlink-research-tracker` / `gitlink-research-fork-impact`)**全部在「跨仓」粒度做指标计数 / 评分**,无一在「单仓」粒度做**内容级研究内涵理解**——这恰是科研工作者最日常、最痛的需求。本 PR 填补这一空白。 > **现实约束(据证设计)**:GitLink 科研仓库**绝大多数是「成品上传」**——commit 少(实测靶子仓仅 3 个 commit 且全部同日)、不含真实探索过程。因此本组 skill 基于**内容**(README + 代码结构 + 实验配置 + 依赖)解读,而非基于 commit / 分支演进。 ## 新增内容 | Skill | 触发场景 | 输入 → 输出 | 真实范例(diff 内) | |-------|----------|-------------|----------------------| | `gitlink-research-insight` | 读懂陌生科研仓 | 一仓 → 中文「内涵解读报告」(仓库画像 / 研究问题 / 方法创新 / 基线矩阵 / 数据集 / 复现性速览 6 维);**模式二**:方法—代码实现剖析 + 架构 Mermaid + 「想改 X 看哪里」定位表 | `examples/*-insight.md`、`*-anatomy.md` | | `gitlink-research-repro` | 实验复现性体检 | 一仓 → 8 维度 ✅/⚠️/❌ 体检 + 卡点修复建议 + 复现路径 | `examples/*-repro.md` | | `gitlink-research-idea` | 研究 Idea 生成 | 单仓 → 方法局限 + ≥3 条带代码证据 Idea;**多仓** → 创新对比矩阵 + 共性缺口 + 跨仓 Idea + 差异化自证 | `examples/*-ideas.md`、`cil-multi-repo-ideas.md` | **5 份真实范例**全部基于 GitLink 真实科研仓验证:靶子仓 `gaozijian19/Maintaining-Fairness-in-LKD-for-CIL`(AAAI'25 CIL 论文代码),多仓另含 `PatZQ/AudioCIL` 与 `Kexing/class-incremental-learning`。每份报告末尾均附「采集命令(可一键复现)」区块。 ## 与现有 skill 的边界(互补不撞车) | 本组 skill | 区别于 | 一句话 | |------------|--------|--------| | 单仓内容级科研内涵解读 | `gitlink-research-tracker` | 它跨仓计数/评分;本组在单仓做方法语义理解 | | 多仓创新点对比 + Idea 生成 | `scholar-profile` / `tracker` / `fork-impact` | 它们做画像/热点/传播;本组做语义级 Idea 合成 | | 实验复现性体检 | `gitlink-compliance` / `license-compliance` | 它们查许可证/依赖合规;本组查实验能否跑通、结果能否重现 | 边界严守:许可证 / 依赖合规仍归 `gitlink-compliance`;本组仅在发现无 LICENSE 时提示转交,不计入复现性评分。 ## 数据采集约定(对后续 skill 作者可直接复用) - **只用 `gitlink-cli`**(赛题强制 + 可溯源):`repo +info/+readme/+tree/+languages/+contributors/+code-stats`。 - **读任意文件正文**用 GitLink 的 `sub_entries` 端点(**不是 `/contents/`**——在 GitLink 不存在会 404;`/raw/` 对 API token 常返回 403)。正文落在返回的 `data.entries.content`。 - **Git Bash 路径坑**:raw `api` 带前导 `/` 的路径会被 MSYS 转成 Windows 路径(`A:/...`)导致 404,须加 `MSYS_NO_PATHCONV=1`: ```bash MSYS_NO_PATHCONV=1 gitlink-cli api GET "/<owner>/<repo>/sub_entries" --query "filepath=<path>&ref=master" --format json ``` ## 如何验证(三步) ```bash gitlink-cli auth status # 前置:已登录 # 告诉 Claude Code(或读对应 SKILL.md 手动执行): # "解读仓库 gaozijian19/Maintaining-Fairness-in-LKD-for-CIL" → insight # "体检它的复现性" → repro # "给我研究 Idea / 对比这几个 CIL 仓" → idea ``` skill 自动用上述 `gitlink-cli` 命令采集(无人工搬运),产出与 `examples/` 一致的中文 Markdown 报告。 ## 效果演示(截图) 以Claude Code这个Agent为例,以`gaozijian19/Stabilizing-Zero-Shot-Prediction-ZAF`为靶子仓库,截图展示内涵解读、复现性体检、单仓 Idea 挖掘、多仓 Idea 挖掘的效果。 ### 1. 内涵解读 <details> <summary>截图展示(点击展开)</summary> <center><img src="/api/attachments/c3e41fde-6c33-4cab-acfe-3807553acc64" width="300"></center> </details> ### 复现性体检 <details> <summary>截图展示(点击展开)</summary> <center><img src="/api/attachments/3e10f24f-3f05-4ef9-b4cc-223623fda7a2" width="300"></center> </details> ### 单仓 Idea <details> <summary>截图展示(点击展开)</summary> <center><img src="/api/attachments/86192490-0c26-42dc-a4b0-9834f072ca49" width="300"></center> </details> ### 多仓 Idea 对比 <details> <summary>截图展示(点击展开)</summary> <center><img src="/api/attachments/d161f8e7-8676-40fb-a073-2513f2c5ce28" width="300"></center> </details>
Kexing added 1 commit 2026-07-05 18:11:56 +08:00
0fef744a7c feat(skills): add gitlink-research-insight/repro/idea 科研辅助 skills
子赛题四作品:单仓科研代码仓库内涵解读的 3-skill 家族,主攻
「应用 GitLink 辅助科研」。全程数据由 gitlink-cli 采集,结论可溯源。

- gitlink-research-insight: 仓库级科研内涵解读(6 章节报告)
  + 方法—代码实现剖析模式(映射表 + 架构 Mermaid 图)
- gitlink-research-repro: 实验复现性体检(8 维度 /⚠️/ + 卡点修复建议)
- gitlink-research-idea: 研究 Idea 生成(单仓局限 + 跨多仓创新对比)

每个 skill 含 SKILL.md + 真实范例(基于 GitLink 真实科研仓验证)。
区别于现有 scholar-profile/research-tracker/research-fork-impact
(跨仓计数/评分),本系列在单仓做内容级研究智能。

Co-Authored-By: Claude <noreply@anthropic.com>
wbtiger merged commit 013e1b7070 into master 2026-07-14 22:31:19 +08:00
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#335
No description provided.